Docs / Stats & data

NBA Player Props API

Live/nba-api

Player prop markets for the NBA, keyed by player id: points, rebounds, assists and the rest, in the same odds envelope used across every sport and book on the API.

Coverage

Live for the NBA: player prop markets (points, rebounds, assists, and more) alongside the full basketball odds surface. Prices are served in each book’s native format (American or decimal), so normalize before comparing lines across books.

Endpoints

/v1/players

Find the player and their id before requesting props.

curl "https://api.bigballsdata.com/v1/players?sport=basketball&league=nba&name=luka" \
  -H "Authorization: Bearer $BBS_API_KEY"
/v1/nba/players/{id}/props

Current prop markets and lines for one player.

curl "https://api.bigballsdata.com/v1/nba/players/{player_id}/props" \
  -H "Authorization: Bearer $BBS_API_KEY"

Example response

Illustrative shape of the unified envelope. Values are examples; live fields come from the call above.

{
  "data": {
    "player_id": "…",
    "props": [
      { "market": "points", "line": 27.5, "over": "…", "under": "…", "book": "…" },
      { "market": "assists", "line": 8.5, "over": "…", "under": "…", "book": "…" }
    ]
  },
  "meta": { "source": "…", "request_id": "…" }
}

What you can build

Props dashboard

Render live prop lines per player with over/under toggles.

Line-shopping tool

Compare the same prop across books to surface the best number.

Alerting bot

Notify when a line for a watched player crosses a threshold.

FAQ

What markets are covered?
Core NBA player props — points, rebounds, assists and related markets. The exact set per player depends on what books are posting for the upcoming slate.
What format are the prices in?
Prices are stored in each book’s native format — American (e.g. -110) or decimal (e.g. 1.91) depending on the book. Normalize to one format before comparing lines across books; don’t assume a single format.

Start pulling NBA Player Props

Free tier: 1,000 requests/day (2,000 with GitHub), no credit card.

Get an API key