kingmadellc Polymarket Command Center
Real-time prediction market data for OpenClaw — no API key required.
Commands
trending
Get top 10 active markets by trading volume across Polymarket.
trending
trending [category]
Examples:
trending— all marketstrending politics— political prediction marketstrending crypto— cryptocurrency marketstrending sports— sports betting markets
Output:
- Market question (truncated to 65 chars)
- Primary outcome probability (Yes/No split)
- 24h volume
- Days until market closes
- Market slug (for detailed lookups)
Categories: Gamma API supports any tag in Polymarket's taxonomy. Common: politics, crypto, sports, elections, entertainment, economics.
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 matchodds 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 termsearch bitcoin 100k— all terms must matchsearch fed interest rate— multi-word searchsearch 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 outcomescrypto— Bitcoin, Ethereum, altcoins, blockchainsports— NFL, NBA, Premier League, Olympic Gamesentertainment— Movies, award shows, celebrity newseconomics— Fed rates, inflation, jobs dataweather— Extreme weather eventsscience— Space, breakthrough discoveriesbusiness— 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 prediction-stack-setup
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.