Sports & Odds

Get Live Odds

In-play odds only. 3 credits.

Returns events whose commence_time is within the last max_age_hours hours AND is at or before now (i.e. started and presumably still in play). Pulls from the same odds_snapshots table that powers /v1/sports/{key}/odds. Game lines (h2h/spreads/totals) come from there; "live"-tagged player props that some books emit are merged in too. The distinction from /odds is the time filter, not the data source.

sleep_iter_6 #507 (pass-10 finding 6 from the public audit): the prior filter was commence_time <= now with no lower bound, which returned games that started 13+ hours ago and had been over for many hours. The default 6-hour window now matches typical game lengths and the max_age_hours knob lets callers tune it for their sport.

Example: GET /v1/sports/baseball_mlb/live?bookmakers=pinnacle&markets=h2h&max_age_hours=4

get/v1/sports/{sport_key}/live

Request

  • Base URL: https://parlay-api.com
  • URL: https://parlay-api.com/v1/sports/{sport_key}/live
  • Auth: one of:
    • API key in header X-API-Key
    • API key in query parameter apiKey
    • HTTP bearer

Path parameters

sport_keystring required

Query parameters

bookmakersstring nullable

Repeating this parameter is the same as the comma form: ?markets=h2h&markets=spreads and ?markets=h2h,spreads are one request, billed identically, and return the union. A value repeated across occurrences is counted once.

marketsstring

h2h, spreads, totals (comma-separated)

h2h, spreads, totals (comma-separated) Repeating this parameter is the same as the comma form: ?markets=h2h&markets=spreads and ?markets=h2h,spreads are one request, billed identically, and return the union. A value repeated across occurrences is counted once.

regionsstring

us, eu, uk, au (comma-separated)

us, eu, uk, au (comma-separated) Repeating this parameter is the same as the comma form: ?markets=h2h&markets=spreads and ?markets=h2h,spreads are one request, billed identically, and return the union. A value repeated across occurrences is counted once.

oddsFormatstring
includestring

Comma-separated. 'verification' adds verified_at / line_changed_at / is_current per bookmaker.

max_age_hoursnumber

Only include events whose commence_time is within the last N hours. Default 6 covers a typical MLB or NBA game plus extra innings / overtime. Raise to 12 for events with longer windows (long tennis matches, soccer with stoppage time), or lower to 3 for stricter in-play filtering.

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.