Skip to main content
The prediction endpoints are organized around four things: events, markets, traders, and the trades that connect them. Knowing which one you’re asking about tells you which query you want.
Prediction Market data is currently in beta. It is actively being worked on and improved, but may be unreliable. Polymarket and Kalshi data are live.At least for the time being, these endpoints require a Growth or Enterprise plan. Learn more.

​
The data model

An event is a real-world topic. It holds one or more markets, each a single yes/no or multi-way question. Every market resolves through its outcomes, and each outcome has a price that reads as an implied probability. Traders take positions in those outcomes, and every position change is a trade.
The practical consequence: event-level data aggregates across every market underneath it. If you want the headline number for “2026 World Cup” you query the event. If you want the odds on a specific team, you query the market.

​
Pick your endpoint

Each group in the sidebar maps to one layer of that model.

​
Events

​
Markets

Reach for eventScopedFilterPredictionMarkets instead of filterPredictionMarkets when you’re rendering a single event page. It returns structured classification metadata (country codes, period and stat grouping, parsed numeric and date rungs) so you don’t have to parse market labels client-side.

​
Traders

​
Trades and order books

​
Staying live

Five subscriptions mirror the queries above for real-time updates: onPredictionTradesCreated, onDetailedPredictionMarketStatsUpdated, onDetailedPredictionEventStatsUpdated, onPredictionMarketBarsUpdated, and onPredictionEventBarsUpdated.

​
Venue coverage

Coverage is not identical across venues. Kalshi runs as a CFTC-regulated exchange and does not expose individual trader identity, so trader data is unavailable for Kalshi entirely: the Traders queries above cannot be used with it, traderId filtering is unavailable, and Kalshi trades carry no maker and no buy/sell direction (every trade returns as TRADE). Event, market, and trade data work the same on both venues. predictionOutcomeOrderBooks covers Polymarket and Kalshi, and returns null for outcomes from anywhere else. See Supported Prediction Markets for the full platform breakdown.

​
Recipes

Discover Prediction Markets

Browse categories, trending events, and filter markets.

Prediction Event Dashboard

Build a complete event detail page with real-time data.

Prediction Charts

Outcome probability charts, multi-market comparisons, and OHLC data.

Prediction Traders

Trader leaderboards, profiles, and performance analytics.