Skip to main content
GET
Get Live State

Overview

Returns one live game-state snapshot for a broad sports game_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 includes significant_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

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.

Path Parameters

game_id
string
required

Canonical sports game ID.

Query Parameters

include_sources
boolean
default:true

Include source-level live state snapshots.

Response

Successful response