Odds API by market / NBA
NBA Point Spread API
Live spreads odds across every book that posts it, in one REST call — and, unlike any other odds API, every one of those outcomes settled against the official result once play ends.
No credit card. 1,000 requests / day on the free tier.
What NBA point spread is
The handicap market. Each outcome carries a `point` (the handicap) alongside its price. Alternate spreads arrive in the same response rather than behind a separate paid market, so a full ladder is one request.
How we settle it. Settled against the final margin. An exact push on a whole-number handicap returns `push`, not a win or a loss.
Every number on this page is measured against the live API, never copied from a spec sheet. Last measured 16 August 2026.
Books posting NBA point spread
Measured live, not listed from a spec. Coverage moves — a book that has not put its board up yet will not appear until it does, which is exactly what this list is for.
Line shopping across all of them is one request — every book arrives in the same bookmakers array, not one call per book. Add ?bookmakers= to narrow it, or use /best-line for the best price per line already ranked.
Recently settled NBA point spread outcomes
These are real rows out of the API, not an illustration. Each one was a price on a board before the event and carries the actual figure it was graded against afterwards. No other odds API returns that last column — they stop at the price.
228 point spread outcomes settled in the last 21 days across 10 books. The 12 most recent:
| Bet | Actual | Result |
|---|---|---|
| NY Knicks 1.5 | -1.0 | won |
| SA Spurs -1.5 | -1.0 | lost |
| San Antonio Spurs -6.0 | -7.0 | won |
| Oklahoma City Thunder 6.0 | -7.0 | lost |
| San Antonio Spurs -5.5 | -7.0 | won |
| SA Spurs -3.5 | -4.0 | won |
| Oklahoma City Thunder 5.5 | -7.0 | lost |
| Oklahoma City Thunder -14.5 | -12.0 | lost |
| Phoenix Suns 14.5 | -12.0 | won |
| NY Knicks 3.5 | -4.0 | lost |
| SA Spurs 1.5 | 1.0 | won |
| NY Knicks -1.5 | 1.0 | lost |
Hit rate, last 21 days
49.6% of 226 settled point spread legs hit (112 yes, 114no). Counted on the YES side only — books that price this two-way contribute their Over leg, not both. That is the base rate across the whole priced field, not a per-player figure.
Read off 226 YES legs out of 228 settled outcomes on this market. The rest are the Under side from books that price it two-way, which answers a different question.
Per-player hit rates and L5 / L10 / L20 splits live on /trends.
Live response
Captured from the real endpoint on BOS Celtics @ DET Pistons, trimmed to one book and three outcomes so the shape stays readable. The full response carries every book and every line, alternates included, in the same call.
{
"id": "129643",
"sport_key": "basketball_nba",
"home_team": "DET Pistons",
"away_team": "BOS Celtics",
"commence_time": "2026-10-20T19:00:00Z",
"live": false,
"last_update": "2026-08-16T22:38:28.990540Z",
"bookmakers": [
{
"key": "betrivers",
"title": "BetRivers",
"last_update": "2026-08-16T22:38:19.018143Z",
"link": null,
"book_event_id": null,
"markets": [
{
"key": "spreads",
"last_update": "2026-08-16T22:38:19.018143Z",
"period": null,
"suspended_at": null,
"outcomes": [
{
"name": "Detroit Pistons",
"description": "",
"price": -110,
"point": -1.5,
"book_updated_at": null,
"book_version": null,
"payout_multiplier": null,
"dfs_odds_type": null,
"last_change_at": "2026-08-11T15:01:02.204223Z",
"line_gap": null,
"book_outcome_id": null
},
{
"name": "Boston Celtics",
"description": "",
"price": -113,
"point": 1.5,
"book_updated_at": null,
"book_version": null,
"payout_multiplier": null,
"dfs_odds_type": null,
"last_change_at": "2026-08-11T15:01:02.204223Z",
"line_gap": null,
"book_outcome_id": null
}
]
}
]
}
]
}The response shape is the-odds-api compatible — events, bookmakers, markets, outcomes — so migrating is usually a base URL change.
Try it
1. List NBA events to get an event id:
curl "https://api.prop-line.com/v1/sports/basketball_nba/events?apiKey=YOUR_API_KEY"2. Pull point spread for one game across every book — this exact URL works right now:
curl "https://api.prop-line.com/v1/sports/basketball_nba/events/129643/odds?apiKey=YOUR_API_KEY&markets=spreads"3. After the game, get the graded outcomes with the actual stat:
curl "https://api.prop-line.com/v1/sports/basketball_nba/events/129643/results?apiKey=YOUR_API_KEY"Steps 1 and 2 run on the free tier. Step 3 — prop resolution — starts on Hobby at $9/mo. See pricing.
Related endpoints
Other NBA markets
Point Spread in other sports
Get your free NBA odds API key
1,000 requests / day. No credit card. The same key covers every sport and every market — not just this one.
Free tier includes 1,000 requests/day. Upgrade anytime.