# Basketball Odds API
URL: https://sockodds.com/sports/basketball-odds-api/

> Access basketball betting odds from every Australian bookmaker through the SockOdds API. Basketball odds for NBA including head to head, lines, totals, player props and more.

Access basketball betting odds from 25 bookmakers through the SockOdds API. Get basketball odds for every game including head to head, lines, totals, player props and more — `sportID=BASKETBALL`.

## Basketball Odds API Features

Our basketball odds API is fully filterable, so you pull exactly the data you want — games, player props, teams or specific markets. Curate the feed to your needs with the same parameters SportsGameOdds developers already know.

125 distinct markets are priced across 1 league right now:

- 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 (quarters and halves)

## Basketball leagues

| League | leagueID | Events | Markets | Bookmakers |
| --- | --- | --- | --- | --- |
| [NBA](https://sockodds.com/leagues/nba-odds-api/) | `NBA` | 1 | 125 | 7 |

## Basketball Player Props

Access 26 basketball player proposition markets — points, rebounds, assists, threes, steals, blocks and the PRA combinations — pre-match across every game the Australian books price. See the [player prop odds API](https://sockodds.com/player-props-odds-api/) for the full market list by sport and how to filter props in a single request.

## Basketball API Odds with Results

SockOdds delivers basketball odds and event data in one configuration:

- Upcoming games with status flags
- Home and away teams with ids
- Players with production ids where the source carries them
- Basketball odds including lines, totals, head to head, player props and more
- Results and grading flags where the source has them

## Quick start: your first Basketball odds API call

```
https://api.sockodds.com/v2/events?apiKey=YOUR_API_KEY&oddsAvailable=true&sportID=BASKETBALL&limit=10
```

Or one league at a time, which is faster:

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

## Stats priced in basketball

| statID | Name | Markets | Levels |
| --- | --- | --- | --- |
| `points` | Points / score | 129 | all, team, player |
| `points+rebounds` | Points + rebounds | 34 | player |
| `points+rebounds+assists` | Points + rebounds + assists | 34 | player |
| `rebounds` | Rebounds | 32 | player |
| `threePointersMade` | Three-pointers made | 32 | player |
| `steals` | Steals | 28 | player |
| `points+assists` | Points + assists | 28 | player |
| `rebounds+assists` | Rebounds + assists | 28 | player |
| `assists` | Assists | 26 | player |
| `doubleDouble` | Double-double | 22 | player |
| `firstBasket` | First basket | 20 | player |
| `blocks` | Blocks | 16 | player |
| `tripleDouble` | Triple-double | 6 | player |
| `firstTo15` | First to 15 | 2 | team |
| `firstTo20` | First to 20 | 2 | team |
| `firstTo25` | First to 25 | 2 | team |

## Basketball 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](https://sockodds.com/docs/) — live examples, copy-paste snippets and an [AI (vibe coding)](https://sockodds.com/docs/info/ai-vibe-coding/) context
- [SDKs & libraries](https://sockodds.com/docs/sdk/) — the SportsGameOdds SDKs for TypeScript, Python, Ruby, Go and Java work unchanged with the base URL pointed here
- [Postman collection](https://sockodds.com/postman-collection/) — pre-built requests ready to run
- [Support](https://sockodds.com/docs/help/) — email support on every plan, priority on paid plans

### Basketball market coverage by category

| Market category | Example markets | Markets | Availability | Typical bookmakers |
| --- | --- | --- | --- | --- |
| **Full game lines** | Points / score O/U, Points / score line, Points / score 1X2, Points / score | 13 oddIDs | Pre-match | [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [Dabble](https://sockodds.com/bookmakers/dabble-odds-api/), [Picklebet](https://sockodds.com/bookmakers/picklebet-odds-api/), [BetDeluxe](https://sockodds.com/bookmakers/betdeluxe-odds-api/), [BetRight](https://sockodds.com/bookmakers/betright-odds-api/) |
| **Period markets** | Points / score O/U, Points / score 1X2, Points / score line, Points / score | 74 oddIDs | Pre-match | [BetDeluxe](https://sockodds.com/bookmakers/betdeluxe-odds-api/), [Neds](https://sockodds.com/bookmakers/neds-odds-api/), [TABtouch](https://sockodds.com/bookmakers/tabtouch-odds-api/), [Unibet](https://sockodds.com/bookmakers/unibet-odds-api/), [TAB](https://sockodds.com/bookmakers/tab-odds-api/), [Sportsbet](https://sockodds.com/bookmakers/sportsbet-odds-api/) |
| **Team & game specials** | Points / score, First to 15, First to 20, First to 25 | 12 oddIDs | Pre-match | [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [BetDeluxe](https://sockodds.com/bookmakers/betdeluxe-odds-api/), [PointsBet](https://sockodds.com/bookmakers/pointsbet-odds-api/), [Sportsbet](https://sockodds.com/bookmakers/sportsbet-odds-api/), [TAB](https://sockodds.com/bookmakers/tab-odds-api/) |
| **Player props** | Points / score O/U, Assists O/U, Blocks O/U, Steals O/U, Rebounds O/U, Double-double yes/no, Triple-double yes/no | 24 oddIDs | Pre-match | [Sportsbet](https://sockodds.com/bookmakers/sportsbet-odds-api/), [Ladbrokes](https://sockodds.com/bookmakers/ladbrokes-odds-api/), [Neds](https://sockodds.com/bookmakers/neds-odds-api/), [BetDeluxe](https://sockodds.com/bookmakers/betdeluxe-odds-api/), [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/) |
| **Scorer props** | First basket yes/no | 2 oddIDs | Pre-match | [BetDeluxe](https://sockodds.com/bookmakers/betdeluxe-odds-api/) |

## Use Cases for Basketball API Data

- [Arbitrage](https://sockodds.com/use-cases/arbitrage-betting-api/) & [+EV tools](https://sockodds.com/use-cases/positive-ev-betting-api/) — compare basketball odds across every Australian bookmaker to uncover arbitrage opportunities and positive expected value angles.
- [Odds comparison platforms](https://sockodds.com/use-cases/odds-comparison-api/) — display basketball odds from every book side by side for comprehensive line shopping.
- **Pricing models & trading** — use basketball market data as inputs for proprietary pricing algorithms and betting strategies.
- [Sports analytics & research](https://sockodds.com/use-cases/sports-betting-machine-learning/) — examine basketball line movements and betting-market patterns, and build predictive models on retained events.
- [Betting automation](https://sockodds.com/use-cases/odds-alert-bot-api/) — build systems that monitor basketball lines across bookmakers and trigger actions when your target odds appear.
- [Sportsbook & fantasy apps](https://sockodds.com/use-cases/sports-betting-app-api/) — power your basketball product with reliable odds, status and bet-slip deeplinks.

## Basketball Odds API Documentation

Our interactive documentation covers everything you need to integrate Basketball 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](https://sockodds.com/docs/)

## Start building today

Free plan available. Set up in 5 minutes. Scale when you're ready.