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.