Get Live State
Sports Discovery API
Get Live State
Get one live score and game-state snapshot by sports game_id
GET
Get Live State
Overview
Returns one live game-state snapshot for a broad sportsgame_id.
Use this endpoint after discovering games from GET /v2/sports/games or market listings from GET /v2/sports/markets. Live state keys off game_id, not event_id, because many tradable markets can belong to the same real-world game.
For source reliability semantics, see Sports Live State. For the websocket contract, see Sports Live WebSocket.
Path Parameters
Query Parameters
Event List
The response includessignificant_events[], a normalized list of key incidents when available. This can include score changes, cards, substitutions, period events, game start/end, or source-supported other events.
Incident availability depends on source and sport support. Kalshi soccer milestones commonly include goals, cards, substitutions, period events, and game-end events. Kalshi basketball can include made shots/free throws and period boundaries. Baseball play-by-play may be available for some games, but typed key incidents are less consistent. Polymarket primarily provides score, period, status, clock, and game-level state. If no key incidents are available for the game, significant_events is returned as [].
Example
GET /v2/sports/live/mlb-ari-pit-2026-05-07
Reliability
Authorizations
Data key provided by Predexon. The trading key used by the Order Router on trade.predexon.com is a separate credential.
Path Parameters
Canonical sports game ID.
Query Parameters
Include source-level live state snapshots.
Response
Successful response
