Skip to main content
GET
List Live States

Overview

Returns live game-state snapshots keyed by canonical sports game_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 the significant_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

x-api-key
string
header
required

Data key provided by Predexon. The trading key used by the Order Router on trade.predexon.com is a separate credential.

Query Parameters

sport
enum<string>

Filter by sport.

Available options:
basketball,
soccer,
hockey,
baseball
league
string

Filter by league code.

game_date
string

Exact game date (YYYY-MM-DD).

live_only
boolean
default:false

Only return games currently marked live.

include_sources
boolean
default:false

Include source-level live state snapshots.

limit
integer
default:50

Max live states to return.

Required range: 1 <= x <= 200
pagination_key
string

Cursor from the previous response. Omit on the first request.

Response

200 - application/json

Successful response