NBA Odds API

Our NBA odds API delivers National Basketball Association odds, player props, status and results for every game from 25 bookmakers, 21 of them Australian. leagueID=NBA. Free tier available.

Whether you're building a betting app, an odds comparison tool or a pricing model, the NBA odds API gives you structured data in the SportsGameOdds v2 shape so you can move fast.

NBA Odds API Features

Every endpoint is filterable, so you pull exactly the markets you need. Coverage spans 2 teams and 1 event currently carried, with 36 market families.

Available NBA betting markets include:

• Head to head / moneylines (2-way and 3-way markets)
• Lines, spreads and handicaps
• Totals (over/under)
• Alternative lines
• Player props and game props
• Period-specific markets (1h, 1q, 2h, 2q, 3q, 4q, reg)

All market data is pre-match, refreshed every ~2 minutes; see pricing for what each plan can see.

NBA Player Props API

Access 26 NBA player proposition markets through the same endpoint — Points / score, Assists, Blocks, Steals, Rebounds, First basket — for every player the books price. See the player prop odds API for the market list across every sport.

Filter by playerID, stat type or bookmaker to return only the props you need.

NBA Odds API with Results

SockOdds delivers NBA odds and event data together in one response — no need to stitch data from multiple sources. Each response includes:

• Upcoming NBA events with status flags
• Home and away team data with ids
• Players with production ids where present
• Full odds coverage: lines, totals, head to head, props and alternative lines
• Results and scoringSupported flags where the source grades

Line movement tracking is yours to build: every bookmaker entry carries lastUpdatedAt, and finished events are retained.

Quick start: your first NBA odds API call

Getting NBA odds takes a single HTTP request:

https://api.sockodds.com/v2/events?apiKey=YOUR_API_KEY&oddsAvailable=true&leagueID=NBA&limit=10

This returns all available markets — lines, totals, head to head and props — for upcoming NBA events.

To narrow to a specific market, use the oddID parameter, with PLAYER_ID standing for every player:

https://api.sockodds.com/v2/events?apiKey=YOUR_API_KEY&oddsAvailable=true&leagueID=NBA&oddID=points-PLAYER_ID-game-ou-over&includeOpposingOdds=true

OddIDs follow the format {statID}-{statEntityID}-{periodID}-{betTypeID}-{sideID}, where the entity is a player for props and home, away or all for team and game markets.

Tips to keep responses fast:

• Add bookmakerID=betdeluxe,sportsbet to limit to the bookmakers you care about
• Use includeOpposingOdds=true so you only need to specify one side of a market
• Keep your oddID list tight — only request markets you're actively using

What a NBA response looks like

Every event returns an odds object keyed by oddID. Here's a real market from the feed with the bookmaker list cut to two books:

{
  "eventID": "nba_2026-06-13_new_york_knicks_at_san_antonio_spurs",
  "leagueID": "NBA",
  "odds": {
    "points-all-game-eo-odd": {
      "oddID": "points-all-game-eo-odd",
      "opposingOddID": "points-all-game-eo-even",
      "marketName": "Odd/Even Total Points",
      "statID": "points",
      "statEntityID": "all",
      "periodID": "game",
      "betTypeID": "eo",
      "sideID": "odd",
      "fairOdds": null,
      "bookOdds": "-118",
      "byBookmaker": {
        "tab": {
          "odds": "-118",
          "available": true
        },
        "unibet": {
          "odds": "-122",
          "available": true
        }
      }
    }
  }
}

Two things worth noting. Odds values are strings, not numbers, so -108 arrives as "-108" — that keeps the leading + intact on underdog prices — and every book also carries decimal, because Australian books quote decimal. bookOdds is the consensus with the vig left in; fairOdds is the de-vigged price on Base and above, null where it cannot be computed.

NBA Odds API Technical Specifications

API Architecture

• REST API — Simple HTTP endpoints with JSON responses, identical to the SportsGameOdds v2 paths
• Polling, not push — the feed refreshes every ~2 minutes; /v2/stream/events is reserved and answers 501 rather than pretending
• Rate limits — per-key, per-minute meters that bind under concurrency; plans sized to your usage
• Authentication — secure API key access via the x-api-key header or apiKey query parameter

Data Update Speed

• Odds updates — every ~2 minutes across every bookmaker lane
• Event status — status flags and info.stale tell you exactly how current a price is

Developer Resources

• Interactive documentation — live examples, copy-paste snippets and an AI (vibe coding) context
• SDKs & libraries — the SportsGameOdds SDKs for TypeScript, Python, Ruby, Go and Java work unchanged with the base URL pointed here
• Postman collection — pre-built requests ready to run
• Support — email support on every plan, priority on paid plans

NBA betting market coverage in the SockOdds API, by category

See every NBA market with its exact oddID in the markets browser.

Use Cases

• Arbitrage & +EV tools — compare NBA odds across every Australian bookmaker to uncover arbitrage opportunities and positive expected value angles.
• Odds comparison platforms — display NBA odds from every book side by side for comprehensive line shopping.
• Pricing models & trading — use NBA market data as inputs for proprietary pricing algorithms and betting strategies.
• Sports analytics & research — examine NBA line movements and betting-market patterns, and build predictive models on retained events.
• Betting automation — build systems that monitor NBA lines across bookmakers and trigger actions when your target odds appear.
• Sportsbook & fantasy apps — power your NBA product with reliable odds, status and bet-slip deeplinks.

NBA Odds API Documentation

Our interactive documentation covers everything you need to integrate NBA odds into your project:

• Full endpoint reference with parameters and response schemas
• Live request and response examples
• Code snippets in Python, JavaScript, Ruby, Go and Java
• Authentication setup and API key management
• Rate limiting and the notice field
• Error handling and troubleshooting

View documentation

For more on querying /v2/events with NBA-specific examples, see the API documentation.

Frequently asked questions