Polymarket Command Center

Real-time prediction market data for OpenClaw — no API key required.

Commands

odds [slug]

Get detailed odds for a specific market by slug or search term.

odds [slug]
odds [search term]

Examples:

odds will-trump-win-2024 — exact slug match
odds bitcoin — search for markets containing "bitcoin"
odds fed rate cut march — multi-term search

Output:

Full market question
Outcome probabilities with visual bar chart (█ filled, ░ empty)
24h trading volume
Market liquidity
Close date (absolute + days remaining)
Market description (truncated to 200 chars)
Live CLOB midpoint (if available)
Direct link to Polymarket web interface

Search behavior: If exact slug fails, performs client-side text search across market questions, slugs, and descriptions.

search [query]

Search across 100 active markets by text. Client-side filtering for instant results.

search [query]
search [term1] [term2] [term3]

Examples:

search bitcoin — single term
search bitcoin 100k — all terms must match
search fed interest rate — multi-word search
search election 2024 — phrase search

Output:

Up to 8 matching markets
Question, yes probability, volume, slug for each

Search logic: All query terms must appear in the market question, slug, or description (case-insensitive). Searches are cached for 2 minutes.

watchlist

Check odds on your configured watchlist markets.

watchlist

Output:

Current odds for each market on your watchlist
Volume, close date for each

Configuration: Add market slugs to ~/.openclaw/state/polymarket_watchlist.json:

{
  "slugs": [
    "will-trump-win-2024",
    "bitcoin-above-100k",
    "fed-rate-cut-march-2026"
  ]
}

Or via ~/.openclaw/config.yaml:

polymarket:
  watchlist:
    - will-trump-win-2024
    - bitcoin-above-100k
    - fed-rate-cut-march-2026

Data Source & Architecture

No API Key Required

Polymarket Command Center uses only public APIs:

Gamma API (https://gamma-api.polymarket.com) — Market metadata, outcomes, pricing
CLOB API (https://clob.polymarket.com) — Live bid/ask midpoints

Zero authentication. Zero credentials. Pure HTTP.

Thread-Safe Caching

In-memory cache with automatic eviction:

TTL: 120 seconds default (180s for trending, 120s for search)
Max entries: 100 (LRU eviction when full)
Thread-safe: Reentrant locks for concurrent requests
Smart invalidation: Expired entries auto-deleted on next access

CLOB Midpoints

The "Live midpoint" shown in odds details comes from CLOB (Central Limit Order Book) — Polymarket's on-chain order book. This represents the true real-time bid/ask spread. Falls back gracefully if CLOB data is unavailable.

Output Formats

Trending Markets

🔮 Polymarket Trending (crypto)

1. Will Bitcoin reach $100K by end of 2026?
   Yes: 72% | Vol: $2.5M | Closes: 45d
   📎 bitcoin-above-100k

2. Ethereum price above $5K on March 31 2026?
   Yes: 48% | Vol: $1.2M | Closes: 22d
   📎 ethereum-5k-march

💡 Say 'odds [slug]' for detailed odds on any market

Detailed Odds

🔮 Will Trump win the 2024 US Presidential Election?

Yes: 68% ████████████░░░░░░░░
No:  32% ██████░░░░░░░░░░░░░░

📊 Volume: $18.5M | Liquidity: $4.2M
📅 Closes: 2026-11-05 (240 days)

📝 Prediction market for the outcome of the 2024 U.S. Presidential election...

💹 Live midpoint: 67.8%

🔗 polymarket.com/event/will-trump-win-2024

Search Results

🔍 Polymarket search: 'bitcoin 100k'

1. Will Bitcoin reach $100K before end of 2026?
   Yes: 72% | Vol: $2.5M
   📎 bitcoin-above-100k

2. Bitcoin price prediction: $100K to $110K range by March 2026?
   Yes: 58% | Vol: $850K
   📎 bitcoin-100k-110k-range

💡 Say 'odds [slug]' for details on any market

Watchlist

👀 Polymarket Watchlist

🔮 Will Trump win the 2024 US Presidential Election?
   Yes: 68% | Vol: $18.5M

🔮 Will Bitcoin reach $100K by end of 2026?
   Yes: 72% | Vol: $2.5M

🔮 Will Fed cut rates in March 2026?
   Yes: 64% | Vol: $3.1M

Response Codes

| Status | Meaning | Action | |--------|---------|--------| | ❌ | Network error | Retry in a minute; check internet connection | | 🔮 | Success | Market data loaded and formatted | | 👀 | Watchlist | Your configured markets | | 🔍 | Search | Client-side filtered results | | 💡 | Tip | Suggested next action |

Cache Behavior

First call: Hits Polymarket API, caches result
Repeated calls (within TTL): Returns cached data instantly
Stale data (past TTL): Cache evicted, fresh API call triggered
Bounded memory: Max 100 entries; oldest evicted when full
Thread-safe: Safe for concurrent requests (e.g., morning brief + user query)

Example timeline:

14:30:00 - User: "trending"
           → API call → cache set (expires 14:32:00)
           → response with 10 markets

14:30:45 - User: "trending"
           → cache hit (28s old)
           → instant response (same data)

14:32:15 - User: "trending"
           → cache miss (expired 15s ago)
           → API call → cache set (expires 14:34:15)
           → response with fresh data

Configuration (Optional)

All commands work without any configuration. Optional settings in ~/.openclaw/config.yaml:

polymarket:
  enabled: true
  watchlist:
    - will-trump-win-2024
    - bitcoin-above-100k
    - fed-rate-cut-march-2026
  categories:
    - politics
    - crypto
    - sports

No config needed — defaults work for all commands.

Supported Market Categories

Gamma API returns markets tagged with these common categories:

politics — Elections, political outcomes
crypto — Bitcoin, Ethereum, altcoins, blockchain
sports — NFL, NBA, Premier League, Olympic Games
entertainment — Movies, award shows, celebrity news
economics — Fed rates, inflation, jobs data
weather — Extreme weather events
science — Space, breakthrough discoveries
business — Tech IPOs, M&A, earnings

Custom tags may appear; Gamma API returns whatever is configured.

Implementation Details

HTTP Client

User-Agent: OpenClaw-Polymarket/1.0
Timeout: 10 seconds per request
Accept: application/json
No cookies; stateless requests

Error Handling

Network timeouts → graceful "couldn't reach Polymarket"
Malformed JSON → ignored, fallback to empty results
Unicode decode errors → handled silently

Outcome Parsing

Polymarket API returns outcomes and prices as JSON-stringified arrays. Command Center auto-detects format (string vs. array) and parses both.

Binary markets: ["Yes", "No"] outcomes with [yes_price, no_price]

Categorical markets: ["Trump", "Harris", "RFK Jr"] with corresponding prices.

OpenClaw Ecosystem Integration

Read-only Polymarket data layer for the Prediction Market Trading Stack.

| Connected Skill | How It Connects | |----------------|-----------------| | Market Morning Brief | Polymarket trending data appears in your daily brief | | Prediction Market Arbiter | Polymarket prices compared against Kalshi for divergences | | Xpulse | Social signals correlated with Polymarket movements |

Install the complete stack:

clawhub install kalshalyst kalshi-command-center polymarket-command-center prediction-market-arbiter xpulse portfolio-drift-monitor market-morning-brief personality-engine

Example Workflows

Monitor Crypto Market Sentiment

1. trending crypto        # See top crypto markets by volume
2. odds bitcoin-above-100k  # Detailed probability for BTC
3. search ethereum        # Find Ethereum-related markets
4. watchlist             # Check your configured positions

Track Election Predictions

1. trending politics     # Top political markets
2. odds will-trump-win-2024  # Detailed odds + CLOB midpoint
3. search harris         # Look for related markets
4. Add to watchlist      # Monitor probability shifts

Find Hidden Opportunities

1. trending               # All markets
2. search [niche term]   # Find underexplored markets
3. odds [slug]           # Check volumes and liquidity
4. Compare CLOB midpoint vs. displayed probability

Limitations & Notes

Read-only: No trading, no account creation
Public data only: No private market insights
Gamma API limits: ~100 markets per request (used in search)
CLOB midpoints: May be unavailable for some markets (graceful fallback)
Pricing: Outcomes always shown as decimal probabilities (0.68 = 68%)
Closed markets: Excluded from trending/search; archived on Polymarket

Troubleshooting

| Issue | Solution | |-------|----------| | "Couldn't reach Polymarket" | Retry in 1 minute; check internet | | "No markets found for..." | Try broader search term; check spelling | | "No watchlist configured" | Add watchlist to config.yaml or create ~/.openclaw/state/polymarket_watchlist.json | | Cached data looks stale | Cache TTL is 2 minutes; wait or restart service | | CLOB midpoint missing | Market may not have CLOB tokens yet (new markets) |

Version History

v1.0.0 (2026-03-09)

Initial release
Commands: trending, odds, search, watchlist
Thread-safe caching with 120s TTL
CLOB midpoint integration
Zero API key required
100% read-only (no trading)

Feedback & Issues

Found a bug? Have a feature request? Want to share results?

GitHub Issues: github.com/kingmadellc/openclaw-prediction-stack/issues
X/Twitter: @KingMadeLLC

Part of the OpenClaw Prediction Stack — the first prediction market skill suite on ClawHub.