# 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

[{
    "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 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

Get a free API key
Check out the API docs
Check out Python and NodeJS code samples (opens new window)

# 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.