Polymarket Council

Query, analyze, and trade on Polymarket — the world's largest prediction market.

Read-only commands work immediately — no API keys, no install, no setup.

Quick Start

# What's hot right now?
python3 {baseDir}/scripts/polymarket.py trending

# Search any topic
python3 {baseDir}/scripts/polymarket.py search "bitcoin"

# Get detailed odds for a specific market
python3 {baseDir}/scripts/polymarket.py market CONDITION_ID

# Price history
python3 {baseDir}/scripts/polymarket.py history TOKEN_ID --interval 1d --fidelity 60

Commands

Market Discovery (no setup needed)

# Trending markets by volume
python3 {baseDir}/scripts/polymarket.py trending [--limit 20]

# Search markets by keyword
python3 {baseDir}/scripts/polymarket.py search "QUERY" [--limit 10]

# Browse by category/tag
python3 {baseDir}/scripts/polymarket.py category TAG [--limit 20]
# Tags: politics, crypto, sports, pop-culture, business, science, world, ai, elections

# Get full event details (all markets in an event)
python3 {baseDir}/scripts/polymarket.py event SLUG_OR_ID

# Get a single market's details + current prices
python3 {baseDir}/scripts/polymarket.py market CONDITION_ID

# List active events
python3 {baseDir}/scripts/polymarket.py events [--limit 20] [--tag TAG]

Prices & Order Books (no setup needed)

# Current price / odds for a token
python3 {baseDir}/scripts/polymarket.py price TOKEN_ID

# Batch prices for multiple tokens
python3 {baseDir}/scripts/polymarket.py prices TOKEN_ID1 TOKEN_ID2 ...

# Spread (best ask - best bid)
python3 {baseDir}/scripts/polymarket.py spread TOKEN_ID

# Full order book (bids + asks)
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID

# Price history over time
python3 {baseDir}/scripts/polymarket.py history TOKEN_ID [--interval 1d] [--fidelity 60]
# intervals: 1m, 5m, 1h, 1d, 1w  |  fidelity: minutes between data points

# Last trade price
python3 {baseDir}/scripts/polymarket.py last-trade TOKEN_ID

Analytics (no setup needed)

# Open interest for a market
python3 {baseDir}/scripts/polymarket.py open-interest CONDITION_ID

# Top holders of a token
python3 {baseDir}/scripts/polymarket.py holders TOKEN_ID [--limit 10]

# Live volume for an event
python3 {baseDir}/scripts/polymarket.py volume EVENT_ID

# Leaderboard
python3 {baseDir}/scripts/polymarket.py leaderboard [--limit 20]

# Public profile of a trader
python3 {baseDir}/scripts/polymarket.py profile ADDRESS

# Trader's activity / trade history
python3 {baseDir}/scripts/polymarket.py activity ADDRESS [--limit 20]

Trading (requires wallet setup)

First-time setup:

python3 {baseDir}/scripts/polymarket.py wallet-setup

This creates ~/.config/polymarket/wallet.json with your private key (Polygon).

# Check wallet balance
python3 {baseDir}/scripts/polymarket.py balance

# Buy limit order — preview only (no --confirm)
python3 {baseDir}/scripts/polymarket.py trade buy --token TOKEN_ID --price 0.50 --size 10

# Buy limit order — EXECUTE (with --confirm)
python3 {baseDir}/scripts/polymarket.py trade buy --token TOKEN_ID --price 0.50 --size 10 --confirm

# Sell limit order
python3 {baseDir}/scripts/polymarket.py trade sell --token TOKEN_ID --price 0.70 --size 10 --confirm

# Market order — buy $5 worth at best available price
python3 {baseDir}/scripts/polymarket.py trade buy --token TOKEN_ID --amount 5 --market-order --confirm

# View open orders
python3 {baseDir}/scripts/polymarket.py orders [--address ADDRESS]

# Cancel an order
python3 {baseDir}/scripts/polymarket.py cancel ORDER_ID --confirm

# Cancel all orders
python3 {baseDir}/scripts/polymarket.py cancel-all --confirm

# View positions
python3 {baseDir}/scripts/polymarket.py positions [--address ADDRESS]

Example Chat Usage

• "What are the odds Trump wins the 2028 election?"
• "Show me trending markets on Polymarket"
• "Search Polymarket for Bitcoin price predictions"
• "What are the current crypto markets on Polymarket?"
• "Show the order book for [token]"
• "What's the price history for this market over the last week?"
• "Who are the top traders on Polymarket?"
• "Show me open interest for [market]"
• "Buy 10 shares of YES at $0.45 on [market]"
• "What are my positions?"

API Reference

Read-only commands use public APIs (no auth required):

Trading commands use authenticated CLOB API endpoints.

Safety Notes

• Real money. Polymarket trades use real USDC on Polygon. Double-check before confirming.
• All trades require --confirm. Without it, you only see a preview.
• Private key security. Your key is stored in ~/.config/polymarket/wallet.json. Protect it.
• Gas fees. On-chain operations require MATIC/POL for gas on Polygon.
• Not financial advice. This tool provides market data. Make your own decisions.