<<<<<<< HEAD ======= >>>>>>> origin/main NBA Odds API · Real-Time Lines, Player Props & Futures | ParlayAPI

NBA odds API with real-time lines, player props, and 2026-27 futures priced now

Moneylines, spreads, totals, player props, and futures for every NBA game, served from a platform of 30+ sportsbooks and sources - with sub-5-second freshness on the major books. Opening night is October 20, and books are already pricing opening-week games and the full 2026-27 futures board. Same response shape as the-odds-api, so an existing integration migrates in one URL change. Free tier, no card required.

45+
Sources, last 24h
4,000+
Prop markets (all sports)
sub-5s
Freshness, major books
1,000
Free credits / month

What the API covers for the NBA

One sport key - basketball_nba - the same key the-odds-api uses. Platform-wide figures below are measured across all 90+ sports we carry; the NBA is served by the same pipeline.

Game linesMoneylines, spreads & totals

Full-game h2h, spread, and total prices. Opening-week games are already on the board: measured in the last 24 hours, 22 sources - DraftKings, FanDuel and BetMGM among them - wrote NBA game-line rows for games from October 20 onward. In season, the NBA rides the same pipeline that processes 100k+ game-line updates per hour platform-wide.

GET /v1/sports/basketball_nba/odds GET /v1/sports/basketball_nba/events

Futures, live nowChampion, conference, MVP & awards

The 2026-27 NBA futures board is already flowing (measured 2026-08): NBA Champion, Eastern and Western Conference winner, Regular Season MVP, Defensive Player of the Year, and Rookie of the Year, currently priced by Pinnacle. Futures ride the props pipeline as futures market keys, so one endpoint returns them alongside player props.

GET /v1/sports/basketball_nba/props

Player propsPoints, rebounds, assists

NBA player props on canonical market keys: player_points, player_rebounds, player_assists and more. Measured in the last 24 hours, 27 sources wrote NBA prop rows across 294 distinct market keys. Nightly per-game props depth arrives with the season. Business tier and above adds WebSocket streaming at /ws/odds/basketball_nba - see /pricing.

GET /v1/sports/basketball_nba/props wss: /ws/odds/basketball_nba

HistoricalNBA closing lines back to 2007

52,000+ NBA closing game lines back to 2007, inside a platform archive of 1.7M+ closing game lines with continuous coverage from 2005 and 30M+ prop closing lines since June 2022 - the raw material for CLV tracking and backtesting NBA models.

GET /v1/historical/sports/basketball_nba/odds GET /v1/historical/sports/basketball_nba/closing-odds

Where NBA coverage stands today

The NBA is between seasons. Today's board (measured 2026-08) is opening-week game lines from October 20 onward, Pinnacle's 2026-27 futures board, and early prop markets - full nightly props depth arrives when the season tips off. If you need per-book NBA depth today, verify it yourself on the live NBA coverage page before you subscribe - it reads from live ingest.

Check the data before you sign up

Claims are cheap. These pages read from the same live API you'd be buying, so you can verify NBA coverage yourself, right now, without an account.

Live odds board

The current board, straight from the API - the same rows an /odds call returns.

parlay-api.com/live →

Coverage explorer

Which books are writing which sports and markets, measured from live ingest - including the NBA detail page.

parlay-api.com/coverage →

Status & freshness

Per-source ingest health and data freshness, updated continuously. If a book goes quiet, you'll see it here before we do a postmortem.

parlay-api.com/status →

Already on the-odds-api? Migrate in one URL change

ParlayAPI mirrors the-odds-api's v4 REST shape for NBA data: same basketball_nba sport key, same paths, same query parameters, same response JSON. Swap the base URL and your existing code keeps working. Full guide: /migrate-from-the-odds-api.

the one-line change
# before
curl "https://api.the-odds-api.com/v4/sports/basketball_nba/odds?regions=us&markets=h2h,spreads,totals&apiKey=YOUR_TOA_KEY"

# after
curl "https://parlay-api.com/v4/sports/basketball_nba/odds?regions=us&markets=h2h,spreads,totals&apiKey=YOUR_PARLAY_KEY"

Where the-odds-api is the better pick

the-odds-api is older, simpler, and more battle-tested, with a much larger base of tutorials, Stack Overflow answers, and community wrappers to copy from. If your NBA needs are basic - one region, game lines only, no streaming - its smaller surface area is a genuine advantage. Our honest roundup of the-odds-api alternatives compares seven providers side by side, us included.

Quickstart

Endpoint shapes below are the real ones from the API docs. Auth is either the-odds-api-style apiKey= query param or an X-API-Key header.

curl - NBA game lines
curl "https://parlay-api.com/v1/sports/basketball_nba/odds?regions=us&markets=h2h,spreads,totals&bookmakers=draftkings,fanduel,betmgm" \
  -H "X-API-Key: YOUR_KEY"

# player props and futures - one call returns all books for the sport
curl "https://parlay-api.com/v1/sports/basketball_nba/props" \
  -H "X-API-Key: YOUR_KEY"
Python - pip install parlay-api
from parlay_api import ParlayAPI

client = ParlayAPI(api_key="YOUR_KEY")

# Tonight's board: moneylines, spreads, totals
odds = client.odds("basketball_nba", regions="us", markets="h2h,spreads,totals")

# Player props on canonical market keys
props = client.props("basketball_nba", markets=["player_points", "player_rebounds"])

# De-vig a two-way prop into fair probabilities
fair_over, fair_under = ParlayAPI.devig(over_price=-110, under_price=-110)

SDK on GitHub: JacobiusMakes/parlay-api-python (MIT-licensed). Building with an AI agent instead? There's an official MCP server with 22 tools: pip install parlayapi-mcp.

NBA odds API - frequently asked

Is there a free NBA odds API?

Yes. ParlayAPI's free tier includes 1,000 credits per month with no credit card required, and it covers NBA game lines the same as paid plans. One call to /v1/sports/basketball_nba/odds returns moneyline, spread, and total prices. Current paid tiers are listed at /pricing.

Does the NBA odds API include player props?

Yes. GET /v1/sports/basketball_nba/props returns NBA player props - points, rebounds, assists and more - on canonical market keys (player_points, player_rebounds, player_assists). Measured in the last 24 hours (2026-08), 27 sources wrote NBA prop rows across 294 distinct market keys. Nightly per-game props depth arrives with the season, which tips off October 20.

Does the NBA odds API include futures markets?

Yes, and they are live now (measured 2026-08): 2026-27 NBA Champion, Eastern and Western Conference winner, Regular Season MVP, Defensive Player of the Year, and Rookie of the Year, currently priced by Pinnacle. Futures flow through the props pipeline as futures market keys on GET /v1/sports/basketball_nba/props. Opening-week game lines are live too: 22 sources wrote NBA game-line rows in the last 24 hours for games from October 20 onward.

Can I get historical NBA odds and closing lines?

Yes. The archive holds 52,000+ NBA closing game lines back to 2007, inside a platform archive of 1.7M+ closing game lines with continuous coverage back to 2005, plus 30M+ prop closing lines since June 2022. Query /v1/historical/sports/basketball_nba/odds for snapshots or /v1/historical/sports/basketball_nba/closing-odds for closing lines - useful for CLV tracking and model backtests.

Is ParlayAPI compatible with the-odds-api for NBA data?

Yes - ParlayAPI mirrors the-odds-api's v4 REST shape: the same basketball_nba sport key, the same endpoint paths, the same query parameters, and the same JSON response shape. Migrating an existing integration is a base-URL change from api.the-odds-api.com/v4 to parlay-api.com/v4 - see the migration guide. To be fair, the-odds-api is older and simpler with a larger base of tutorials; if you don't need props depth, streaming, or prediction-market signals, it remains a solid choice.

Ready before opening night.

The 2026-27 NBA season tips off October 20, and the futures board is already priced. Sign up free - 1,000 credits a month, no card required - and have NBA lines flowing in minutes.