Skip to main content
GET
/
v2
/
sports
/
live
/
{game_id}
Get Live State
curl --request GET \
  --url https://api.predexon.com/v2/sports/live/{game_id} \
  --header 'x-api-key: <api-key>'
{
  "game_id": "mlb-ari-pit-2026-05-07",
  "league": "mlb",
  "sport": "baseball",
  "game_date": "2026-05-07",
  "title": "Arizona Diamondbacks vs Pittsburgh Pirates",
  "home_team": null,
  "away_team": null,
  "participants": [
    {
      "code": "ari",
      "name": "Arizona Diamondbacks"
    },
    {
      "code": "pit",
      "name": "Pittsburgh Pirates"
    }
  ],
  "status": "open",
  "status_text": null,
  "live": false,
  "ended": false,
  "period": null,
  "clock": null,
  "score": {
    "home": null,
    "away": null,
    "display": null
  },
  "winner": null,
  "ended_at": null,
  "last_play": null,
  "significant_events": [],
  "reliability": {
    "state": "no_data",
    "source_count": 0,
    "sources": [],
    "conflict": false,
    "stale": true
  },
  "sources": [],
  "updated_at": null
}

​
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

ParamTypeDescription
game_idstringBroad real-world sports game ID.

​
Query Parameters

ParamTypeDefaultDescription
include_sourcesbooleantrueInclude source-level snapshots under sources[].

​
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 
{
  "game_id": "mlb-ari-pit-2026-05-07",
  "league": "mlb",
  "sport": "baseball",
  "game_date": "2026-05-07",
  "title": "Arizona Diamondbacks vs Pittsburgh Pirates",
  "home_team": null,
  "away_team": null,
  "participants": [
    { "code": "ari", "name": "Arizona Diamondbacks" },
    { "code": "pit", "name": "Pittsburgh Pirates" }
  ],
  "status": "open",
  "status_text": null,
  "live": false,
  "ended": false,
  "period": null,
  "clock": null,
  "score": {
    "home": null,
    "away": null,
    "display": null
  },
  "winner": null,
  "last_play": null,
  "significant_events": [],
  "reliability": {
    "state": "no_data",
    "source_count": 0,
    "sources": [],
    "conflict": false,
    "stale": true
  },
  "sources": [],
  "updated_at": null
}

​
Reliability

FieldDescription
stateAggregate source state, such as no_data, single_source, confirmed, conflict, or stale.
sourcesDirect source names used for the aggregate, such as polymarket or kalshi.
source_countNumber of source snapshots used for the aggregate state.
conflictWhether sources disagree on material fields like score, status, or winner.
staleWhether the latest source data is stale or absent.

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