Sign in

v5

OpenAPI 3.1.02026-08-02305676.6 KB
Events & Odds

Get Event Odds

Get odds for a single event — supports player prop markets. This is where the real value is.

Default markets is h2h,spreads,totals — the three game-line markets every book carries across every sport. Pass an explicit markets= to fetch player props (sport-specific keys like pitcher_strikeouts / player_points / player_goals). Previous default was MLB-only and silently returned 0 bookmakers on every other sport when the caller (or SDK) omitted the param.

get/v1/sports/{sport_key}/events/{event_id}/odds

Path parameters

sport_keystring required
event_idinteger required

Query parameters

marketsstring
bookmakersstring nullable

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

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

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.

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
last_updatestring date-time nullable