List Live States
Sports Discovery API
List Live States
List live score and game-state snapshots by sports game_id
GET
List Live States
Overview
Returns live game-state snapshots keyed by canonical sportsgame_id.
This endpoint is intentionally separate from market discovery. Use /v2/sports/games and /v2/sports/markets to discover tradeable outcomes, then use /v2/sports/live to read score, period, clock, winner, and source reliability for the broad real-world game.
If live state is not yet available for a game, games can still appear with
reliability.state = "no_data" and null score fields.For the broader model and source reliability semantics, see Sports Live State. For the websocket contract, see Sports Live WebSocket.
Query Parameters
Response Fields
Event List Coverage
The event list uses thesignificant_events[] field on each live-state object. It is intended for key incidents, not every vendor-specific stat or full box score.
Supported normalized event types include:
Game coverage follows the same matched sports universe as
GET /v2/sports/games and the sports venue coverage matrix. Incident availability is source- and sport-dependent. 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. If no key incidents are available for a game, significant_events is returned as [].
Reliability States
Example
GET /v2/sports/live?league=mlb&limit=1
Authorizations
Data key provided by Predexon. The trading key used by the Order Router on trade.predexon.com is a separate credential.
Query Parameters
Filter by sport.
Available options:
basketball, soccer, hockey, baseball Filter by league code.
Exact game date (YYYY-MM-DD).
Only return games currently marked live.
Include source-level live state snapshots.
Max live states to return.
Required range:
1 <= x <= 200Cursor from the previous response. Omit on the first request.
Response
200 - application/json
Successful response
