---
title: "NBA player prop hit-rate + current line across books"
method: GET
path: "/v1/nba/players/{id}/props"
tags: ["nerd"]
---

# NBA player prop hit-rate + current line across books

`GET /v1/nba/players/{id}/props`

## Request

- Base URL: `https://api.bigballsdata.com`
- URL: `https://api.bigballsdata.com/v1/nba/players/{id}/props`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

**Requires the Edge plan or higher.** Player props are part of the
odds and model layer; Free, Solo and Trio are refused with `403
forbidden`. Moved to Edge on 2026-09-25; previously free.

For one market (points/rebounds/assists/points_rebounds_assists/threes),
returns the current line picked by tightest juice plus rolling-last-N
hit rate from nba_player_box_scores. 60s cache. current_line null when
no nba_player_props row exists; hit_rate null when no box-score history.
Legacy alias: `GET /v1/nerd/nba/players/{id}/props` (sunset 2026-09-01).

## Path parameters

- `id` string, uuid, required

## Query parameters

- `market` 'points' | 'rebounds' | 'assists' | 'points_rebounds_assists' | 'threes', required
- `lookback` integer
- `book` string: Sportsbook short-name (e.g. betrivers). Omit for tightest-juice pick.
- `view` 'nerd'

## Response `200`

ok

- object

## Other responses

- `400`: invalid query or player_id
- `403`: plan_required (Edge or higher)
- `404`: player not found

---

[API](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api.md) · [All operations](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api/revisions/31fb54ac414e?raw)