# NBL Odds API

The Odds API covers NBL odds for live and upcoming games in a simple JSON API.

Not a developer? Current NBL odds can also be accessed in Excel or Google Sheets. For website owners, the odds widget brings bookmaker odds into websites with a simple HTML tag.

# Features

  • NBL odds are covered for live and upcoming games.

  • Featured markets, including moneyline (head-to-head), spreads (points handicap), and totals are covered for several bookmakers. See the full list of bookmakers.

  • Additional markets including player props, quarter and half time markets, and more are covered for several AU bookmakers. See the full list of betting markets.

  • Odds are refreshed at regular intervals. More information on update intervals can be found here.

  • NBL scores are covered, with final scores available for games completed up to 3 days ago.

  • Current odds data and scores are available on all usage plans, including the free usage plan.

  • Historical NBL odds data is available on paid usage plans. Historical odds for featured NBL markets are available from September 2024. Historical odds for other NBL markets are available from late September 2026. More information on historical odds data can be found here.

  • The API response includes deep links to bookmaker websites.

# Querying NBL Odds

Featured markets (moneyline, spreads and totals) can be queried using the odds endpoint. For additional markets including player props, use the event-odds endpoint.

Parameters

To query current NBL odds for featured markets, the following parameters need to be provided:

  • sport   In this case basketball_nbl
  • regions   Regions of bookmakers to return, for example au
  • markets   For example, h2h for moneyline or head-to-head, spreads for handicap points, and totals for over/under total points
  • apiKey   Get a free API key

See the documentation for more options

Example API Request

https://api.the-odds-api.com/v4/sports/basketball_nbl/odds?regions=au&oddsFormat=decimal&markets=h2h,spreads,totals&apiKey=YOUR_API_KEY

Example API Response

The API will return live and upcoming NBL games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets.

[{
    "id": "9c0f0360354394640532f28f3658baa8",
    "sport_key": "basketball_nbl",
    "sport_title": "NBL",
    "commence_time": "2026-09-24T09:36:00Z",
    "home_team": "S.E. Melbourne Phoenix",
    "away_team": "Melbourne United",
    "bookmakers": [
        {
            "key": "sportsbet",
            "title": "SportsBet",
            "last_update": "2026-09-24T09:16:01Z",
            "markets": [
                {
                    "key": "h2h",
                    "last_update": "2026-09-24T09:16:01Z",
                    "outcomes": [
                        {"name": "Melbourne United", "price": 1.63},
                        {"name": "S.E. Melbourne Phoenix", "price": 2.28}
                    ]
                },
                {
                    "key": "spreads",
                    "last_update": "2026-09-24T09:16:01Z",
                    "outcomes": [
                        {"name": "Melbourne United", "price": 1.89, "point": -3.5},
                        {"name": "S.E. Melbourne Phoenix", "price": 1.91, "point": 3.5}
                    ]
                },
                {
                    "key": "totals",
                    "last_update": "2026-09-24T09:16:01Z",
                    "outcomes": [
                        {"name": "Over", "price": 1.88, "point": 193.5},
                        {"name": "Under", "price": 1.89, "point": 193.5}
                    ]
                }
            ]
        },
        {
            "key": "pointsbetau",
            "title": "PointsBet (AU)",
            "last_update": "2026-09-24T09:17:08Z",
            "markets": [
                {
                    "key": "h2h",
                    "last_update": "2026-09-24T09:17:08Z",
                    "outcomes": [
                        ...

The usage cost of the API call in this example is

usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits

See the API documentation for details.

# Query Any NBL Markets

Any supported NBL markets can be queried one game at a time using the event-odds endpoint.

Parameters

To query current NBL odds for any market, including player props, half and quarter time markets and more, the following parameters need to be provided:

  • sport   In this case basketball_nbl
  • eventId   This example uses the id of S.E. Melbourne Phoenix v Melbourne United (id 9c0f03...). A list of current event ids can be queried using the events endpoint.
  • regions   Regions of bookmakers to return, for example au
  • markets   For example h2h_q1 (1st quarter moneyline), player_points, player_assists_alternate
  • apiKey   Get a free API key

See the documentation for more options.

Milestone (X+ or over-only) markets are captured using _alternate player market keys, for example player_assists_alternate.

Example API Request

https://api.the-odds-api.com/v4/sports/basketball_nbl/events/9c0f0360354394640532f28f3658baa8/odds?regions=au&oddsFormat=decimal&markets=h2h_q1,player_points,player_assists_alternate&apiKey=YOUR_API_KEY

Example API Response

The response will contain the specified NBL game including odds from the specified bookmakers and markets.

{
    "id": "9c0f0360354394640532f28f3658baa8",
    "sport_key": "basketball_nbl",
    "sport_title": "NBL",
    "commence_time": "2026-09-24T09:36:00Z",
    "home_team": "S.E. Melbourne Phoenix",
    "away_team": "Melbourne United",
    "bookmakers": [
        {
            "key": "sportsbet",
            "title": "SportsBet",
            "markets": [
                {
                    "key": "h2h_q1",
                    "last_update": "2026-09-24T09:16:46Z",
                    "outcomes": [
                        {"name": "Melbourne United", "price": 1.74},
                        {"name": "S.E. Melbourne Phoenix", "price": 2.06}
                    ]
                },
                {
                    "key": "player_assists_alternate",
                    "last_update": "2026-09-24T09:16:46Z",
                    "outcomes": [
                        {"name": "Over", "description": "Skylar Mays", "price": 8.5, "point": 9.5},
                        {"name": "Over", "description": "Cole Anthony", "price": 1.49, "point": 3.5},
                        {"name": "Over", "description": "Joe Ingles", "price": 1.32, "point": 3.5},
                        ...
                },
                {
                    "key": "player_points",
                    "last_update": "2026-09-24T09:16:46Z",
                    "outcomes": [
                        {"name": "Over", "description": "Luke Travers", "price": 1.95, "point": 14.5},
                        {"name": "Under", "description": "Luke Travers", "price": 1.79, "point": 14.5},
                        {"name": "Over", "description": "Dshawn Schwartz", "price": 1.93, "point": 12.5},
                        {"name": "Under", "description": "Dshawn Schwartz", "price": 1.81, "point": 12.5},
                        ...
                    ]
                }
            ]
        },
        {
            "key": "pointsbetau",
            "title": "PointsBet (AU)",
            "markets": [
                {
                    "key": "h2h_q1",
                    "last_update": "2026-09-24T09:16:55Z",
                    "outcomes": [
                        ...

The usage cost of the API call in this example is

usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits

If you only need featured markets (moneyline, spreads, totals), it will be more cost-efficient to query the odds endpoint since it will return multiple games.

See the API documentation for details.

# Other Sports

See the full list of sports covered by The Odds API.

# Stay Updated

Follow us on X.com or Bluesky to stay updated on new sports, bookmakers, markets and features.