---
title: "Get the league's best NBA Fantasy players for the rest of the Gameweek"
method: GET
path: "/v1/fantasy/nba/leaders"
tags: ["fantasy"]
---

# Get the league's best NBA Fantasy players for the rest of the Gameweek

`GET /v1/fantasy/nba/leaders`

## 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/fantasy/nba/leaders`
- Auth: none declared

League-wide ranking for the NBA Salary Cap game: the players with the most projected fantasy points over the games they have LEFT in the current Gameweek, backcourt and frontcourt ranked apart. A player with four games left can outrank a better one with two, which is the point of a Gameweek view. The window runs from today (US Eastern) to the end of the Gameweek, read from the official calendar when we hold it (`gameweek.source`). A weekly number is a sum of per-game expectations and carries no distribution and no availability. Early in the season some games are projected by an early-season prior instead of the model's own rows: each player says so in `prior` and `basis` says so for the whole read. An empty ranking is the normal state when no batch covers the window, not an outage. This read touches no owner state and needs no saved squad. The NBA fantasy workspace is a public beta. When the operator narrows it to a private trial, this endpoint answers 403 for an account outside it.

## Query parameters

- `season` string, nullable: NBA season, e.g. 2027. Omitted = the current season.
- `per_court` integer: Players to return for each court.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- NBAFantasyLeadersResponse
  - `sport` 'nba'
  - `season` string, required
  - `as_of` string, nullable: Day of the projection batch read, US date.
  - `per_court` integer, required
  - `gameweek` NBAFantasyGameweek, required
    - `source` 'official' | 'iso_week_approximation', required: Where the Gameweek boundary came from. 'official' is a hand-entered calendar of the game's own Gameweeks. 'iso_week_approximation' is the ISO week (Monday to Sunday) of the slate day in US Eastern, which is an approximation of the boundary and NOT an official Gameweek.
    - `gameweek` integer, nullable: Official Gameweek number, null under the approximation.
    - `label` string, nullable
    - `start` string, nullable
    - `end` string, nullable: Last day of the window, the day the chip expires.
    - `last_gameday` string, nullable
    - `key` string, nullable
  - `window` NBAFantasyLeadersWindow, required
    - `start` string, required
    - `end` string, nullable
  - `basis` 'model' | 'prior' | 'mixed', nullable: 'model' when every game in the window is projected by the model, 'prior' when every one comes from the early-season prior, 'mixed' otherwise, null when the window holds no game.
  - `courts` NBAFantasyLeaderCourts, required
    - `BC` NBAFantasyLeader[], required: Backcourt, best first.
      - `rank` integer, required
      - `player_name` string, required
      - `team` string, nullable
      - `games` integer, required: Games he has left in the window.
      - `days` string[], required: The American dates of those games.
      - `expected` number, required: Projected NBA Salary Cap fantasy points over those games: a sum of per-game expectations, no band, no probability.
      - `per_game` number, required
      - `prior` boolean, required: True when at least one of his games is projected by the early-season prior rather than the model's own rows.
    - `FC` NBAFantasyLeader[], required: Frontcourt, best first.
      - `rank` integer, required
      - `player_name` string, required
      - `team` string, nullable
      - `games` integer, required: Games he has left in the window.
      - `days` string[], required: The American dates of those games.
      - `expected` number, required: Projected NBA Salary Cap fantasy points over those games: a sum of per-game expectations, no band, no probability.
      - `per_game` number, required
      - `prior` boolean, required: True when at least one of his games is projected by the early-season prior rather than the model's own rows.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/predixsport/apis/predixsport-api.md) · [All operations](https://skmtc.dev/predixsport/apis/predixsport-api/llms.txt) · [OpenAPI document](https://skmtc.dev/predixsport/apis/predixsport-api/revisions/02014aee733d?raw)