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.

11
books quoting it on the next event
7/12
of the next NBA events carry it right now
3,614
outcomes settled in the last 4 days

Every number on this page is measured against the live API, never copied from a spec sheet. Last measured 6 October 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.

CourtsideFanaticsHard Rock BetHeritage SportsJazz SportsNovig1xBetPolymarketProphetXThrillzzYouWager

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.

3,614 point spread outcomes settled in the last 4 days across 12 books. The 12 most recent:

BetActualResult
Los Angeles Lakers -5.0-24.0won
Sacramento Kings 5.0-24.0lost
Los Angeles Lakers -3.5-24.0won
Sacramento Kings 3.5-24.0lost
Los Angeles Lakers -3.5-24.0won
Sacramento Kings 3.5-24.0lost
Los Angeles Lakers -4.5-24.0won
Sacramento Kings 4.5-24.0lost
Los Angeles Lakers -10.5-24.0won
Sacramento Kings 10.5-24.0lost
Los Angeles Lakers -2.5-24.0won
Sacramento Kings 2.5-24.0lost

Hit rate, last 4 days

49.8% of 3602 settled point spread legs hit (1794 yes, 1808 no). 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 3,602 YES legs out of 3,614 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 Brooklyn Nets @ Charlotte Hornets, 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.

{
  "home_team_key": "hornets",
  "away_team_key": "nets",
  "home_team_id": "nba:1610612766",
  "away_team_id": "nba:1610612751",
  "home_team_logo_url": "https://cdn.nba.com/logos/nba/1610612766/primary/L/logo.svg",
  "away_team_logo_url": "https://cdn.nba.com/logos/nba/1610612751/primary/L/logo.svg",
  "id": "317333",
  "sport_key": "basketball_nba",
  "home_team": "Charlotte Hornets",
  "away_team": "Brooklyn Nets",
  "commence_time": "2026-10-06T23:00:00Z",
  "live": false,
  "is_outright": false,
  "tournament": null,
  "tour": null,
  "last_update": "2026-10-06T16:08:07.377087Z",
  "merged_from_event_ids": null,
  "bookmakers": [
    {
      "key": "courtside",
      "title": "Courtside",
      "last_update": "2026-10-06T16:06:49.806806Z",
      "link": null,
      "app_link": null,
      "pregame_only": false,
      "book_event_id": null,
      "markets": [
        {
          "key": "spreads",
          "description": "Point Spread -4.5",
          "last_update": "2026-10-06T16:06:49.806806Z",
          "period": null,
          "suspended_at": null,
          "team": null,
          "line_type": "alternate",
          "outcomes": [
            {
              "name": "Charlotte Hornets",
              "description": "",
              "price": -130,
              "point": -4.5,
              "book_updated_at": null,
              "book_version": null,
              "payout_multiplier": null,
              "dfs_odds_type": null,
              "last_change_at": "2026-10-06T15:19:25.034430Z",
              "last_seen_at": "2026-10-06T16:06:49.806806Z",
              "liquidity": null,
              "liquidity_updated_at": null,
              "line_gap": null,
              "book_outcome_id": null,
              "outcome_id": null,
              "player_id": null,
              "side": "home"
            },
            {
              "name": "Brooklyn Nets",
              "description": "",
              "price": 110,
              "point": 4.5,
              "book_updated_at": null,
              "book_version": null,
              "payout_multiplier": null,
              "dfs_odds_type": null,
              "last_change_at": "2026-10-06T15:19:25.034430Z",
              "last_seen_at": "2026-10-06T16:06:49.806806Z",
              "liquidity": null,
              "liquidity_updated_at": null,
              "line_gap": null,
              "book_outcome_id": null,
              "outcome_id": null,
              "player_id": null,
              "side": "away"
            }
          ]
        }
      ]
    }
  ]
}

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/317333/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/317333/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.

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.