Use Tatum’s Prediction Market Markets APIs to access market metadata, live prices, orderbooks, price history, trades, and position data for prediction market applications.
The Prediction Market Markets APIs provide developers with direct access to market-level metadata, pricing, liquidity, trades, and positioning data.
These endpoints are ideal for trading interfaces, market detail pages, charting tools, and market intelligence dashboards.
Key Benefits of the Markets APIs
- Market detail access – Retrieve individual market metadata and platform-native identifiers.
- Live trading data – Fetch current prices, orderbooks, and recent trades.
- Historical context – Plot price history and trading activity over time.
- Position intelligence – Inspect market holders for deeper analytics.
Markets API Endpoints
The Markets APIs offer seven core endpoints for market discovery, pricing, and analytics.
List Prediction Markets
GET /v4/data/prediction/markets
List prediction markets across supported platforms.
Useful for market feeds, filtered market browsers, and linking markets back to parent events.
Get a Prediction Market by ID
GET /v4/data/prediction/markets/{id}
Retrieve a single prediction market by its platform-native identifier.
Useful for market detail pages, direct market lookups, and preloading market metadata before fetching live price data.
Get Current Market Price
GET /v4/data/prediction/markets/{id}/price
Get the current market price snapshot for a single market.
Returns outcome-level quotes and trading metrics for ticker views and trade previews.
Get Current Market Orderbook
GET /v4/data/prediction/markets/{id}/orderbook
Retrieve the current orderbook snapshot for a specific market outcome.
Useful for advanced trading UIs, depth charts, and liquidity analysis.
Get Market Price History
GET /v4/data/prediction/markets/{id}/price/history
Fetch historical market price data over time.
Useful for charting, performance analysis, and trend overlays on market pages.
Get Recent Market Trades
GET /v4/data/prediction/markets/{id}/trades
Retrieve recent trades for a given market.
Useful for time-and-sales panels, activity feeds, and execution analysis.
Get Market Positions
GET /v4/data/prediction/markets/{id}/positions
Get holder and position data for a specific market.
Useful for showing who holds each side of a market and for building market-holder analytics.
Supported Platforms
- Polymarket —
polymarket - Kalshi —
kalshi
Use Cases for Developers
- Build live market pages with real-time prices and orderbooks.
- Create historical price charts and trade activity streams.
- Add holder analytics to market views.
- Power trade previews and liquidity checks before order submission.
Markets API FAQs
Which endpoints should I use for a trading screen?
Most trading screens combine Get a Prediction Market by ID, Get Current Market Price, Get Current Market Orderbook, and Get Recent Market Trades for a complete live trading view.
What is the difference between price and orderbook endpoints?
The price endpoint provides a compact market snapshot, while the orderbook endpoint gives deeper bid and ask depth for a specific outcome side.
When should I use price history instead of recent trades?
Use price history for charts and trend analysis. Use recent trades when you need raw execution activity, trade flow, or a time-and-sales style feed.
What does the market positions endpoint show?
The market positions endpoint helps you inspect holder exposure within a specific market, making it useful for ownership analysis and market participation insights.