NBA projected_player_stats API
projected_player_stats
nba.projected_player_statsOur projection of each NBA player in each game before tip — the chance to play and to start, minutes with their range, usage rate, points, rebounds, assists, steals, blocks, threes and turnovers, the common combos, and double-double and triple-double chances. One current row per game, player and engine version, the same stat line for every DFS operator; it updates until tip and never changes after. GET /api/v1/dfs/slates/{slate_id}/projections serves this stat line for every seat of a DFS slate with its fantasy points, and GET /api/v1/dfs/contests/{contest_id}/projections adds the contest's projected ownership.
GET/api/v1/nba/projected_player_statsList projected_player_stats for NBA
Requires one of:
game_id or player_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
player_idquerybigintoptionalFilter to a single player.
team_idquerybigintoptionalFilter by team.
projection_idquerybigintoptionalFilter by engine version (one id per version of our NBA engine).
limitqueryintegeroptionaldefault 100Page size. Defaults to 100; max 5000.
from_idquerybigintoptionalReturn rows with id strictly greater than this value; page using the previous response's `next_from_id`. Omit on the first page.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
-H 'Authorization: Bearer YOUR_API_KEY' \
'https://api.stat-api.com/api/v1/nba/projected_player_stats?game_id=1'Responses
200projected_player_stats rows matching the declared filter set, wrapped in { projected_player_stats, limit, next_from_id, has_more }. has_more is true when another row follows this page. To walk every row, start with ?from_id=0 and pass each next_from_id back as from_id until it is null; the filters stay. A first page without from_id comes in the default order and gives next_from_id null.application/jsonshow example ▸
400No declared filter set was satisfied — response body matches MissingRequiredFiltersError; pick one combo from the accepted-sets hint and resend.
application/jsonResponse Schema(37 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 6029937 | |
player_id | bigint | — e.g. 221 | |
projection_id | bigint | — | Engine version id (main.projections; STAT_API_NBA 2.2, the NFL engine's version). e.g. 3 |
team_id | bigint | — e.g. 17 | |
ast | float | — | Projected assists (mean). e.g. 0 |
blk | float | — | Projected blocks (mean). e.g. 0 |
double_double_probability | float | — | Chance of a double-double, 0 to 1. e.g. 0 |
expected_starter | booleannullable | — | True when the player was in the expected starting lineup when the projection ran; null when no lineup was known. Values:falsetrue |
fg3m | float | — | Projected three-pointers made (mean). e.g. 0 |
inputs_as_of | timestamptz | — | Time of the newest input the projection used (UTC). Always before the game's tip. e.g. 2026-01-31T00:29:59.999Z |
lineup_confirmed | booleannullable | — | True when that starting lineup was confirmed; null when no lineup was known. e.g. true |
minutes_mean | float | — | Projected minutes (mean). e.g. 0 |
minutes_p10 | float | — | Projected minutes, 10th percentile. e.g. 0 |
minutes_p25 | float | — | Projected minutes, 25th percentile. e.g. 0 |
minutes_p50 | float | — | Projected minutes, median. e.g. 0 |
minutes_p75 | float | — | Projected minutes, 75th percentile. e.g. 0 |
minutes_p90 | float | — | Projected minutes, 90th percentile. e.g. 0 |
minutes_std | float | — | Standard deviation of the projected minutes. e.g. 0 |
play_probability | float | — | Chance the player plays, 0 to 1. e.g. 1 |
position | stringnullable | — | The player's position as the roster service gave it for this game. Values:GFCG-FF-C |
pra | float | — | Projected points + rebounds + assists (mean). e.g. 0 |
pts | float | — | Projected points (mean). e.g. 0 |
pts_ast | float | — | Projected points + assists (mean). e.g. 0 |
pts_reb | float | — | Projected points + rebounds (mean). e.g. 0 |
reb | float | — | Projected rebounds (mean). e.g. 0 |
reb_ast | float | — | Projected rebounds + assists (mean). e.g. 0 |
start_probability | float | — | Chance the player starts, 0 to 1. e.g. 0 |
stat_quantiles | jsonb | — | The 10th percentile, median and 90th percentile of each projected stat, keyed by stat name (pts, reb, ast, stl, blk, fg3m, tov), each an object of p10, p50 and p90. e.g. {"ast":{"p10":0,"p50":0,"p90":0},"blk":{"p10":0,"p50":0,"p9… |
status | stringnullable | — | The player's status for this game when the projection ran, the newest change before tip from any source (the official injury report, the league's inactive list, DraftKings, FanDuel or a media report); null when no source gave one. Values:availableoutquestionableprobable |
status_source | stringnullable | — | Which source gave the status: an operator (draftkings, fanduel), a media report (media), or the league: league_report (the official injury report) or league_inactive_list (the league's inactive list). Values:fandueldraftkingsleague_reportmedia |
stl | float | — | Projected steals (mean). e.g. 0 |
stocks | float | — | Projected steals + blocks (mean). e.g. 0 |
tov | float | — | Projected turnovers (mean). e.g. 0 |
triple_double_probability | float | — | Chance of a triple-double, 0 to 1. e.g. 0 |
usage_rate | float | — | Projected usage rate (USG%) while on the floor — the player's share of the possessions his team uses (field-goal attempts + 0.44 × free-throw attempts + turnovers), scaled to five players on the floor. It sets his share of the team's projected points; 0 when he does not play. e.g. 0 |
zero_reason | stringnullable | — | Why the player projects 0 minutes (ruled out, inactive, not on the roster); null for a player who may play. e.g. out |
GET/api/v1/nba/projected_player_stats/{id}Get a single projected_player_stat by id
Parameters
idpathbigintrequiredPrimary key (id) of the projected_player_stat row.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
-H 'Authorization: Bearer YOUR_API_KEY' \
'https://api.stat-api.com/api/v1/nba/projected_player_stats/{pk_value}'Responses
200Single projected_player_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(37 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 6029937 | |
player_id | bigint | — e.g. 221 | |
projection_id | bigint | — | Engine version id (main.projections; STAT_API_NBA 2.2, the NFL engine's version). e.g. 3 |
team_id | bigint | — e.g. 17 | |
ast | float | — | Projected assists (mean). e.g. 0 |
blk | float | — | Projected blocks (mean). e.g. 0 |
double_double_probability | float | — | Chance of a double-double, 0 to 1. e.g. 0 |
expected_starter | booleannullable | — | True when the player was in the expected starting lineup when the projection ran; null when no lineup was known. Values:falsetrue |
fg3m | float | — | Projected three-pointers made (mean). e.g. 0 |
inputs_as_of | timestamptz | — | Time of the newest input the projection used (UTC). Always before the game's tip. e.g. 2026-01-31T00:29:59.999Z |
lineup_confirmed | booleannullable | — | True when that starting lineup was confirmed; null when no lineup was known. e.g. true |
minutes_mean | float | — | Projected minutes (mean). e.g. 0 |
minutes_p10 | float | — | Projected minutes, 10th percentile. e.g. 0 |
minutes_p25 | float | — | Projected minutes, 25th percentile. e.g. 0 |
minutes_p50 | float | — | Projected minutes, median. e.g. 0 |
minutes_p75 | float | — | Projected minutes, 75th percentile. e.g. 0 |
minutes_p90 | float | — | Projected minutes, 90th percentile. e.g. 0 |
minutes_std | float | — | Standard deviation of the projected minutes. e.g. 0 |
play_probability | float | — | Chance the player plays, 0 to 1. e.g. 1 |
position | stringnullable | — | The player's position as the roster service gave it for this game. Values:GFCG-FF-C |
pra | float | — | Projected points + rebounds + assists (mean). e.g. 0 |
pts | float | — | Projected points (mean). e.g. 0 |
pts_ast | float | — | Projected points + assists (mean). e.g. 0 |
pts_reb | float | — | Projected points + rebounds (mean). e.g. 0 |
reb | float | — | Projected rebounds (mean). e.g. 0 |
reb_ast | float | — | Projected rebounds + assists (mean). e.g. 0 |
start_probability | float | — | Chance the player starts, 0 to 1. e.g. 0 |
stat_quantiles | jsonb | — | The 10th percentile, median and 90th percentile of each projected stat, keyed by stat name (pts, reb, ast, stl, blk, fg3m, tov), each an object of p10, p50 and p90. e.g. {"ast":{"p10":0,"p50":0,"p90":0},"blk":{"p10":0,"p50":0,"p9… |
status | stringnullable | — | The player's status for this game when the projection ran, the newest change before tip from any source (the official injury report, the league's inactive list, DraftKings, FanDuel or a media report); null when no source gave one. Values:availableoutquestionableprobable |
status_source | stringnullable | — | Which source gave the status: an operator (draftkings, fanduel), a media report (media), or the league: league_report (the official injury report) or league_inactive_list (the league's inactive list). Values:fandueldraftkingsleague_reportmedia |
stl | float | — | Projected steals (mean). e.g. 0 |
stocks | float | — | Projected steals + blocks (mean). e.g. 0 |
tov | float | — | Projected turnovers (mean). e.g. 0 |
triple_double_probability | float | — | Chance of a triple-double, 0 to 1. e.g. 0 |
usage_rate | float | — | Projected usage rate (USG%) while on the floor — the player's share of the possessions his team uses (field-goal attempts + 0.44 × free-throw attempts + turnovers), scaled to five players on the floor. It sets his share of the team's projected points; 0 when he does not play. e.g. 0 |
zero_reason | stringnullable | — | Why the player projects 0 minutes (ruled out, inactive, not on the roster); null for a player who may play. e.g. out |