HEAD ======= >>>>>>> origin/main
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.
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.
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
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
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
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
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.
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.
The current board, straight from the API - the same rows an
/odds call returns.
Which books are writing which sports and markets, measured from live ingest - including the NBA detail page.
parlay-api.com/coverage →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 →
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.
# 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"
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.
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 "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"
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.
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.
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.
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.
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.
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.
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.