Polymarket Trading Skill

Trade prediction markets on Polymarket through the official polymarket CLI. Browse markets, place limit and market orders, manage positions, check rewards, and interact with conditional tokens — all from the terminal.

Installation

macOS / Linux (Homebrew)

CODEBLOCK0

Shell script

CODEBLOCK1

Build from source (Rust)

CODEBLOCK2

Wallet Setup

CODEBLOCK3

Configuration

Private key is resolved in order:

1. 1. CLI flag: INLINECODE1
2. Environment variable: INLINECODE2
3. Config file: INLINECODE3

Signature types: proxy (default), eoa, gnosis-safe. Override with --signature-type.

Overview

You are an expert in using the polymarket CLI for prediction market trading. Your goal is to help users trade on Polymarket efficiently while emphasizing safety, position management, and risk awareness.

How to Use This Skill

1. 1. Safety First: Start with small positions. Polymarket trades are real money on Polygon mainnet.
2. Verify Before Trading: Always show the exact command and confirm with the user before executing trades.
3. Check Prerequisites: Confirm wallet is set up, approvals are granted, and sufficient USDC balance exists.
4. Use JSON Output: For scripting and automation, use -o json for machine-readable output.
5. Understand Token IDs: Each market outcome (YES/NO) has a unique token ID. Get it from market details or order book commands.

When to Use This Skill

Use this skill when the user wants to:

• - Browse or search prediction markets
• Place bets (limit orders, market orders)
• Check market prices, spreads, and order books
• View or manage open orders
• Check portfolio positions and P/L
• Cancel orders
• Redeem winnings from resolved markets
• Check liquidity rewards and earnings
• Monitor market activity and leaderboards
• Hedge positions across markets

Common trigger phrases:

• - "What prediction markets are trending?"
• "Buy YES on Bitcoin above 100k"
• "Show me the order book"
• "What's the spread on this market?"
• "Cancel all my orders"
• "Check my positions"
• "How much have I earned in rewards?"
• "Place a limit order at 0.45"
• "Hedge my position"

When NOT to use this skill:

• - User wants to trade stocks/ETFs/options (use Alpaca trading skill)
• User wants financial advice (provide tools, not recommendations)
• User wants to use the Polymarket web UI

Core Commands

Market Discovery (No wallet needed)

List markets:
CODEBLOCK4

Get market details:
CODEBLOCK5

Search markets:
CODEBLOCK6

List events (groups of related markets):
CODEBLOCK7

Browse tags and categories:
CODEBLOCK8

Sports markets:
CODEBLOCK9

Order Book & Prices (No wallet needed)

Get prices:
CODEBLOCK10

Batch price queries:
CODEBLOCK11

Order book depth:
CODEBLOCK12

Price history:
CODEBLOCK13

Market metadata:
CODEBLOCK14

Trading (Requires wallet)

Place a limit order:
CODEBLOCK15

Place a market order:
CODEBLOCK16

Place multiple orders at once:
CODEBLOCK17

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

Cancel orders:
CODEBLOCK18

View orders and trades:
CODEBLOCK19

Check balances:
CODEBLOCK20

Rewards & Earnings

CODEBLOCK21

Portfolio & On-Chain Data (Public, no wallet needed)

CODEBLOCK22

Conditional Token Operations (On-chain, needs MATIC)

CODEBLOCK23

Wallet Management

CODEBLOCK24

Contract Approvals

CODEBLOCK25

API Key Management

CODEBLOCK26

Notifications & Account Status

CODEBLOCK27

Bridge (Deposits)

CODEBLOCK28

Interactive Shell

CODEBLOCK29

Utility Commands

CODEBLOCK30

Output Formats

All commands support --output table (default) and --output json (or -o json).

CODEBLOCK31

Common Workflows

Research a market before trading

CODEBLOCK32

Place a limit order and monitor

CODEBLOCK33

Two-sided market making (reward farming)

CODEBLOCK34

Hedge a position

CODEBLOCK35

Redeem winnings after market resolves

CODEBLOCK36

Scripting with JSON output

CODEBLOCK37

Best Practices

Safety & Risk

1. 1. Start small — Polymarket trades are real money on Polygon mainnet
2. Use --post-only — Maker orders have zero fees and earn rebates
3. Check fee rates — Use polymarket clob fee-rate TOKEN_ID before trading
4. Verify token IDs — Each YES/NO outcome has a different token ID
5. Keep MATIC for gas — On-chain operations (approve, split, merge, redeem) need MATIC
6. Monitor positions — Use polymarket data positions regularly

Order Management

1. 1. Prefer limit orders — Better price control, zero maker fees
2. Use --post-only — Ensures your order is a maker order (no taker fees)
3. Batch when possible — Use clob post-orders to place multiple orders at once
4. Cancel stale orders — Orders sitting far from mid are not earning rewards
5. Check order scoring — Use clob order-scoring to verify reward eligibility

Market Making

1. 1. Two-sided orders earn ~3x rewards — Place on both YES and NO
2. Stay close to midpoint — Rewards decay quadratically with distance from mid
3. Low-competition markets — Larger share of the reward pool
4. Monitor spread — Tighter spreads earn more rewards but increase fill risk
5. Rebalance regularly — Cancel and replace orders as midpoint moves

Command Reference

Task	Command
List markets	INLINECODE24
Search markets

polymarket markets search "query" | | Get market details | polymarket markets get SLUG_OR_ID | | List events | polymarket events list --limit 10 | | Check price | polymarket clob price TOKEN_ID --side buy | | Check midpoint | polymarket clob midpoint TOKEN_ID | | Check spread | polymarket clob spread TOKEN_ID | | View order book | polymarket clob book TOKEN_ID | | Price history | polymarket clob price-history TOKEN_ID --interval 1d | | Place limit order | polymarket clob create-order --token TOKEN_ID --side buy --price 0.50 --size 10 | | Place market order | 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" | | View orders | polymarket clob orders | | Cancel order | polymarket clob cancel ORDER_ID | | Cancel all | polymarket clob cancel-all | | Check balance | polymarket clob balance --asset-type collateral | | View positions | polymarket data positions 0xADDRESS | | Check rewards | polymarket clob current-rewards | | Check earnings | polymarket clob earnings --date 2026-03-01 | | Split USDC to tokens | polymarket ctf split --condition 0xCOND --amount 10 | | Merge tokens to USDC | polymarket ctf merge --condition 0xCOND --amount 10 | | Redeem winnings | polymarket ctf redeem --condition 0xCOND | | Wallet info | polymarket wallet show | | Approve contracts | polymarket approve set | | API health | polymarket clob ok | | Geo-restriction check | polymarket clob geoblock | | Account status | polymarket clob account-status | | List API keys | polymarket clob api-keys | | CTF condition ID | polymarket ctf condition-id --oracle 0xORA --question 0xQ --outcomes 2 | | Interactive shell | polymarket shell | | Update CLI | polymarket upgrade | | Guided setup | polymarket setup |

Important Notes

• - Token IDs are long numeric strings (e.g., 48331043336612883...). Get them from market details or order book.
• Condition IDs are hex strings (e.g., 0xABC...). Used for on-chain operations and market-level queries.
• USDC is the settlement currency. All amounts are in USDC.
• MATIC is needed for gas on Polygon for on-chain operations (approve, split, merge, redeem).
• Maker orders (limit orders with --post-only) have zero fees and earn daily rebates.
• Taker orders pay fees up to ~1.56% at 50/50 odds.
• Rewards are distributed daily at midnight UTC. Two-sided orders earn ~3x single-sided.

Troubleshooting

Wallet not configured

CODEBLOCK38

Approvals not set

CODEBLOCK39

Insufficient balance

CODEBLOCK40

Order rejected

• - Check balance: INLINECODE59
• Verify token ID is correct
• Check fee rate: INLINECODE60
• Ensure approvals are set: INLINECODE61

Command not found

CODEBLOCK41

Additional Resources

• - Polymarket CLI: https://github.com/Polymarket/polymarket-cli
• Polymarket Docs: https://docs.polymarket.com/
• CLOB API Docs: https://docs.polymarket.com/developers/
• Liquidity Rewards: https://docs.polymarket.com/developers/market-makers/liquidity-rewards
• Maker Rebates: https://docs.polymarket.com/developers/market-makers/maker-rebates-program