STAT-API

NBA projected_player_stats API

projected_player_statsnba.projected_player_stats
Our 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_stats
Requires one of: game_id or player_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
player_idquerybigintoptional
Filter to a single player.
team_idquerybigintoptional
Filter by team.
projection_idquerybigintoptional
Filter by engine version (one id per version of our NBA engine).
limitqueryintegeroptionaldefault 100
Page size. Defaults to 100; max 5000.
from_idquerybigintoptional
Return 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/json
Response Schema(37 fields)show schema ▸
FieldTypeReferencesDescription
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}
Parameters
idpathbigintrequired
Primary 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 ▸
FieldTypeReferencesDescription
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