clawdbot-skill-polymarket

skill
SUMMARY

Polymarket prediction markets - check odds, track portfolios, research markets, set alerts, compare markets, and trade. Read-only works instantly. OpenClaw skill.

README.md

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

Reviews (0)

No results found