Australian and New Zealand basketball

NBL API: Fixtures, Game Lines and Bookmaker Odds

Our NBL odds API provides fixtures, teams and tip-off times alongside bookmaker prices for head-to-head, line betting, totals and player props. Keep each game's bookmaker prices and periods connected with one event ID.

Paid plans from $50/month. No surprise charges.

/v1/events/nbl-example-001/odds/snapshot
{
  "event_id": "nbl-example-001",
  "as_of_ts_ms": 1793498400000,
  "ttl_seconds": 120,
  "items": [
    {
      "bookmaker": "sportsbet",
      "market_key": "moneyline",
      "selection_name": "Tasmania JackJumpers",
      "odds": 1.75,
      "fair_odds": 1.78
    },
    {
      "bookmaker": "sportsbet",
      "market_key": "moneyline",
      "selection_name": "Sydney Kings",
      "odds": 2.25,
      "fair_odds": 2.29
    }
  ]
}

NBL fixtures and teams

Retrieve game IDs, team names and scheduled tip-offs with the basketball and NBL filters.

Game and period markets

Compare head-to-head, line and total points prices for full games, halves and quarters.

NBL player props

Request player points, rebounds, assists and made-threes lines alongside game odds.

Follow NBL game lines and player markets

Give users a fixture picker with full-game, half, quarter and player-market views. Compare Sportsbet, TAB and Ladbrokes prices for the exact same bet.

Authentication
X-API-Key
Bookmakers
sportsbet, tab, ladbrokes
GET /v1/events/{event_id}/odds/snapshot?bookmakers=sportsbet,tab,ladbrokes
Create an NBL odds screen with a game picker and separate views for full-game lines, halves, quarters and player props. Use https://api.odds-api.net/v1.

Discover games at /events?sport=basketball&league=NBL&not_started_only=true&limit=50. Show both teams and the scheduled tip-off. Convert Unix start_time to a configurable display time zone rather than assuming every Australian and New Zealand venue uses the same zone.

For a selected event_id, fetch /events/{event_id}/odds/snapshot?bookmakers=sportsbet,tab,ladbrokes&price_fields=odds&include_unavailable=true. Follow next_cursor on event and odds responses.

Group game prices into Head-to-head, Line and Total points. Add Points, Rebounds, Assists and Threes filters for player props. Use a column per bookmaker and match rows by market_key, period label, line, side and player_name. Use period_str when present, otherwise the returned period label; a numeric period alone can refer to a half or a quarter. Keep each quarter and half separate from the full-game market.

Display decimal odds, highlight tied best offered prices and show a dash for missing or suspended quotes. Include bookmaker_as_of_ts_ms to show quote age. Player prop thresholds are betting markets, not recorded player statistics.

Keep ODDS_API_KEY on the server and authenticate with X-API-Key. Follow https://odds-api.net/docs/nbl for period filtering, historical selection prices and stream updates.

Fixture. Period. Selection.

Connect NBL fixtures
to bookmaker markets

Discover a game once, then use its event ID for the game record, result endpoint, complete odds snapshot and price stream.

  1. Game schedule

    List NBL games with teams, scheduled tip-offs and canonical event IDs.

    GET /v1/events?sport=basketball&league=NBL
  2. Game record

    Retrieve the source game record using the same event ID as the odds feed.

    GET /v1/events/{event_id}
  3. Result record

    Read the result endpoint and handle its pending or available status.

    GET /v1/events/{event_id}/results
  4. Game and player odds

    Load bookmaker quotes for game lines, periods, team totals and player markets.

    GET /v1/events/{event_id}/odds/snapshot
  5. Price changes

    Update your odds view from SSE or WebSocket deltas after loading the snapshot.

    GET /v1/events/{event_id}/odds/stream

The same event ID joins the fixture and game markets; period, line, player and side identify the bet.

NBL odds markets in one schema

Compare full-game prices, half and quarter markets, team totals and NBL player props using normalized market keys.

NBL marketAPI bet_typeWhat it covers
Head-to-head moneyline Two-way game-winner prices for the home and away teams.
Line betting handicap Point-start lines, including alternate thresholds and period-specific prices.
Game totals total Over and under prices for combined points, with game, half and quarter periods.
Team totals team total Over and under prices for one team's points.
Player scoring player pointsplayer threes Player points and made-three-pointer lines, matched by player and threshold.
Rebounds and assists player reboundsplayer assists Player rebound and assist thresholds with an over or under side.
Three-way result moneyline 3w Three-way result prices include a draw selection. Keep them separate from two-way head-to-head prices.

Built for agents and humans

MCP server

Tools for events, odds, line movement, streams, and paid-plan positive EV or arbitrage feeds.

Agent skill

Agent-ready instructions.

SDKs and examples

TypeScript, Python, Postman and example builds.

Sports and racing

Sports and racing odds coverage for agent workflows.

SSE odds stream

Lightweight streaming updates for dashboards and alerts.

WebSocket feeds

Bidirectional streams for richer pre-match products.

How to use the NBL API

Choose an NBL game, load its complete odds snapshot and keep the exact game period and selection attached to every price.

  1. Discover NBL games

    Filter events with sport=basketball and league=NBL, then retain each event ID and tip-off time.

  2. Load the complete game snapshot

    Request the game's odds, follow pagination and keep bookmaker keys on every row.

  3. Match periods and selections

    Separate full-game, half and quarter lines; match player props by player, line, side and period.

  4. Apply price updates

    Start the game's stream from the snapshot resume token and apply deltas by odds-row ID.

NBL API plans

Choose request and streaming allowances for your NBL product.

Best for first builds

Starter

250K
$50 USD / month

Odds

Requests
250K / month
Streams
500 stream-hours / month
Stream connections
3 concurrent
  • All Bookmakers
  • All Markets
  • 120 requests/min
  • Self-serve

Bets

  • Positive EV and arbitrage bets
  • Up to 4 bookmakers
Best value

Builder

2M
$90 USD / month

Odds

Requests
2M / month
Streams
1,500 stream-hours / month
Stream connections
8 concurrent
  • All Bookmakers
  • All Markets
  • 300 requests/min
  • Email support

Bets

  • Positive EV and arbitrage bets
  • Up to 6 bookmakers

Live

20M
$250 USD / month

Odds

Requests
20M / month
Streams
6,000 stream-hours / month
Stream connections
25 concurrent
  • All Bookmakers
  • All Markets
  • 600 requests/min
  • Priority email

Bets

  • Positive EV and arbitrage bets
  • Up to 15 bookmakers

Pro

75M
$500 USD / month

Odds

Requests
75M / month
Streams
20,000 stream-hours / month
Stream connections
75 concurrent
  • All Bookmakers
  • All Markets
  • 1,200 requests/min
  • Priority email plus onboarding

Bets

  • Positive EV and arbitrage bets
  • Up to 50 bookmakers

Enterprise grade

Custom feeds and models

Custom projects, scoped with your team.

Models and configurations

  • Custom fair-price models
  • Private +EV and arbitrage feeds
  • Separate brand configurations

Delivery and data

  • Managed feed delivery
  • Custom schemas and ID mapping
  • Research datasets and exports
  • Bookmaker and market coverage projects

NBL API FAQs

NBL league filters, game periods, player markets and price history.

Which NBL does this API cover?

NBL here is the National Basketball League in Australia and New Zealand. Request sport=basketball and league=NBL to select the competition.

Which NBL odds markets can I request?

NBL coverage includes head-to-head, line betting, game totals, team totals and player props. Use each row's period label to keep full-game, half and quarter prices separate.

Does the NBL API include player statistics?

Player points, rebounds, assists and threes are bookmaker prop markets. They describe betting selections and thresholds; they are not a player box-score or play-by-play feed.

How do I compare the same NBL bet across bookmakers?

Use the same event ID, market key, period, line, side and player name. A first-quarter line and a full-game line are separate bets, even when the team and threshold match.

Can I retrieve historical NBL odds and stream changes?

With history access, query retained prices for an event and selection using a bounded time window. For current odds, load the game snapshot and follow its SSE or WebSocket stream. The NBL docs include requests for both.