GET odds #

Returns a list of upcoming and live games with recent odds for a given sport, region, and market.

​

See the current lists of all bookmakers, markets, and sports covered.

​

​

​

URL​

GET Sports/{sport}/Odds?apiKey={apiKey}&regions={regions}&markets={markets}

​

​

Parameters

• apiKey  An API key is emailed when you sign up for a plan. Contact sales to get started

• sport   The sport key is obtained from calling the /sports endpoint. upcoming is always valid, returning any live games as well as the next 8 upcoming games across all sports

• apiKey   An API key is emailed when you sign up to a plan. Contact sales to get started

• regions   Determines the bookmakers to be returned. Valid regions are us, us2 (United States), uk (United Kingdom), au (Australia) and eu (Europe). Multiple regions can be specified if comma delimited. See the list of bookmakers by region. 

• markets   Optional - Determines which odds market is returned. Defaults to h2h (head to head / moneyline). Valid markets are h2h (moneyline), spreads (points handicaps), totals (over/under) and outrights (futures). Multiple markets can be specified if comma delimited. spreads and totals markets are mainly available for US sports and bookmakers at this time. Each specified market costs 1 against the usage quota, for each region.

  • Lay odds are automatically included with h2h results for relevant betting exchanges (Betfair, Matchbook etc). These have a h2h_lay market key.

  • For sports with outright markets (such as Golf), the market will default to outrights if not specified. Lay odds for outrights (outrights_lay) will automatically be available for relevant exchanges.

  • For more info, see descriptions of betting markets.

• dateFormat   Optional - Determines the format of timestamps in the response. Valid values are unix and iso (ISO 8601). Defaults to iso.

• oddsFormat   Optional - Determines the format of odds in the response. Valid values are decimal and american. Defaults to decimal. When set to american, small discrepancies might exist for some bookmakers due to rounding errors.

• eventIds   Optional - Comma-separated game ids. Filters the response to only return games for the specified game ids.

• bookmakers   Optional - Comma-separated list of bookmakers to be returned. If both bookmakers and regions are both specified, bookmakers takes priority. Bookmakers can be from any region. Every group of 10 bookmakers is the equivalent of 1 region. For example, specifying up to 10 bookmakers counts as 1 region. Specifying between 11 and 20 bookmakers counts as 2 regions.

• commenceTimeFrom   Optional - filter the response to show games that commence on and after this parameter. Values are in ISO 8601 format, for example 2023-09-09T00:00:00Z

• commenceTimeTo   Optional - filter the response to show games that commence on and before this parameter. Values are in ISO 8601 format, for example 2023-09-10T23:59:59Z

​

​

​

​

Example Request

GET https://oddsboostapi.azurewebsites.net/OddsAndScores/Sports/americanfootball_nfl/Odds/?apiKey=YOUR_API_KEY&regions=us&markets=h2h,spreads&oddsFormat=american

​

​

​

Example Response

[

  {

    "id": "7c8e887a27e43988654b137a001f6d3b",

    "sport_key": "americanfootball_nfl",

    "sport_title": "NFL",

    "commence_time": "2023-10-15T17:03:00Z",

    "home_team": "Atlanta Falcons",

    "away_team": "Washington Commanders",

    "bookmakers": [

      {

        "key": "fanduel",

        "title": "FanDuel",

        "last_update": "2023-10-14T16:15:08Z",

        "markets": [

          {

            "key": "h2h",

            "last_update": "2023-10-14T16:15:08Z",

            "outcomes": [

              {

                "name": "Atlanta Falcons",

                "price": -130

              },

              {

                "name": "Washington Commanders",

                "price": 108

              }

            ]

          },

          {

            "key": "spreads",

            "last_update": "2023-10-14T16:15:08Z",

            "outcomes": [

              {

                "name": "Atlanta Falcons",

                "price": -110,

                "point": -2.5

              },

              {

                "name": "Washington Commanders",

                "price": -110,

                "point": 2.5

              }

            ]

          }

        ]

      }

    ]

  }

]

​

​

​

Response Headers

Calls to the /sports endpoint will not affect the quota usage. The following response headers are returned:

• x-requests-remaining  The number of requests remaining until the quota resets

• x-requests-used  The number of requests used since the last quota reset

​

​

​

Usage Quota Cost

The usage quota cost is 1 per region per market.

cost = [number of markets specified] x [number of regions specified]

​

Examples

• 1 market, 1 region
  Cost: 1
  Example:  /v4/sports/americanfootball_nfl/odds?markets=h2h&regions=us&...

• 3 markets, 1 region
  Cost: 3
  Example:  /v4/sports/americanfootball_nfl/odds?markets=h2h,spreads,totals&regions=us&...

• 1 market, 3 regions
  Cost: 3
  Example:  /v4/sports/soccer_epl/odds?markets=h2h&regions=us,uk,eu&...

• 3 markets, 3 regions
  Cost: 9
  Example:  /v4/sports/basketball_nba/odds?markets=h2h,spreads,totals&regions=us,uk,au&...

​

​

​

Keeping track of quota usage

To keep track of requests used and remaining on an API key, every API response includes the following response headers:

• x-requests-used

• x-requests-remaining

​

​

​

More info

• The list of games returned in the /odds endpoint mirrors games that are listed by major bookmakers. This usually includes games for the current round

• Games may temporarily become unavailable after a round, before bookmakers begin listing the next round of games

• Games may be unavailable if the sport is not in season. For popular sports, bookmakers may begin listing new season games a few months in advance

• If no games are returned, the request will not count against the usage quota

• How to check if a game is live: The /odds endpoint response contains the commence_time of each game. This can be used to determine if a game is live or pre-match. If commence_time is greater than the current time, the game is pre-match. Otherwise, the game is live. The /odds endpoint does not return completed games

​

​

​

​