Query Current Bookmaker Odds

Query current bookmaker odds in 2 steps

Step 1: Get in-season sports keys

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.

Step 2: Get current bookmaker odds for a sport or league

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.
  • Defaults to h2h
• oddsFormat determines the format of returned odds. Valid values are demical and american.
  • Defaults to 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.

Query Scores

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.

Other Endpoints

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.