Polymarket CLI Skill

Trade prediction markets on Polymarket from the terminal. All commands use the polymarket binary.

Prerequisites

Binary must be installed. If missing:

curl -sSL https://raw.githubusercontent.com/Polymarket/polymarket-cli/main/install.sh | sh
# Or build from source:
# cargo install --path /tmp/polymarket-cli

Authentication

Most read commands work without a wallet. Trading requires setup:

polymarket setup                    # Interactive wizard
# Or manually:
polymarket wallet create            # New wallet
polymarket wallet import 0xKEY...   # Import existing
polymarket approve set              # Approve contracts (needs MATIC)

Config stored at ~/.config/polymarket/config.json.

Output

Always use -o json when calling from scripts/agents for machine-readable output:

polymarket -o json markets list --limit 5
polymarket -o json clob midpoint TOKEN_ID

Common Workflows

Browse & Research

# Search markets
polymarket markets search "bitcoin" --limit 10
polymarket -o json markets search "trump" --limit 5

# Get specific market
polymarket markets get MARKET_ID_OR_SLUG

# List by category
polymarket events list --tag politics --active true --limit 20
polymarket events list --tag crypto --limit 10

# Available tags
polymarket tags list

Check Prices & Orderbook

# Price info (needs token ID from market data)
polymarket clob price TOKEN_ID --side buy
polymarket clob midpoint TOKEN_ID
polymarket clob spread TOKEN_ID

# Full orderbook
polymarket clob book TOKEN_ID

# Price history
polymarket clob price-history TOKEN_ID --interval 1d --fidelity 30
# Intervals: 1m, 1h, 6h, 1d, 1w, max

# Batch queries (comma-separated)
polymarket clob midpoints "TOKEN1,TOKEN2"

Trading (Requires Wallet)

# Limit order: buy 10 shares at $0.45
polymarket clob create-order --token TOKEN_ID --side buy --price 0.45 --size 10

# Market order: buy $5 worth
polymarket clob market-order --token TOKEN_ID --side buy --amount 5

# Batch orders
polymarket clob post-orders --tokens "T1,T2" --side buy --prices "0.4,0.6" --sizes "10,10"

# Cancel
polymarket clob cancel ORDER_ID
polymarket clob cancel-all

# Check orders
polymarket clob orders
polymarket clob trades

Order types: GTC (default), FOK, GTD, FAK. Add --post-only for maker-only.

Portfolio & Positions

# Your positions
polymarket data positions 0xWALLET
polymarket data value 0xWALLET
polymarket clob balance --asset-type collateral

# Trade history
polymarket data trades 0xWALLET --limit 50

# Leaderboard
polymarket data leaderboard --period month --order-by pnl --limit 10

On-Chain Operations

# Approvals
polymarket approve check
polymarket approve set

# Split USDC into YES/NO tokens
polymarket ctf split --condition 0xCOND... --amount 10

# Merge back to USDC
polymarket ctf merge --condition 0xCOND... --amount 10

# Redeem after resolution
polymarket ctf redeem --condition 0xCOND...

Market Rewards

polymarket clob rewards --date 2026-02-28
polymarket clob current-rewards
polymarket clob market-reward 0xCONDITION...
polymarket clob order-scoring ORDER_ID

Bridge (Deposits)

polymarket bridge deposit 0xWALLET
polymarket bridge supported-assets

Data Flow: Finding Token IDs

Markets → Events → Token IDs → CLOB operations:

# 1. Search for a market
polymarket -o json markets search "bitcoin 100k" | jq '.[0]'

# 2. Get token IDs from market data
polymarket -o json markets get SLUG | jq '.clobTokenIds'
# Returns: ["TOKEN_YES", "TOKEN_NO"]

# 3. Use token IDs for CLOB
polymarket clob midpoint TOKEN_YES
polymarket clob book TOKEN_YES

Tips

• Token IDs are long numeric strings (e.g., 48331043336612883...)
• Condition IDs are hex addresses (0x...)
• Prices are 0-1 (displayed as cents: 0.52 = 52¢)
• Amounts in USDC (e.g., --amount 10 = $10)
• On-chain ops need MATIC for gas (Polygon)
• Use polymarket shell for interactive REPL
• Pipe JSON output to jq for filtering

References

• Polymarket CLI GitHub
• Polymarket Docs
• Chain: Polygon (chainId 137)
• Collateral: USDC