Prediction Market data is currently in beta. It is actively being worked on and improved, but may be unreliable. Polymarket data is live, and Kalshi data will be added soon.At least for the time being, this endpoint requires a Growth or Enterprise plan. Learn more.
Query example
Get detailed stats for a specific marketExample response
Usage Guidelines
- Use this query to get comprehensive statistics for a single prediction market
- Market stats provide granular data for a specific outcome within an event
- Windowed statistics are available for multiple time periods: 5min, 1h, 4h, 12h, 1d, 1w
- Market ID formats vary by protocol:
- Polymarket:
<marketAddress>:Polymarket:<exchangeAddress>:<networkId>(e.g.,0x25aa90b3cd98305e849189b4e8b770fc77fe89bccb7cf9656468414e01145d38:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137) - Kalshi:
<marketSlug>:Kalshi(e.g.,KXMVECROSSCATEGORY-S2026A4A05B370DF-F1FBA451AA9:Kalshi)
- Polymarket:
- Find market IDs using
filterPredictionMarketsor from theidfield on markets - Returns
nullif the market doesn’t exist or has no available data - For aggregated stats across all markets in an event, use
detailedPredictionEventStats
Understanding Scores
- trending - Measures what’s “heating up” - prioritizes growth velocity over absolute size (a small market with 10x volume growth scores higher than a large market with flat volume)
- relevance - Measures what “matters” - based on absolute size and capital at stake, with no growth multipliers (large, established markets rank high even if quiet)
- competitive - Measures genuine uncertainty - higher when prices are near 50%, trading is balanced on both sides, and there’s active price discovery
Troubleshooting Tips
What's the difference between market stats and event stats?
What's the difference between market stats and event stats?
Market stats show data for a single outcome, while event stats aggregate across all markets in an event. Use
detailedPredictionEventStats for aggregated stats.How do I find market IDs?
How do I find market IDs?
Use
filterPredictionMarkets to search for markets, or get the id field from any market query.How do I interpret the score values?
How do I interpret the score values?
- Trending (0-1): 0.9+ = explosive growth (10x+ volume spikes, rapid trader influx)
- Relevance (0-1): 0.9+ = large capital deployment (high volume, deep liquidity)
- Competitive (0-1): 0.7+ = genuine uncertainty (prices near 50%, balanced trading). Low scores (< 0.3) = market reached consensus.