Get Event Odds History

Historical odds movement for a single event. Paid tiers (Hobby / Pro / Streaming Lite / Streaming / Enterprise): full snapshot history. Free tier: redacted (shows structure and count).

sport_keystring required

event_idinteger required

marketsstring

bookmakersstring nullable

Comma-separated bookmaker keys (e.g. 'draftkings,fanduel'). Omitted = all books. Matches the-odds-api's bookmakers param.

fromstring date-time nullable

ISO timestamp; only include snapshots at or after this time.

tostring date-time nullable

ISO timestamp; only include snapshots at or before this time.

relative_fromstring nullable

Offset relative to commence_time, e.g. '-3h', '-30m', '-90s'. Mutually exclusive with from.

relative_tostring nullable

Offset relative to commence_time, e.g. '-1m' or '0' for the closing line itself. Mutually exclusive with to.

intervalstring nullable

Downsample to one snapshot per bucket. One of '30s', '1m', '5m', '15m', '30m', '1h'.

changes_onlyboolean

When true, drop snapshots whose (price, point) match the previous one — keep only moment-of-change rows.

periodstring nullable

Game-period filter. Omitted = full-game markets only. Pass canonical codes ('q1', 'h1', 'p1', 'i6', 'f5') comma-separated, or 'all' to include every period.

Response

Successful Response

idstring required

sport_keystring required

home_teamstring required

away_teamstring required

commence_timestring date-time required

liveboolean

upgrade_urlstring nullable

v5

Get Event Odds History

Path parameters

Query parameters

Response