← Tools Reference

The Odds API

The Odds API integration (Data). Imported from open-connector.

API key7 toolshttps://api.the-odds-api.com/v4
GET
the_odds_api_list_sports
List sports supported by The Odds API.

/sports

1 parameter
ParamTypeRequiredDescription
allbooleanoptionalWhether to include both in-season and out-of-season sports.
GET
the_odds_api_get_odds
Get live and upcoming odds for a sport from The Odds API.

/sports/{sport}/odds

13 parameters
ParamTypeRequiredDescription
sportstringrequiredThe sport key returned by The Odds API sports endpoint, or upcoming for the nex…
regionsarrayrequiredBookmaker regions to request, such as us, us2, uk, au, or eu.
marketsarrayoptionalBetting market keys to request, such as h2h, spreads, or totals.
dateFormatstringoptionalTimestamp format returned by The Odds API.
oddsFormatstringoptionalOdds format returned by The Odds API.
eventIdsarrayoptionalEvent IDs used to filter odds.
bookmakersarrayoptionalBookmaker keys used to filter odds.
commenceTimeFromstringoptionalISO 8601 timestamp used by The Odds API to filter event commence time.
commenceTimeTostringoptionalISO 8601 timestamp used by The Odds API to filter event commence time.
includeLinksbooleanoptionalWhether bookmaker event, market, and betslip links are included.
includeSidsbooleanoptionalWhether source IDs are included when available.
includeBetLimitsbooleanoptionalWhether bet limits are included when available.
includeRotationNumbersbooleanoptionalWhether home and away rotation numbers are included.
GET
the_odds_api_get_scores
Get live and recent completed scores for a sport from The Odds API.

/sports/{sport}/scores

4 parameters
ParamTypeRequiredDescription
sportstringrequiredThe sport key returned by The Odds API sports endpoint, or upcoming for the nex…
daysFromintegeroptionalNumber of days in the past from which to return completed scores.
dateFormatstringoptionalTimestamp format returned by The Odds API.
eventIdsarrayoptionalEvent IDs used to filter scores.
GET
the_odds_api_list_events
List live and upcoming events for a sport from The Odds API.

/sports/{sport}/events

6 parameters
ParamTypeRequiredDescription
sportstringrequiredThe sport key returned by The Odds API sports endpoint, or upcoming for the nex…
dateFormatstringoptionalTimestamp format returned by The Odds API.
eventIdsarrayoptionalEvent IDs used to filter events.
commenceTimeFromstringoptionalISO 8601 timestamp used by The Odds API to filter event commence time.
commenceTimeTostringoptionalISO 8601 timestamp used by The Odds API to filter event commence time.
includeRotationNumbersbooleanoptionalWhether home and away rotation numbers are included.
GET
the_odds_api_get_event_odds
Get odds for one The Odds API event.

/sports/{sport}/events/{eventId}/odds

11 parameters
ParamTypeRequiredDescription
sportstringrequiredThe sport key returned by The Odds API sports endpoint, or upcoming for the nex…
eventIdstringrequiredThe event ID returned by The Odds API.
regionsarrayrequiredBookmaker regions to request, such as us, us2, uk, au, or eu.
marketsarrayoptionalBetting market keys to request, such as h2h, spreads, or totals.
dateFormatstringoptionalTimestamp format returned by The Odds API.
oddsFormatstringoptionalOdds format returned by The Odds API.
bookmakersarrayoptionalBookmaker keys used to filter event odds.
includeLinksbooleanoptionalWhether bookmaker event, market, and betslip links are included.
includeSidsbooleanoptionalWhether source IDs are included when available.
includeBetLimitsbooleanoptionalWhether bet limits are included when available.
includeMultipliersbooleanoptionalWhether DFS multipliers are included when available.
GET
the_odds_api_list_event_markets
List recently seen market keys for one The Odds API event.

/sports/{sport}/events/{eventId}/markets

5 parameters
ParamTypeRequiredDescription
sportstringrequiredThe sport key returned by The Odds API sports endpoint, or upcoming for the nex…
eventIdstringrequiredThe event ID returned by The Odds API.
regionsarrayrequiredBookmaker regions to request, such as us, us2, uk, au, or eu.
bookmakersarrayoptionalBookmaker keys used to filter event markets.
dateFormatstringoptionalTimestamp format returned by The Odds API.
GET
the_odds_api_list_participants
List participants for a sport from The Odds API.

/sports/{sport}/participants

1 parameter
ParamTypeRequiredDescription
sportstringrequiredThe sport key returned by The Odds API sports endpoint, or upcoming for the nex…