Query current bookmaker odds in 2 steps
Query a list of in-season sports keys. A list of available sports can alternatively be found on our website.
Example request
https://odds.p.rapidapi.com/v4/sports
Example Response
[
{
"key": "americanfootball_nfl",
"group": "American Football",
"title": "NFL",
"description": "US Football",
"active": true,
"has_outrights": false
},
...
]
More info
More information on this endpoint can be found on our website.
Use the key
field from the previous response to query current bookmaker odds. Using americanfootball_nfl
as an example:
Example request
https://odds.p.rapidapi.com/v4/sports/americanfootball_nfl/odds?regions=us&markets=h2h,spreads&oddsFormat=american
Parameters
regions
determines which bookmakers are returned. A list of bookmakers and regions can be found on our website.markets
determines the odds markets to be returned. This endpoint supports featured markets only, including h2h
(moneyline, 1X2), spreads
and totals
. More information on markets can be found on our website.
h2h
oddsFormat
determines the format of returned odds. Valid values are demical
and american
.
decimal
.More information on these and other parameters can be found on our website.
Example Response
The response will include a list of in-play and pre-match events (typically for the current round), along with bookmakers for the specifed regions and their odds for the specified markets. This example shows odds in the American format, which can be changed using the oddsFormat
parameter.
[
{
"id": "eca3b71919531e7ae0b4f3f501157e6c",
"sport_key": "americanfootball_nfl",
"sport_title": "NFL",
"commence_time": "2024-09-06T23:00:00Z",
"home_team": "Philadelphia Eagles",
"away_team": "Green Bay Packers",
"bookmakers": [
{
"key": "draftkings",
"title": "DraftKings",
"last_update": "2024-04-21T06:04:18Z",
"markets": [
{
"key": "h2h",
"last_update": "2024-04-21T06:04:18Z",
"outcomes": [
{ "name": "Green Bay Packers", "price": -102 },
{ "name": "Philadelphia Eagles", "price": -118 }
]
},
{
"key": "spreads",
"last_update": "2024-04-21T06:04:18Z",
"outcomes": [
{ "name": "Green Bay Packers", "price": -108, "point": 1.5 },
{ "name": "Philadelphia Eagles", "price": -112, "point": -1.5 }
]
}
]
},
...
...
]
More info
More information on this endpoint can be found on our website.
Live scores can be queried for several leagues. Final scores for completed events can be queried up to 3 days prior. Whilst scores data is available for several leagues, not all sports are covered (see the “Scores & Results” column at this link).
Example request
https://odds.p.rapidapi.com/v4/sports/soccer_epl/scores?daysFrom=3
Parameters
daysFrom
determines the number of past days for which to return events. The maximum is 3. If this parameter is missing, scores will only be returned for incomplete events.Example Response
[
{
"id": "2e66fec74600a8b930f6953d1f21cd58",
"sport_key": "soccer_epl",
"sport_title": "EPL",
"commence_time": "2024-04-20T14:00:19Z",
"completed": true,
"home_team": "Sheffield United",
"away_team": "Burnley",
"scores": [
{
"name": "Burnley",
"score": "4"
},
{
"name": "Sheffield United",
"score": "1"
}
],
"last_update": "2024-04-21T01:53:59Z"
},
...
]
More info
More information on this endpoint can be found on our website.
The Odds API provides additional endpoints and functionality that might not be available on RapidAPI. This includes player props and other markets, historical odds, and more. These additional features can be accessed using subscriptions on our website.