Skip to content

NBA Odds API ​

Get current and historical NBA odds from several bookmakers in a simple JSON API.

Not a developer? Current NBA odds can also be accessed in Excel or Google Sheets.

NBA Odds API ​

Once you have your API key, current NBA odds can be queried with the following parameters:

  • The sport key basketball_nba
  • The regions of desired bookmakers (us, us2, uk, eu or au)
  • Markets (h2h for moneyline, spreads or totals)
  • Odds format (decimal or American)
  • And your API key (get a free API key)

The API will return live and upcoming NBA games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets.

Example Request

GET https://api.the-odds-api.com/v4/sports/basketball_nba/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY

Example Response

json
[{
    "id": "4f88be957c08fec11f1a32985c4e0ca4",
    "sport_key": "basketball_nba",
    "sport_title": "NBA",
    "commence_time": "2023-02-01T00:10:00Z",
    "home_team": "Cleveland Cavaliers",
    "away_team": "Miami Heat",
    "bookmakers": [
    {
        "key": "draftkings",
        "title": "DraftKings",
        "last_update": "2023-01-31T23:55:27Z",
        "markets": [
            {
                "key": "h2h",
                "last_update": "2023-01-31T23:55:27Z",
                "outcomes": [
                    {"name": "Cleveland Cavaliers", "price": -165},
                    {"name": "Miami Heat", "price": 140}
                ]
            },
            {
                "key": "spreads",
                "last_update": "2023-01-31T23:55:27Z",
                "outcomes": [
                    {"name": "Cleveland Cavaliers", "price": -110, "point": -4.0},
                    {"name": "Miami Heat", "price": -110, "point": 4.0}
                ]
            },
            {
                "key": "totals",
                "last_update": "2023-01-31T23:55:27Z",
                "outcomes": [
                    {"name": "Over", "price": -105, "point": 211.0},
                    {"name": "Under", "price": -115, "point": 211.0}
                ]
            }
        ]
    },
    ...

See the API documentation for more details.

NBA Bookmakers ​

The Odds API covers NBA odds from several bookmakers, including:

  • US Bookmakers: Draftkings, Fanduel, FoxBet, BetMGM, Caesars, Bovada, and more

  • UK Bookmakers: Unibet, William Hill, Ladbrokes, Betfair, Bet Victor, Paddy Power and more

  • EU Bookmakers: 1xBet, Pinnacle, Betclic, Betsson, Unibet and more

  • AU Bookmakers: Sportsbet, TAB, Neds, Ladbrokes, Betfair, Unibet and more

See the full list of bookmakers

NBA Markets ​

The Odds API covers NBA odds for several betting markets, including

  • Moneyline

  • Spreads (handicap)

  • Over/Under (totals)

  • Quarter time and half time odds

  • NBA player props (US and AU bookmakers only)

See the full list of betting markets.

Latency ​

More information on odds latencies can be found here.

Historical NBA Odds Data ​

Historical NBA odds are available from mid-2020 for featured markets (moneyline, spreads and totals). Learn more about historical odds data, or see the docs.

Get Started ​

More Basketball Odds ​

Odds are available for other basketball leagues including

  • NCAA

  • WNBA

  • Euroleague

Odds are also available for a wide range of sports. See the full list of available sports.