predictions

NBA per-player projections for a single match

Returns the same players array embedded in the NBA match-detail payload, exposed as a standalone endpoint for callers that only need the player layer (e.g. fantasy-app builders).

ROW SET: the projected ROSTER of each team, around 19 names a side, not the expected starting five. Twelve stats are projected for each of them (points, rebounds, assists, three-pointers made, steals, blocks, turnovers, field goals made and attempted, free throws made and attempted, NBA Salary Cap points), each with an expectation and a full discrete distribution. Every field beyond the original four heads is nullable and simply absent for a match predicted before the full-roster rollout.

HOW TO READ THEM: all twelve models beat a naive rolling average on the distribution. Five (points, rebounds, field goals made, field goals attempted, NBA Salary Cap points) also beat it on single-number error and are safe as point estimates. For the other seven, prefer the distribution or a quantile band over the expectation alone.

AVAILABILITY: started and projection_mode describe the published lineup of the day and nothing else. There is no probability that a player features and no injury data anywhere in this response, by design.

preset adds a fantasy object per player with that scoring system's projected score.

get/v1/predictions/nba/{match_id}/players

Request

Base URL: https://api.predixsport.com (the document declares no server; this is the origin it was published from)
URL: https://api.predixsport.com/v1/predictions/nba/{match_id}/players
Auth: none declared

Path parameters

match_idstring required

Query parameters

preset'espn_points' | 'yahoo_9cat' | 'sleeper_points' | 'nba_salary_cap'

Fantasy scoring system to score each player under. espn_points (PTS 1, 3PM 1, FGM 2, FGA -1, FTM 1, FTA -1, REB 1, AST 2, STL 4, BLK 4, TOV -2), sleeper_points (PTS 1, REB 1.2, AST 1.5, STL 3, BLK 3, TOV -1), nba_salary_cap (PTS 1, REB 1, AST 2, BLK 3, STL 3) or yahoo_9cat, which is a per-category league and therefore returns the nine category values instead of a single score. nba_salary_cap is scored by a model trained on that total itself, so it carries quantiles and a formula_expectation cross-check beside the served expectation. Every other points preset is the formula applied to the component projections, which is exact for the average, and carries no quantiles. expectation_source says which reading you got. Omit the parameter and the response is unchanged.

Headers

authorizationstring nullable

Response

Successful Response

namestring required

teamstring required

is_homeboolean required

positioninteger nullable

Rank slot inside the published starting five, 1 to 5, and 0 for a roster player outside it or for a projection made with no published lineup. It is NOT a listed basketball position: read listed_position and court for that.

expected_pointsnumber nullable

expected_reboundsnumber nullable

expected_assistsnumber nullable

expected_three_pointers_madenumber nullable

Expected three-pointers made.

points_distributionobject nullable

rebounds_distributionobject nullable

assists_distributionobject nullable

three_pointers_made_distributionobject nullable

expected_stealsnumber nullable

steals_distributionobject nullable

expected_blocksnumber nullable

blocks_distributionobject nullable

expected_turnoversnumber nullable

turnovers_distributionobject nullable

expected_field_goals_madenumber nullable

field_goals_made_distributionobject nullable

expected_field_goals_attemptednumber nullable

field_goals_attempted_distributionobject nullable

expected_free_throws_madenumber nullable

free_throws_made_distributionobject nullable

expected_free_throws_attemptednumber nullable

free_throws_attempted_distributionobject nullable

expected_nba_salary_cap_pointsnumber nullable

Expected NBA Salary Cap fantasy score (points + rebounds + 2 x assists + 3 x blocks + 3 x steals) from a model trained on that total directly, not from summing the component models. It is the only projected total with a distribution of its own.

nba_salary_cap_points_distributionobject nullable

startedboolean nullable

True when the player is in the team's published starting five for this game, false when a lineup was published and he is not in it, null when no lineup had been published at projection time. Null is a real state here, not a missing value. This is the published lineup and nothing more: it is not a chance of playing and carries no injury information.

projection_modestring nullable

gameday (a lineup was published), gameday_no_lineup (the whole roster projected without one) or calendar (a lineup-free projection for a game later in the week). Null for rows written before the full-roster rollout.

row_sourcestring nullable

Where the roster row came from: box_score, roster_union or published_lineup.

low_confidenceboolean nullable

True when this row rests on a thin recent record, typically a roster player with no recent appearance. The row is published flagged rather than dropped.

listed_positionstring nullable

Listed basketball position, e.g. PG, SG, SF, PF, C, G-F.

courtstring nullable

BC for backcourt or FC for frontcourt, derived from the first token of listed_position. Fantasy formats that require a backcourt and frontcourt split use it.