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.
Example Queries
Get trending markets ranked by outcome price changeExample Response
Example response (truncated)
Usage Guidelines
This query returns bar data for multiple top markets within a prediction event, combining event context with individual market time-series data. It’s useful for comparing market performance, identifying trending markets, and analyzing multi-market events. Key characteristics:- Event ID format: The
eventIdformat varies by platform:- Polymarket:
<eventSlug>:Polymarket:<exchangeAddress>:<networkId>(e.g.,67284:Polymarket:0xc5d563a36ae78145c45a50134d48a1215220f80a:137) - Kalshi:
<eventSlug>:Kalshi(e.g.,KXMVESPORTSMULTIGAMEEXTENDED-S2026350C4EF9BCE:Kalshi)
- Polymarket:
- Batch market data: Get bars for up to 10 markets in a single query
- Flexible ranking: Rank markets by volume, liquidity, trending score, or outcome-specific metrics
- Complete market context: Each response includes the full market object plus bar data
- Efficient querying: Better performance than making multiple individual
predictionMarketBarscalls - Time-series format: Same OHLC bar structure as
predictionMarketBars
- Display multiple markets from an event on a dashboard
- Compare trading activity across related markets
- Identify the most active or trending markets within an event
- Build event overview pages with market-level granularity
Troubleshooting Tips
Should I use rankBy or rankByOutcome + rankByOutcomeAttribute?
Should I use rankBy or rankByOutcome + rankByOutcomeAttribute?
- Use
rankByfor market-level metrics (e.g.,volumeUsd24h,liquidityUsd,uniqueTraders24h) - Use
rankByOutcome+rankByOutcomeAttributefor outcome-specific metrics (e.g., price changes, outcome-specific volume)
What happens if I specify marketIds?
What happens if I specify marketIds?
When you provide
marketIds, the ranking parameters are ignored and you’ll get bars for exactly those markets. This is useful when you want specific markets but still benefit from the batch query performance. The limit parameter is also ignored in this case.Why am I getting fewer than 'limit' markets?
Why am I getting fewer than 'limit' markets?
Possible reasons:
- The event has fewer markets than your limit
- Some markets had no activity in the specified time range (when
removeEmptyBars: true) - Some markets don’t have the ranking attribute you specified (e.g., older markets may not have trending scores)
predictionEvent query.How do trending scores work for ranking?
How do trending scores work for ranking?
Trending scores (e.g.,
trendingScore1h, trendingScore24h) are composite metrics that consider:- Recent volume changes
- Price movement velocity
- Unique trader growth
- Social engagement (where available)
What's the difference between rankDirection ASC and DESC?
What's the difference between rankDirection ASC and DESC?
DESC(descending): Highest values first - use for “top” markets (e.g., highest volume, most liquid)ASC(ascending): Lowest values first - use for “bottom” markets or when looking for lowest spreads, earliest closing times, etc.
DESC to get the top/best markets.Can I rank by outcome price but get both outcomes' data?
Can I rank by outcome price but get both outcomes' data?
Yes! The ranking only determines which markets are returned. You can rank by
outcome0.priceChange1h but still query full data for both outcome0 and outcome1 in your bars selection. The ranking criterion doesn’t limit what data you receive.How should I handle the max limit of 10 markets?
How should I handle the max limit of 10 markets?
The 10-market limit balances comprehensive data with performance. If you need more markets:
- Make multiple queries with different ranking criteria
- Use pagination by explicitly specifying different
marketIdsin subsequent queries - Consider whether you truly need more than 10 markets for your UI/analysis