Skip to content

League key basketball_nba

NBA odds API

Pre-match and live NBA odds from bookmakers, with a margin-adjusted fair price on every market, in one consistent JSON format.

Get startedRead the integration guide

NBA competitions in the catalog

These NBA competitions come from the bookmakers' own public listings. Each one has its own league key.

CompetitionLeague key
NBAbasketball_nba
NBA Cupbasketball_nba_cup
NBA Preseasonbasketball_nba_preseason
NBA All Starsbasketball_nba_all_stars
NBA Summer Leaguebasketball_nba_summer_league

Choose NBA competitions

NBA markets

You get every market the bookmakers offer for each event. The most common ones:

Bookmakers you can pick for NBA

A few well-known names from the bookmaker catalog. Which NBA competitions each bookmaker lists varies, and your plan sets how many bookmakers you choose.

See all 340+ bookmakers

Example request

One request returns the bookmaker price and the fair price for every outcome. Sport and league keys are being added to the API; the request shows the format.

Example fixture: Boston Celtics against Los Angeles Lakers. The teams are real; the odds and the time are made up.

GET https://api.valueoddsapi.com/v1/odds?sport=basketball&league=basketball_nba&phase=prematch
Authorization: Bearer YOUR_API_KEY
{
  "example": true,
  "data": [
    {
      "event_id": "example-001",
      "sport": "basketball",
      "league": "basketball_nba",
      "home_team": "Boston Celtics",
      "away_team": "Los Angeles Lakers",
      "phase": "prematch",
      "bookmaker": "example-book",
      "observed_at": "2026-11-03T12:00:00Z",
      "data_age_seconds": 0.25,
      "market": {
        "id": "match_winner",
        "period": "full_time",
        "line": null,
        "status": "open",
        "method": "proportional_v1",
        "fair_status": "available",
        "overround": 0.0434,
        "outcomes": [
          {
            "id": "home",
            "bookmaker_odds": 1.8,
            "fair_odds": 1.88,
            "fair_probability": 0.5325
          },
          {
            "id": "away",
            "bookmaker_odds": 2.05,
            "fair_odds": 2.14,
            "fair_probability": 0.4675
          }
        ]
      }
    }
  ]
}

Example data, not live prices. Fair odds use proportional margin removal. Read the integration guide

What you can build with NBA odds

Which plan fits

basketball_nba is included on every plan, along with every other league in every sport. The other NBA competitions in the table have their own keys and are included too.

Your plan sets how many bookmakers you choose, not how many leagues: NBA and every other basketball competition are always included.

See plans and prices

Questions about NBA odds

Which NBA competitions does the API cover?

The catalog lists 5 NBA competitions, taken from bookmakers' own public listings: NBA, NBA Cup, NBA Preseason, NBA All Stars, NBA Summer League. Each has its own league key.

Do you have live NBA odds?

Yes. Pro and higher plans stream pre-match and live odds in real time over WebSocket and REST. Solo covers pre-match odds.

Are NBA player props included?

Yes, when the bookmakers you pick list them for the game. Player markets come with the bookmaker price and a margin-adjusted fair price side by side, like every other market; which player markets are listed varies per bookmaker.

How do I request NBA odds, and is it included in my plan?

Use the sport key basketball and the league key basketball_nba. NBA is included on every plan, and so are the other NBA competitions with their own keys.

Related pages

Other basketball competitions

Get NBA odds into your product

Bookmaker odds and fair odds in one format, from pre-match to live.

Get startedSee pricing