predictions

NBA per-player projections for games later in the week

Lineup-free NBA player projections for scheduled games that have not been played, the look-ahead companion to the per-match endpoint. The same models run without a published starting five, so projection_mode is always calendar and started is always null.

AN EMPTY LIST IS THE NORMAL STATE, not an outage. NBA predictions are gated on the expected starting five, so the per-match surface exists only on game day, and this one exists only once the rest-of-week mode has run for the current batch.

TWO VIEWS OF THE SAME BATCH. players is one row per player per scheduled game. totals is one row per player for the WHOLE window, best first: games scheduled, the days they fall on, the projected points over the week and, with a preset, that league's projected score for the week and the same number per game. totals is what a week planner reads, and it is built over every row that matches the filters rather than over the limit page of players. Pass include_rows=false to get it on its own.

THE WEEK IS AN EXPECTATION AND NOTHING ELSE. A weekly number is the sum of the per-game expectations, exact for the mean by linearity, but a sum of dependent counts is not the convolution of the marginals, so no band, no distribution and no probability is published for it. There is no availability field here either, by design: days ahead of a game no lineup exists.

Use it to plan which players to pick up for the days ahead, then call the per-match endpoint on game day for the projection that knows the published five.

get/v1/predictions/nba/players/week

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/players/week
  • Auth: none declared

Query parameters

playerstring nullable

Exact stored player name, e.g. 'Nikola Jokic'.

namesstring nullable

A whole roster at once: player names separated by commas, semicolons or newlines. Matching ignores case and accents (doncic finds Luka Dončić) and accepts a surname on its own or a surname with a first-name prefix (L. James). A name that matches nobody, or more than one player, is NOT guessed at: it comes back in unresolved_names while the rest are resolved. Use it instead of one request per player.

teamstring nullable

Exact stored franchise name, e.g. 'Denver Nuggets'.

courtstring nullable

Half of the floor: BC backcourt (guards) or FC frontcourt (forwards and centres). Formats that require a backcourt / frontcourt split filter on it.

limitinteger

Maximum rows in players AND maximum players in totals, applied to each independently.

include_rowsboolean

Set false to omit the per-game players array and receive the per-player totals alone, which is the smaller answer and the one a week planner needs.

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

Fantasy scoring system to score each row under, exactly as on the per-match endpoint. It also fills expectation in totals: without it a total carries the games, the days and the projected points only.

Headers

authorizationstring nullable

Response

Successful Response

as_ofstring nullable

The projection batch these rows come from, as YYYYMMDD. Null when no rows exist yet.

countinteger required
datesstring[]

Every day covered by the batch, ascending.

resolved_namesstring[]

Stored names the names parameter matched, in the order they were written. Empty when the parameter was not used.

unresolved_namesstring[]

Entries of names that matched no player, or matched more than one and were therefore not guessed at. Echoed back so a pasted roster can be corrected rather than silently short.

Changes

No recorded changes to this operation across all 2 revisions of this API.