Polymarket Skill for OpenClaw

Browse prediction markets, check odds, research events, compare markets, track your portfolio, and trade on Polymarket directly from your AI agent.

What it does

• Browse markets - trending, search, filter by category (politics, crypto, sports, tech, and more)
• Check odds - real-time Yes/No prices, volume, end dates
• Market research - AI-powered analysis combining odds with context about the event
• Compare markets - side-by-side odds for related markets with arbitrage detection
• Portfolio dashboard - view positions, P&L, balances, activity history, and open orders
• View order books - see bid/ask depth and spread for any market
• Price history - track how odds have moved over time (1m to max intervals)
• Trade - place limit, market, post-only, and batch orders with built-in safety confirmations
• Leaderboard & analytics - trader rankings, open interest, volume, top holders
• Live streaming - real-time comments and crypto prices via RTDS WebSocket
• Bridge funds - deposit and withdraw across EVM, Solana, and Bitcoin chains
• Manage positions - view open orders, cancel trades, check balances

Quick start

Install the skill

# Via OpenClaw CLI
openclaw install mvanhorn/clawdbot-skill-polymarket

# Or clone directly from GitHub
git clone https://github.com/mvanhorn/clawdbot-skill-polymarket.git ~/.openclaw/skills/polymarket

Browse markets (works immediately, no setup)

Just ask your agent:

• "What's trending on Polymarket?"
• "Search Polymarket for AI regulation"
• "What are the odds on the Fed cutting rates?"
• "Research the Bitcoin $150K market for me"
• "Compare the 2028 presidential candidates"
• "Who are the top Polymarket traders?"

Trade (requires Polymarket CLI + wallet)

1. Install the Polymarket CLI (Rust binary):

   brew install polymarket/tap/polymarket-cli

2. Set up a wallet:

   polymarket wallet create
   polymarket approve set

3. Use the interactive REPL for exploratory sessions:

   polymarket shell

4. Ask your agent:

   • "Buy 10 shares of YES on [market] at $0.45"
   • "Show me my portfolio dashboard"
   • "What are my open positions?"
   • "Cancel all my orders"
   • "Deposit funds from Ethereum"

All trades require explicit confirmation before executing. No surprises.

APIs covered

This skill covers all 4 Polymarket APIs plus the Gamma convenience layer:

API	Base URL	Purpose	Auth
Gamma	gamma-api.polymarket.com	Browse, search, comments, profiles, sports, GraphQL	None
CLOB	clob.polymarket.com	Trading, order books, price history, heartbeat, batch orders	API key
Data	data-api.polymarket.com	Positions, P&L, activity, trades, leaderboard, open interest	None (public)
RTDS	wss://ws-live-data.polymarket.com	Live comments, crypto prices (BTC/ETH/SOL/XRP)	None
Bridge	bridge.polymarket.com	Cross-chain deposits/withdrawals (EVM, Solana, Bitcoin)	Wallet

Safety

• Trades preview by default. Nothing executes without --confirm.
• This is real money (USDC on Polygon). The Polymarket CLI is experimental software.
• Your private key lives in ~/.config/polymarket/config.json. Keep it safe.
• Check the order book before placing large orders in low-volume markets.
• Heartbeat API: missed heartbeats (>10s) auto-cancel all resting orders.

Version

v3.0.0 - Data API (positions, P&L, leaderboard, open interest), RTDS WebSocket (live comments, crypto prices), Bridge API (cross-chain deposits/withdrawals), CLOB additions (heartbeat, post-only, batch orders, spread, fee-rate), Gamma additions (comments, profiles, series, sports, GraphQL), CLI corrected to Rust binary via Homebrew, new market types (5-minute crypto, sports).

License

MIT