DFS slates API
dfs.slatesGET/api/v1/dfs/slatesList slates for DFS
sport or league or operator_id + date or operator + date or operator_slate_id or external_id — requests satisfying none of these return 400.operator_idquerybigintoptionaloperatorquerystringoptionaldatequerydateoptionalleaguequerystringoptionalsportquerystringoptionalexternal_idquerybigintoptionaloperator_slate_idquerybigintoptionalstatusquerystringoptionallimitqueryintegeroptionaldefault 100from_idquerybigintoptionalcurl -sS --compressed \
-H 'Authorization: Bearer YOUR_API_KEY' \
'https://api.stat-api.com/api/v1/dfs/slates?date=2026-11-15&operator_id=1'200slates rows matching the declared filter set, wrapped in { slates, 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 ▸
application/jsonResponse Schema(19 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
external_id | bigint | — | Operator-side slate identifier (e.g., DraftKings contest group ID). e.g. 16775 |
league_id | bigint | — | FK to the league this slate belongs to. e.g. 2 |
operator_id | bigint | FK to the DFS operator (DraftKings, FanDuel, Yahoo, etc.). e.g. 2 | |
operator_setting_id | stringnullable | — | The operator's own id for the lineup setting this slate is played under — FanDuel states it as slateFormatId, DraftKings as lineupConfigurationId. Matches dfs.slate_settings.operator_setting_id. Text, because some stored values are not numbers (deprecated-5399). Never a key on its own: the operators reuse these ids across sports and versions, so resolution is (operator, league, this id) then the newest valid_from not after the slate date. e.g. 25 |
slate_setting_id | bigint | FK to slate_settings — the scoring format and roster constraints for this slate. e.g. 23 | |
complete_file_count | integer | — | Number of contests on this slate with their full data (the contests' complete_file): the lineup file holds every entry and every seat. 0 when none does, or when no file of the slate is counted yet. e.g. — (all-null in sample) |
contest_count | integer | — | Number of contests on this slate (rows in dfs.contests). Counts lobby-only contests too, which never have lineups. e.g. — (all-null in sample) |
date | date | — | Calendar day of the slate in US Eastern time (DB-generated from start_time — read-only). e.g. 2026-02-24 |
game_count | integer | — | Number of games in the slate pool (distinct games in dfs.slate_games). 0 when the slate has no linked games. e.g. — (all-null in sample) |
game_type | stringnullable | — | Roster format of the slate, from its slate setting: classic (full roster), showdown (DraftKings Showdown Captain Mode — CPT at 1.5x salary and points), single_game (FanDuel Single Game — MVP at 1.5x points, no salary change), or tiers. Null when the setting states another format. e.g. — (all-null in sample) |
lineup_contest_count | integer | — | Number of contests on this slate with their lineups loaded (dfs.contests.lineups_status = available). 0 when no contest of the slate has a lineup file. e.g. — (all-null in sample) |
main | boolean | — | Whether this is the featured ("main") slate for this operator/league/day — at most one per (operator, league, date). Daily for NBA/MLB/NHL, Sundays for NFL, never for golf. Backfilled 2016-2026 on 2026-08-24 (docs/migrations/scripts/2026-08-24-dfs-slates-main-backfill.sql). Rows loaded after that date are not yet auto-flagged. Values:falsetrue |
name | stringnullable | — | Human-readable slate label (e.g., "Sunday Main", "Showdown: TB vs KC"). e.g. Main |
part_of_game | stringnullable | — | The part of each game that the slate scores, from the scoring rule of its slate setting (dfs.slate_settings.scoring): full, or second_half and fourth_quarter for an in-game slate. Null when the setting holds no scoring rule. e.g. — (all-null in sample) |
player_count | integer | — | Number of priced players in the slate pool (rows in dfs.slate_players). e.g. — (all-null in sample) |
start_time | timestamptz | — | Lock time — first scheduled tip/kickoff of any game in the pool. e.g. 2026-02-25T00:00:00.000Z |
state | string | — | Lifecycle state of the slate in the Prelock / Started / Completed vocabulary, derived by the API on every read (browse.rs derive_dfs_lifecycle_state) from `status`: Upcoming → Prelock, Live → Started, Completed → Completed. `status` is the authoritative field; this one repeats it in the older vocabulary. e.g. — (all-null in sample) |
status | string | — | Authoritative slate lifecycle status: Upcoming (pre-lock), Live (in progress), Completed (all games final). e.g. Completed |
GET/api/v1/dfs/slates/{id}Get a single slate by id
idpathbigintrequiredcurl -sS --compressed \
-H 'Authorization: Bearer YOUR_API_KEY' \
'https://api.stat-api.com/api/v1/dfs/slates/1126128'200Single slate row.application/jsonshow example ▸
Response Schema(19 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
external_id | bigint | — | Operator-side slate identifier (e.g., DraftKings contest group ID). e.g. 16775 |
league_id | bigint | — | FK to the league this slate belongs to. e.g. 2 |
operator_id | bigint | FK to the DFS operator (DraftKings, FanDuel, Yahoo, etc.). e.g. 2 | |
operator_setting_id | stringnullable | — | The operator's own id for the lineup setting this slate is played under — FanDuel states it as slateFormatId, DraftKings as lineupConfigurationId. Matches dfs.slate_settings.operator_setting_id. Text, because some stored values are not numbers (deprecated-5399). Never a key on its own: the operators reuse these ids across sports and versions, so resolution is (operator, league, this id) then the newest valid_from not after the slate date. e.g. 25 |
slate_setting_id | bigint | FK to slate_settings — the scoring format and roster constraints for this slate. e.g. 23 | |
complete_file_count | integer | — | Number of contests on this slate with their full data (the contests' complete_file): the lineup file holds every entry and every seat. 0 when none does, or when no file of the slate is counted yet. e.g. — (all-null in sample) |
contest_count | integer | — | Number of contests on this slate (rows in dfs.contests). Counts lobby-only contests too, which never have lineups. e.g. — (all-null in sample) |
date | date | — | Calendar day of the slate in US Eastern time (DB-generated from start_time — read-only). e.g. 2026-02-24 |
game_count | integer | — | Number of games in the slate pool (distinct games in dfs.slate_games). 0 when the slate has no linked games. e.g. — (all-null in sample) |
game_type | stringnullable | — | Roster format of the slate, from its slate setting: classic (full roster), showdown (DraftKings Showdown Captain Mode — CPT at 1.5x salary and points), single_game (FanDuel Single Game — MVP at 1.5x points, no salary change), or tiers. Null when the setting states another format. e.g. — (all-null in sample) |
lineup_contest_count | integer | — | Number of contests on this slate with their lineups loaded (dfs.contests.lineups_status = available). 0 when no contest of the slate has a lineup file. e.g. — (all-null in sample) |
main | boolean | — | Whether this is the featured ("main") slate for this operator/league/day — at most one per (operator, league, date). Daily for NBA/MLB/NHL, Sundays for NFL, never for golf. Backfilled 2016-2026 on 2026-08-24 (docs/migrations/scripts/2026-08-24-dfs-slates-main-backfill.sql). Rows loaded after that date are not yet auto-flagged. Values:falsetrue |
name | stringnullable | — | Human-readable slate label (e.g., "Sunday Main", "Showdown: TB vs KC"). e.g. Main |
part_of_game | stringnullable | — | The part of each game that the slate scores, from the scoring rule of its slate setting (dfs.slate_settings.scoring): full, or second_half and fourth_quarter for an in-game slate. Null when the setting holds no scoring rule. e.g. — (all-null in sample) |
player_count | integer | — | Number of priced players in the slate pool (rows in dfs.slate_players). e.g. — (all-null in sample) |
start_time | timestamptz | — | Lock time — first scheduled tip/kickoff of any game in the pool. e.g. 2026-02-25T00:00:00.000Z |
state | string | — | Lifecycle state of the slate in the Prelock / Started / Completed vocabulary, derived by the API on every read (browse.rs derive_dfs_lifecycle_state) from `status`: Upcoming → Prelock, Live → Started, Completed → Completed. `status` is the authoritative field; this one repeats it in the older vocabulary. e.g. — (all-null in sample) |
status | string | — | Authoritative slate lifecycle status: Upcoming (pre-lock), Live (in progress), Completed (all games final). e.g. Completed |
GET/api/v1/dfs/slates/{slate_id}/contest-ownershipProjected captain and FLEX ownership by contest, the biggest prize pool first (lobby), and by contest group
slate_idpathbigintrequiredmodequerystringoptionaldefault percentagecontestquerybigintoptionalcomparequerybigintoptionalformatquerystringoptionaldefault jsoncsvquerystringoptionaldefault groupscurl -sS --compressed \
-H 'Authorization: Bearer YOUR_API_KEY' \
'https://api.stat-api.com/api/v1/dfs/slates/1126128/contest-ownership'200Projected captain and FLEX ownership by contest, the biggest prize pool first (lobby), and by contest groupapplication/jsonshow example ▸
Response Schema(16 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
slate | object | — | The slate. |
↳id slate.id | bigint | — | dfs.slates id. |
↳external_id slate.external_id | bigint | — | Operator slate ID (DraftKings draft group, FanDuel fixture list). |
↳operator slate.operator | string | — | DraftKings or FanDuel. |
↳name slate.name | stringnullable | — | Slate name. |
↳game_type slate.game_type | stringnullable | — | The slate setting's format, as on /dfs/slates. Values:classicshowdownsingle_gametiers |
↳in_game slate.in_game | boolean | — | True for an in-game format (DraftKings In-Game Showdown, FanDuel 2nd half or 4th quarter). In-game formats have no projections by design. |
↳start_time slate.start_time | stringnullable | — | Lock time (ISO 8601, UTC). |
↳status slate.status | stringnullable | — | Upcoming, Live or Completed. |
↳captain_slot slate.captain_slot | stringnullable | — | The captain slot word of the format (CPT on DraftKings, MVP on FanDuel). Null on a format without one. |
↳flex_seats slate.flex_seats | bigintnullable | — | Roster seats that are not the captain seat, from the slate setting (5 on DraftKings Showdown and on FanDuel single game since 2025). The FLEX ownership of one contest sums to 100 x flex_seats percent. |
↳games slate.games | list | — | The slate's games. |
↳game_id slate.games[].game_id | bigint | — | nfl.games id. |
↳away slate.games[].away | stringnullable | — | Away team abbreviation. |
↳home slate.games[].home | stringnullable | — | Home team abbreviation. |
↳kickoff slate.games[].kickoff | stringnullable | — | Kickoff (ISO 8601, UTC). |
source | string | — | The projection source of every value (always STAT_API_LATEST). Values:STAT_API_LATEST |
model | stringnullable | — | The learned model label of the served rows (`stats.ownership_model`, e.g. single_hgb@19d12bd6d309). Null when no rows are served. |
as_of | stringnullable | — | The newest write time of the served rows (ISO 8601, UTC). Null when no rows are served. |
reason | stringnullable | — | Why `contests` and `groups` are empty (an in-game format, no STAT_API_LATEST source for the format, no learned rows yet, or a slate of another league than NFL, which this board does not serve). Null when contests are served. |
access | object | — | What this caller sees. |
↳plan access.plan | string | — | pro (every contest and player), primetime (every contest and player for every caller, on a TNF or MNF game's single-game slate), featured (the free contests with the 5 featured players, on a pre-game single-game slate) or preview (the free contests with 5 players). Values:proprimetimefeaturedpreview |
↳players_total access.players_total | bigint | — | Players on the board. |
↳players_shown access.players_shown | bigint | — | Players in `players`. |
default_contest | bigintnullable | — | The contest the tool opens on (Frank 2026-10-01): the biggest prize pool, the first of `contests`. Null without a contest. |
default_compare | bigintnullable | — | The contest each value compares with (Frank 2026-10-01): the biggest cash game (contest_type 1), by prize pool, then max_entries, then id. Null when the slate has no cash contest. |
contests | list | — | The lobby, the biggest prize pool first, then the largest max_entries, then the lowest id. With DFS access every contest of the slate with learned rows (no qualifier, no cancelled contest). Without it only the free contests: the 5 biggest prize pools of the slate, in the same order. The page filters them All, Cash or GPP and shows 5 of each with DFS access. |
↳id contests[].id | bigint | — | dfs.contests id (the `contest` and `compare` parameter). |
↳external_id contests[].external_id | bigint | — | Operator contest ID. |
↳name contests[].name | string | — | Contest name. |
↳prize_pool contests[].prize_pool | decimal | — | Prize pool, in dollars. |
↳entry_fee contests[].entry_fee | decimal | — | Entry fee, in dollars. |
↳entries contests[].entries | bigint | — | Entries (entry_count) when last read. |
↳max_entries contests[].max_entries | bigint | — | Maximum entries. |
↳max_entries_per_user contests[].max_entries_per_user | bigint | — | Maximum entries per user. |
↳kind contests[].kind | string | — | cash (contest_type 1) or gpp, the same rule as the groups. Values:cashgpp |
↳entry_type contests[].entry_type | stringnullable | — | GPP only: single_entry (max_entries_per_user 1) or multi_entry. Null for cash. Values:single_entrymulti_entry |
↳tier contests[].tier | string | — | Size tier by max_entries (the tiers of the groups). Values:23-100101-1k1k-10k10k-100k100k+ |
↳group contests[].group | string | — | The key of the contest's group in `groups`. |
↳prize_rank contests[].prize_rank | bigint | — | The contest's place among every contest of the slate (1 = the biggest prize pool). A caller without DFS access sees the ranks of the free contests, 1-5 always among them. |
↳same_terms contests[].same_terms | bigint | — | How many other contests of the slate share the model's contest terms (archetype, max_entries, entry fee, max entries per user), so the same values. |
↳open contests[].open | boolean | — | True when this caller may see the contest's values. Always true, since a caller without DFS access gets only the free contests. |
contest | objectnullable | — | The values of the selected contest (`?contest=`, default `default_contest`). Null without a contest. |
↳id contest.id | bigint | — | dfs.contests id. |
↳locked contest.locked | boolean | — | True when this caller may not see the contest's values. A locked contest sends no player and no position total. |
↳reason contest.reason | stringnullable | — | Why the contest is locked, and the plan that opens it. Null when it is open. |
↳players contest.players | list | — | The shown players (all with DFS access, else the 5 featured players or the 5-row preview) with a value in the contest, the highest total first. Empty when locked. |
↳player_id contest.players[].player_id | bigintnullable | — | nfl.players id (the `player_id` of `players`). |
↳captain_pct contest.players[].captain_pct | decimalnullable | — | Captain ownership in the contest, in percent (the stored projected_ownership of the captain row x 100). |
↳flex_pct contest.players[].flex_pct | decimalnullable | — | FLEX ownership in the contest, in percent. |
↳seats contest.players[].seats | list | — | On a slate with boost seats (FanDuel's old single game: MVP 2x, STAR 1.5x, PRO 1.2x and FLEX), one entry per seat. Empty on any other slate. |
↳seat contest.players[].seats[].seat | string | — | The seat (MVP, STAR, PRO or FLEX). |
↳pct contest.players[].seats[].pct | decimalnullable | — | The seat's share, in percent. Null when the player has no row for the seat. |
↳total_pct contest.players[].total_pct | decimalnullable | — | captain_pct + flex_pct, plus the STAR and PRO seats on a slate with boost seats (the sum of `seats`). |
↳captain_rate contest.players[].captain_rate | decimalnullable | — | captain_pct / total_pct (0-1). Null when the total is 0 or a value is missing. |
↳captain_rank contest.players[].captain_rank | bigintnullable | — | Rank of the captain ownership among all players of the contest (1 = most owned; ties share a rank). |
↳flex_rank contest.players[].flex_rank | bigintnullable | — | Rank of the FLEX ownership among all players of the contest. |
↳actual_captain_pct contest.players[].actual_captain_pct | decimalnullable | — | After the contest is final: the field's actual captain (CPT or MVP) ownership of the player in this contest, in percent (GET /api/v1/dfs/contests/{contest_id}/ownership x 100; 0 when no lineup used the seat). Null on a classic contest, and while `actual_status` is not `served`. |
↳actual_flex_pct contest.players[].actual_flex_pct | decimalnullable | — | After the contest is final: the field's actual FLEX ownership in percent; on a classic contest the player's one actual ownership. Null while `actual_status` is not `served`. |
↳actual_total_pct contest.players[].actual_total_pct | decimalnullable | — | After the contest is final: the field's actual ownership of the player in any seat, in percent. Null while `actual_status` is not `served`. |
↳position_totals contest.position_totals | object | — | The contest's ownership summed by real position over every player of the contest (also the players not shown), in percent. Captain sums to about 100, FLEX to about 100 x flex_seats. Both maps are empty when locked. |
↳captain contest.position_totals.captain | object | — | Real position (QB, RB, WR, TE, K, DST, D) to the sum of its captain ownership. |
↳flex contest.position_totals.flex | object | — | Real position to the sum of its FLEX ownership. |
↳seats contest.position_totals.seats | object | — | On a slate with boost seats: seat (MVP, STAR, PRO, FLEX) to real position to the sum of its share. Empty on any other slate. |
↳actual_status contest.actual_status | stringnullable | — | The contest's actual ownership: `served` when its players carry it; `pro_required` when the caller has no DFS access and the contest is not a marquee contest (GET /api/v1/dfs/marquee: only a marquee contest's actual ownership is free; DFS access opens every contest); else the reason of GET /api/v1/dfs/contests/{contest_id}/ownership (`contest_not_final`, `league_not_computed`, `no_lineups`, `lineups_expired`, `actuals_not_recomputed`). Null before the slate is final, and on a locked contest. |
compare | objectnullable | — | The values of the compare contest (`?compare=`, default `default_compare`), the same shape as `contest`. Null when the slate has no cash contest and none is asked. |
↳id compare.id | bigint | — | dfs.contests id. |
↳locked compare.locked | boolean | — | True when this caller may not see the contest's values. A locked contest sends no player and no position total. |
↳reason compare.reason | stringnullable | — | Why the contest is locked, and the plan that opens it. Null when it is open. |
↳players compare.players | list | — | The shown players (all with DFS access, else the 5 featured players or the 5-row preview) with a value in the contest, the highest total first. Empty when locked. |
↳player_id compare.players[].player_id | bigintnullable | — | nfl.players id (the `player_id` of `players`). |
↳captain_pct compare.players[].captain_pct | decimalnullable | — | Captain ownership in the contest, in percent (the stored projected_ownership of the captain row x 100). |
↳flex_pct compare.players[].flex_pct | decimalnullable | — | FLEX ownership in the contest, in percent. |
↳seats compare.players[].seats | list | — | On a slate with boost seats (FanDuel's old single game: MVP 2x, STAR 1.5x, PRO 1.2x and FLEX), one entry per seat. Empty on any other slate. |
↳seat compare.players[].seats[].seat | string | — | The seat (MVP, STAR, PRO or FLEX). |
↳pct compare.players[].seats[].pct | decimalnullable | — | The seat's share, in percent. Null when the player has no row for the seat. |
↳total_pct compare.players[].total_pct | decimalnullable | — | captain_pct + flex_pct, plus the STAR and PRO seats on a slate with boost seats (the sum of `seats`). |
↳captain_rate compare.players[].captain_rate | decimalnullable | — | captain_pct / total_pct (0-1). Null when the total is 0 or a value is missing. |
↳captain_rank compare.players[].captain_rank | bigintnullable | — | Rank of the captain ownership among all players of the contest (1 = most owned; ties share a rank). |
↳flex_rank compare.players[].flex_rank | bigintnullable | — | Rank of the FLEX ownership among all players of the contest. |
↳actual_captain_pct compare.players[].actual_captain_pct | decimalnullable | — | After the contest is final: the field's actual captain (CPT or MVP) ownership of the player in this contest, in percent (GET /api/v1/dfs/contests/{contest_id}/ownership x 100; 0 when no lineup used the seat). Null on a classic contest, and while `actual_status` is not `served`. |
↳actual_flex_pct compare.players[].actual_flex_pct | decimalnullable | — | After the contest is final: the field's actual FLEX ownership in percent; on a classic contest the player's one actual ownership. Null while `actual_status` is not `served`. |
↳actual_total_pct compare.players[].actual_total_pct | decimalnullable | — | After the contest is final: the field's actual ownership of the player in any seat, in percent. Null while `actual_status` is not `served`. |
↳position_totals compare.position_totals | object | — | The contest's ownership summed by real position over every player of the contest (also the players not shown), in percent. Captain sums to about 100, FLEX to about 100 x flex_seats. Both maps are empty when locked. |
↳captain compare.position_totals.captain | object | — | Real position (QB, RB, WR, TE, K, DST, D) to the sum of its captain ownership. |
↳flex compare.position_totals.flex | object | — | Real position to the sum of its FLEX ownership. |
↳seats compare.position_totals.seats | object | — | On a slate with boost seats: seat (MVP, STAR, PRO, FLEX) to real position to the sum of its share. Empty on any other slate. |
↳actual_status compare.actual_status | stringnullable | — | The contest's actual ownership: `served` when its players carry it; `pro_required` when the caller has no DFS access and the contest is not a marquee contest (GET /api/v1/dfs/marquee: only a marquee contest's actual ownership is free; DFS access opens every contest); else the reason of GET /api/v1/dfs/contests/{contest_id}/ownership (`contest_not_final`, `league_not_computed`, `no_lineups`, `lineups_expired`, `actuals_not_recomputed`). Null before the slate is final, and on a locked contest. |
across | object | — | The biggest contests side by side (the tool's Across contests tab). |
↳contest_ids across.contest_ids | list<L> | — | The contests in lobby order. With DFS access the 5 biggest GPP contests and the 5 biggest cash games (the page's three filters); without it the free contests, so the ids of `contests`. |
↳values across.values | object | — | Contest id to player id to [captain_pct, flex_pct], for the open contests of `contest_ids` and the shown players with a value. A locked contest is left out. For a final contest whose actual ownership the caller can read (a marquee contest for every caller; every contest with DFS access) the array holds a third value: the player's actual total ownership in percent, 0 for a player in no lineup. Before the contest is final the array holds two values. |
↳seats across.seats | object | — | On a slate with boost seats: contest id to player id to seat (MVP, STAR, PRO, FLEX) to its share, for the same contests and players as `values`. Empty on any other slate. |
default_group | stringnullable | — | The group key the tool opened first before the lobby (Frank 2026-10-01, the largest GPP): the GPP group whose representative contest comes first by the representative order (paid, then the largest max_entries, then entries, prize pool, id). Null without a GPP group. |
groups | list | — | The contest groups, cash first, then single-entry GPP, then multi-entry GPP, each by size tier. DFS access only; empty without it. |
↳key groups[].key | string | — | The group key: kind, entry type (GPP only) and size tier, e.g. cash:3-100, gpp:single_entry:1k-10k, gpp:multi_entry:100k+. |
↳kind groups[].kind | string | — | cash or gpp, as the operator labels the contest (Frank 2026-10-01): contest_type 1 is cash, every other type gpp. A DraftKings Triple Up (contest_type 0) is gpp, although the model's archetype calls it cash. Only a contest without a contest_type falls back to the model's name rule (Double Up, 50/50, H2H, Triple Up). Values:cashgpp |
↳entry_type groups[].entry_type | stringnullable | — | GPP only: single_entry (max_entries_per_user 1) or multi_entry. Null for cash. Values:single_entrymulti_entry |
↳size_tier groups[].size_tier | string | — | Size tier by max_entries. Values:23-100101-1k1k-10k10k-100k100k+ |
↳contest_count groups[].contest_count | bigint | — | Contests of the slate in this group that have learned rows. |
↳contest groups[].contest | object | — | The representative contest, whose stored values the group shows: paid first, then the largest max_entries, then the most entries, then the largest prize pool, then the lowest id. |
↳contest_id groups[].contest.contest_id | bigint | — | dfs.contests id. |
↳external_id groups[].contest.external_id | bigint | — | Operator contest ID. |
↳name groups[].contest.name | string | — | Contest name. |
↳entries groups[].contest.entries | bigint | — | Entries (entry_count) when last read. |
↳max_entries groups[].contest.max_entries | bigint | — | Maximum entries (the model's size feature). |
↳max_entries_per_user groups[].contest.max_entries_per_user | bigint | — | Maximum entries per user. |
↳entry_fee_cents groups[].contest.entry_fee_cents | bigint | — | Entry fee in cents. |
↳prize_pool_cents groups[].contest.prize_pool_cents | bigint | — | Prize pool in cents. |
↳archetype groups[].contest.archetype | string | — | The stored contest_archetype of its rows, else the model's rule. Values:cashgpp_single_entrygpp_small_fieldgpp_mmebaseline |
↳position_totals groups[].position_totals | list | — | The group's ownership summed by real position, captain and FLEX apart, over every player of the representative contest (also the players a preview does not list). Captain sums to about 100, FLEX to about 100 x flex_seats. |
↳position groups[].position_totals[].position | string | — | Real position (QB, RB, WR, TE, K, DST on DraftKings, D on FanDuel). |
↳captain_pct groups[].position_totals[].captain_pct | decimal | — | Sum of the captain ownership, in percent. |
↳flex_pct groups[].position_totals[].flex_pct | decimal | — | Sum of the FLEX ownership, in percent. |
↳seats groups[].position_totals[].seats | list | — | On a slate with boost seats, each seat's sum (MVP, STAR, PRO, FLEX). Empty on any other slate. |
↳seat groups[].position_totals[].seats[].seat | string | — | The seat (MVP, STAR, PRO or FLEX). |
↳pct groups[].position_totals[].seats[].pct | decimalnullable | — | The seat's share, in percent. Null when the player has no row for the seat. |
players | list | — | The players, highest peak total first (all with DFS access, else the 5 featured players or the 5-row preview). The order is the same for every caller, so the first 5 of a Pro answer are the featured players. |
↳player_id players[].player_id | bigintnullable | — | nfl.players id. |
↳name players[].name | stringnullable | — | Player name. |
↳team players[].team | stringnullable | — | Team abbreviation. |
↳position players[].position | stringnullable | — | Real position (QB, RB, WR, TE, K, DST or D). |
↳captain players[].captain | objectnullable | — | The captain (CPT or MVP) slot. Null on a format without one. |
↳slate_player_id players[].captain.slate_player_id | bigint | — | dfs.slate_players id of this slot. |
↳salary players[].captain.salary | integernullable | — | Salary of this slot. |
↳projected_points players[].captain.projected_points | decimalnullable | — | STAT_API_LATEST projected fantasy points of this slot. |
↳points_per_1k players[].captain.points_per_1k | decimalnullable | — | Projected points per $1,000 of salary. |
↳floor players[].captain.floor | decimalnullable | — | The projection's floor for this slot, its 15th percentile (the floor of GET /api/v1/dfs/slates/{slate_id}/projections). |
↳ceiling players[].captain.ceiling | decimalnullable | — | The projection's ceiling for this slot, its 85th percentile (the ceiling of GET /api/v1/dfs/slates/{slate_id}/projections). |
↳flex players[].flex | objectnullable | — | The FLEX slot. |
↳slate_player_id players[].flex.slate_player_id | bigint | — | dfs.slate_players id of this slot. |
↳salary players[].flex.salary | integernullable | — | Salary of this slot. |
↳projected_points players[].flex.projected_points | decimalnullable | — | STAT_API_LATEST projected fantasy points of this slot. |
↳points_per_1k players[].flex.points_per_1k | decimalnullable | — | Projected points per $1,000 of salary. |
↳floor players[].flex.floor | decimalnullable | — | The projection's floor for this slot, its 15th percentile (the floor of GET /api/v1/dfs/slates/{slate_id}/projections). |
↳ceiling players[].flex.ceiling | decimalnullable | — | The projection's ceiling for this slot, its 85th percentile (the ceiling of GET /api/v1/dfs/slates/{slate_id}/projections). |
↳seats players[].seats | list | — | On a slate with boost seats (FanDuel's old single game: MVP 2x, STAR 1.5x, PRO 1.2x and FLEX), the slot of each seat the player holds, in that order: the seat and the fields of a slot (slate_player_id, salary, projected_points, points_per_1k, floor, ceiling). `captain` is the MVP seat and `flex` the FLEX seat. Empty on any other slate. |
↳seat players[].seats[].seat | string | — | The seat (MVP, STAR, PRO or FLEX). |
↳slate_player_id players[].seats[].slate_player_id | bigint | — | dfs.slate_players id of this seat. |
↳salary players[].seats[].salary | integernullable | — | Salary of this seat. |
↳projected_points players[].seats[].projected_points | decimalnullable | — | STAT_API_LATEST projected fantasy points of this seat. |
↳points_per_1k players[].seats[].points_per_1k | decimalnullable | — | Projected points per $1,000 of salary. |
↳floor players[].seats[].floor | decimalnullable | — | The projection's floor for this seat, its 15th percentile. |
↳ceiling players[].seats[].ceiling | decimalnullable | — | The projection's ceiling for this seat, its 85th percentile. |
↳projected_minutes players[].projected_minutes | decimalnullable | — | The minutes we project the player to play, on an NBA slate (the value of the NBA projections). Null on an NFL slate. |
↳projection players[].projection | objectnullable | — | The essential fields of the player's projection: from the flat row (`format=flat`) GET /api/v1/dfs/slates/{slate_id}/projections serves for the player's FLEX (not multiplied) seat, as it stood at kickoff (`mode=pre`), with that route's keys and values. NBA: opponent, std_dev, usage_rate, play_probability, start_probability, pts, reb, ast, stl, blk, tov, fg3m, double_double_probability, triple_double_probability. NFL: opponent, std_dev, projected_team_snaps (the team's offensive snaps), projected_snaps (the player's), passing_attempts, passing_completions, passing_yds, passing_tds, interceptions_thrown, carries, rushing_yds, rushing_tds, targets, receptions, receiving_yds, receiving_tds. Null when the route has no row for the player. The players CSV (csv=players) adds one `projection.<field>` column per field. |
↳actual players[].actual | objectnullable | — | The player's actual result, once the stats services hold one (null before his game). |
↳fantasy_pts players[].actual.fantasy_pts | decimalnullable | — | The fantasy points he scored on the slate's scoring (GET /api/v1/dfs/player_stats `fantasy_pts` of his FLEX row). |
↳minutes players[].actual.minutes | decimalnullable | — | The minutes he played, on an NBA slate (GET /api/v1/nba/game_player_stats `minutes`). Null on NFL. |
↳peak_total_pct players[].peak_total_pct | decimalnullable | — | The highest total ownership in any free contest (the 5 biggest prize pools of the slate), in percent. The order of players and the featured pick, the same for every caller. |
↳captain_spread players[].captain_spread | objectnullable | — | Max minus min of the captain ownership across the groups, with the groups at both ends. Null without a value, and always null without DFS access (no groups). |
↳spread_pct players[].captain_spread.spread_pct | decimal | — | high_pct minus low_pct. |
↳high_group players[].captain_spread.high_group | string | — | The group key with the highest value (the first in group order on a tie). |
↳high_pct players[].captain_spread.high_pct | decimal | — | The highest value, in percent. |
↳low_group players[].captain_spread.low_group | string | — | The group key with the lowest value (the first in group order on a tie). |
↳low_pct players[].captain_spread.low_pct | decimal | — | The lowest value, in percent. |
↳flex_spread players[].flex_spread | objectnullable | — | The same for the FLEX ownership. |
↳spread_pct players[].flex_spread.spread_pct | decimal | — | high_pct minus low_pct. |
↳high_group players[].flex_spread.high_group | string | — | The group key with the highest value (the first in group order on a tie). |
↳high_pct players[].flex_spread.high_pct | decimal | — | The highest value, in percent. |
↳low_group players[].flex_spread.low_group | string | — | The group key with the lowest value (the first in group order on a tie). |
↳low_pct players[].flex_spread.low_pct | decimal | — | The lowest value, in percent. |
↳by_group players[].by_group | list | — | The player's values in each group, in the order of `groups`. Empty without DFS access. |
↳key players[].by_group[].key | string | — | The group key. |
↳captain_pct players[].by_group[].captain_pct | decimalnullable | — | Captain ownership in the representative contest, in percent (the stored projected_ownership of the captain row x 100). |
↳flex_pct players[].by_group[].flex_pct | decimalnullable | — | FLEX ownership in the representative contest, in percent. |
↳seats players[].by_group[].seats | list | — | On a slate with boost seats (FanDuel's old single game: MVP 2x, STAR 1.5x, PRO 1.2x and FLEX), one entry per seat. Empty on any other slate. |
↳seat players[].by_group[].seats[].seat | string | — | The seat (MVP, STAR, PRO or FLEX). |
↳pct players[].by_group[].seats[].pct | decimalnullable | — | The seat's share, in percent. Null when the player has no row for the seat. |
↳total_pct players[].by_group[].total_pct | decimalnullable | — | captain_pct + flex_pct, plus the STAR and PRO seats on a slate with boost seats (the sum of `seats`). |
↳captain_rate players[].by_group[].captain_rate | decimalnullable | — | captain_pct / total_pct (0-1). Null when the total is 0 or a value is missing. |
↳captain_rank players[].by_group[].captain_rank | bigintnullable | — | Rank of the captain ownership among all players of the group (1 = most owned; ties share a rank). |
↳flex_rank players[].by_group[].flex_rank | bigintnullable | — | Rank of the FLEX ownership among all players of the group. |
_metadata | object | — | Where the values come from, and on a gated answer the plan that opens the rest. |
↳contest_ownership _metadata.contest_ownership | stringnullable | — | persisted (the stored rows of the learned model) when contests are served, else null. Values:persisted |
↳required_tier _metadata.required_tier | stringnullable | — | Sent only when players or contests are held back - pro. |
↳message _metadata.message | stringnullable | — | Sent only when players or contests are held back - what the plan opens. |
↳total_actual_records _metadata.total_actual_records | bigintnullable | — | Sent only when players or contests are held back - the players on the board. |
GET/api/v1/dfs/slates/{slate_id}/ownershipProjected slate ownership board across the lobby and contest groups
slate_idpathbigintrequiredmodequerystringoptionaldefault percentagecontestquerybigintoptionalcomparequerybigintoptionalformatquerystringoptionaldefault jsoncsvquerystringoptionaldefault groupscurl -sS --compressed \
-H 'Authorization: Bearer YOUR_API_KEY' \
'https://api.stat-api.com/api/v1/dfs/slates/1126128/ownership'200Projected slate ownership board across the lobby and contest groupsapplication/jsonshow example ▸
Response Schema(16 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
slate | object | — | The slate. |
↳id slate.id | bigint | — | dfs.slates id. |
↳external_id slate.external_id | bigint | — | Operator slate ID (DraftKings draft group, FanDuel fixture list). |
↳operator slate.operator | string | — | DraftKings or FanDuel. |
↳name slate.name | stringnullable | — | Slate name. |
↳game_type slate.game_type | stringnullable | — | The slate setting's format, as on /dfs/slates. Values:classicshowdownsingle_gametiers |
↳in_game slate.in_game | boolean | — | True for an in-game format (DraftKings In-Game Showdown, FanDuel 2nd half or 4th quarter). In-game formats have no projections by design. |
↳start_time slate.start_time | stringnullable | — | Lock time (ISO 8601, UTC). |
↳status slate.status | stringnullable | — | Upcoming, Live or Completed. |
↳captain_slot slate.captain_slot | stringnullable | — | The captain slot word of the format (CPT on DraftKings, MVP on FanDuel). Null on a format without one. |
↳flex_seats slate.flex_seats | bigintnullable | — | Roster seats that are not the captain seat, from the slate setting (5 on DraftKings Showdown and on FanDuel single game since 2025). The FLEX ownership of one contest sums to 100 x flex_seats percent. |
↳games slate.games | list | — | The slate's games. |
↳game_id slate.games[].game_id | bigint | — | nfl.games id. |
↳away slate.games[].away | stringnullable | — | Away team abbreviation. |
↳home slate.games[].home | stringnullable | — | Home team abbreviation. |
↳kickoff slate.games[].kickoff | stringnullable | — | Kickoff (ISO 8601, UTC). |
source | string | — | The projection source of every value (always STAT_API_LATEST). Values:STAT_API_LATEST |
model | stringnullable | — | The learned model label of the served rows (`stats.ownership_model`, e.g. single_hgb@19d12bd6d309). Null when no rows are served. |
as_of | stringnullable | — | The newest write time of the served rows (ISO 8601, UTC). Null when no rows are served. |
reason | stringnullable | — | Why `contests` and `groups` are empty (an in-game format, no STAT_API_LATEST source for the format, no learned rows yet, or a slate of another league than NFL, which this board does not serve). Null when contests are served. |
access | object | — | What this caller sees. |
↳plan access.plan | string | — | pro (every contest and player), primetime (every contest and player for every caller, on a TNF or MNF game's single-game slate), featured (the free contests with the 5 featured players, on a pre-game single-game slate) or preview (the free contests with 5 players). Values:proprimetimefeaturedpreview |
↳players_total access.players_total | bigint | — | Players on the board. |
↳players_shown access.players_shown | bigint | — | Players in `players`. |
default_contest | bigintnullable | — | The contest the tool opens on (Frank 2026-10-01): the biggest prize pool, the first of `contests`. Null without a contest. |
default_compare | bigintnullable | — | The contest each value compares with (Frank 2026-10-01): the biggest cash game (contest_type 1), by prize pool, then max_entries, then id. Null when the slate has no cash contest. |
contests | list | — | The lobby, the biggest prize pool first, then the largest max_entries, then the lowest id. With DFS access every contest of the slate with learned rows (no qualifier, no cancelled contest). Without it only the free contests: the 5 biggest prize pools of the slate, in the same order. The page filters them All, Cash or GPP and shows 5 of each with DFS access. |
↳id contests[].id | bigint | — | dfs.contests id (the `contest` and `compare` parameter). |
↳external_id contests[].external_id | bigint | — | Operator contest ID. |
↳name contests[].name | string | — | Contest name. |
↳prize_pool contests[].prize_pool | decimal | — | Prize pool, in dollars. |
↳entry_fee contests[].entry_fee | decimal | — | Entry fee, in dollars. |
↳entries contests[].entries | bigint | — | Entries (entry_count) when last read. |
↳max_entries contests[].max_entries | bigint | — | Maximum entries. |
↳max_entries_per_user contests[].max_entries_per_user | bigint | — | Maximum entries per user. |
↳kind contests[].kind | string | — | cash (contest_type 1) or gpp, the same rule as the groups. Values:cashgpp |
↳entry_type contests[].entry_type | stringnullable | — | GPP only: single_entry (max_entries_per_user 1) or multi_entry. Null for cash. Values:single_entrymulti_entry |
↳tier contests[].tier | string | — | Size tier by max_entries (the tiers of the groups). Values:23-100101-1k1k-10k10k-100k100k+ |
↳group contests[].group | string | — | The key of the contest's group in `groups`. |
↳prize_rank contests[].prize_rank | bigint | — | The contest's place among every contest of the slate (1 = the biggest prize pool). A caller without DFS access sees the ranks of the free contests, 1-5 always among them. |
↳same_terms contests[].same_terms | bigint | — | How many other contests of the slate share the model's contest terms (archetype, max_entries, entry fee, max entries per user), so the same values. |
↳open contests[].open | boolean | — | True when this caller may see the contest's values. Always true, since a caller without DFS access gets only the free contests. |
contest | objectnullable | — | The values of the selected contest (`?contest=`, default `default_contest`). Null without a contest. |
↳id contest.id | bigint | — | dfs.contests id. |
↳locked contest.locked | boolean | — | True when this caller may not see the contest's values. A locked contest sends no player and no position total. |
↳reason contest.reason | stringnullable | — | Why the contest is locked, and the plan that opens it. Null when it is open. |
↳players contest.players | list | — | The shown players (all with DFS access, else the 5 featured players or the 5-row preview) with a value in the contest, the highest total first. Empty when locked. |
↳player_id contest.players[].player_id | bigintnullable | — | nfl.players id (the `player_id` of `players`). |
↳captain_pct contest.players[].captain_pct | decimalnullable | — | Captain ownership in the contest, in percent (the stored projected_ownership of the captain row x 100). |
↳flex_pct contest.players[].flex_pct | decimalnullable | — | FLEX ownership in the contest, in percent. |
↳seats contest.players[].seats | list | — | On a slate with boost seats (FanDuel's old single game: MVP 2x, STAR 1.5x, PRO 1.2x and FLEX), one entry per seat. Empty on any other slate. |
↳seat contest.players[].seats[].seat | string | — | The seat (MVP, STAR, PRO or FLEX). |
↳pct contest.players[].seats[].pct | decimalnullable | — | The seat's share, in percent. Null when the player has no row for the seat. |
↳total_pct contest.players[].total_pct | decimalnullable | — | captain_pct + flex_pct, plus the STAR and PRO seats on a slate with boost seats (the sum of `seats`). |
↳captain_rate contest.players[].captain_rate | decimalnullable | — | captain_pct / total_pct (0-1). Null when the total is 0 or a value is missing. |
↳captain_rank contest.players[].captain_rank | bigintnullable | — | Rank of the captain ownership among all players of the contest (1 = most owned; ties share a rank). |
↳flex_rank contest.players[].flex_rank | bigintnullable | — | Rank of the FLEX ownership among all players of the contest. |
↳actual_captain_pct contest.players[].actual_captain_pct | decimalnullable | — | After the contest is final: the field's actual captain (CPT or MVP) ownership of the player in this contest, in percent (GET /api/v1/dfs/contests/{contest_id}/ownership x 100; 0 when no lineup used the seat). Null on a classic contest, and while `actual_status` is not `served`. |
↳actual_flex_pct contest.players[].actual_flex_pct | decimalnullable | — | After the contest is final: the field's actual FLEX ownership in percent; on a classic contest the player's one actual ownership. Null while `actual_status` is not `served`. |
↳actual_total_pct contest.players[].actual_total_pct | decimalnullable | — | After the contest is final: the field's actual ownership of the player in any seat, in percent. Null while `actual_status` is not `served`. |
↳position_totals contest.position_totals | object | — | The contest's ownership summed by real position over every player of the contest (also the players not shown), in percent. Captain sums to about 100, FLEX to about 100 x flex_seats. Both maps are empty when locked. |
↳captain contest.position_totals.captain | object | — | Real position (QB, RB, WR, TE, K, DST, D) to the sum of its captain ownership. |
↳flex contest.position_totals.flex | object | — | Real position to the sum of its FLEX ownership. |
↳seats contest.position_totals.seats | object | — | On a slate with boost seats: seat (MVP, STAR, PRO, FLEX) to real position to the sum of its share. Empty on any other slate. |
↳actual_status contest.actual_status | stringnullable | — | The contest's actual ownership: `served` when its players carry it; `pro_required` when the caller has no DFS access and the contest is not a marquee contest (GET /api/v1/dfs/marquee: only a marquee contest's actual ownership is free; DFS access opens every contest); else the reason of GET /api/v1/dfs/contests/{contest_id}/ownership (`contest_not_final`, `league_not_computed`, `no_lineups`, `lineups_expired`, `actuals_not_recomputed`). Null before the slate is final, and on a locked contest. |
compare | objectnullable | — | The values of the compare contest (`?compare=`, default `default_compare`), the same shape as `contest`. Null when the slate has no cash contest and none is asked. |
↳id compare.id | bigint | — | dfs.contests id. |
↳locked compare.locked | boolean | — | True when this caller may not see the contest's values. A locked contest sends no player and no position total. |
↳reason compare.reason | stringnullable | — | Why the contest is locked, and the plan that opens it. Null when it is open. |
↳players compare.players | list | — | The shown players (all with DFS access, else the 5 featured players or the 5-row preview) with a value in the contest, the highest total first. Empty when locked. |
↳player_id compare.players[].player_id | bigintnullable | — | nfl.players id (the `player_id` of `players`). |
↳captain_pct compare.players[].captain_pct | decimalnullable | — | Captain ownership in the contest, in percent (the stored projected_ownership of the captain row x 100). |
↳flex_pct compare.players[].flex_pct | decimalnullable | — | FLEX ownership in the contest, in percent. |
↳seats compare.players[].seats | list | — | On a slate with boost seats (FanDuel's old single game: MVP 2x, STAR 1.5x, PRO 1.2x and FLEX), one entry per seat. Empty on any other slate. |
↳seat compare.players[].seats[].seat | string | — | The seat (MVP, STAR, PRO or FLEX). |
↳pct compare.players[].seats[].pct | decimalnullable | — | The seat's share, in percent. Null when the player has no row for the seat. |
↳total_pct compare.players[].total_pct | decimalnullable | — | captain_pct + flex_pct, plus the STAR and PRO seats on a slate with boost seats (the sum of `seats`). |
↳captain_rate compare.players[].captain_rate | decimalnullable | — | captain_pct / total_pct (0-1). Null when the total is 0 or a value is missing. |
↳captain_rank compare.players[].captain_rank | bigintnullable | — | Rank of the captain ownership among all players of the contest (1 = most owned; ties share a rank). |
↳flex_rank compare.players[].flex_rank | bigintnullable | — | Rank of the FLEX ownership among all players of the contest. |
↳actual_captain_pct compare.players[].actual_captain_pct | decimalnullable | — | After the contest is final: the field's actual captain (CPT or MVP) ownership of the player in this contest, in percent (GET /api/v1/dfs/contests/{contest_id}/ownership x 100; 0 when no lineup used the seat). Null on a classic contest, and while `actual_status` is not `served`. |
↳actual_flex_pct compare.players[].actual_flex_pct | decimalnullable | — | After the contest is final: the field's actual FLEX ownership in percent; on a classic contest the player's one actual ownership. Null while `actual_status` is not `served`. |
↳actual_total_pct compare.players[].actual_total_pct | decimalnullable | — | After the contest is final: the field's actual ownership of the player in any seat, in percent. Null while `actual_status` is not `served`. |
↳position_totals compare.position_totals | object | — | The contest's ownership summed by real position over every player of the contest (also the players not shown), in percent. Captain sums to about 100, FLEX to about 100 x flex_seats. Both maps are empty when locked. |
↳captain compare.position_totals.captain | object | — | Real position (QB, RB, WR, TE, K, DST, D) to the sum of its captain ownership. |
↳flex compare.position_totals.flex | object | — | Real position to the sum of its FLEX ownership. |
↳seats compare.position_totals.seats | object | — | On a slate with boost seats: seat (MVP, STAR, PRO, FLEX) to real position to the sum of its share. Empty on any other slate. |
↳actual_status compare.actual_status | stringnullable | — | The contest's actual ownership: `served` when its players carry it; `pro_required` when the caller has no DFS access and the contest is not a marquee contest (GET /api/v1/dfs/marquee: only a marquee contest's actual ownership is free; DFS access opens every contest); else the reason of GET /api/v1/dfs/contests/{contest_id}/ownership (`contest_not_final`, `league_not_computed`, `no_lineups`, `lineups_expired`, `actuals_not_recomputed`). Null before the slate is final, and on a locked contest. |
across | object | — | The biggest contests side by side (the tool's Across contests tab). |
↳contest_ids across.contest_ids | list<L> | — | The contests in lobby order. With DFS access the 5 biggest GPP contests and the 5 biggest cash games (the page's three filters); without it the free contests, so the ids of `contests`. |
↳values across.values | object | — | Contest id to player id to [captain_pct, flex_pct], for the open contests of `contest_ids` and the shown players with a value. A locked contest is left out. For a final contest whose actual ownership the caller can read (a marquee contest for every caller; every contest with DFS access) the array holds a third value: the player's actual total ownership in percent, 0 for a player in no lineup. Before the contest is final the array holds two values. |
↳seats across.seats | object | — | On a slate with boost seats: contest id to player id to seat (MVP, STAR, PRO, FLEX) to its share, for the same contests and players as `values`. Empty on any other slate. |
default_group | stringnullable | — | The group key the tool opened first before the lobby (Frank 2026-10-01, the largest GPP): the GPP group whose representative contest comes first by the representative order (paid, then the largest max_entries, then entries, prize pool, id). Null without a GPP group. |
groups | list | — | The contest groups, cash first, then single-entry GPP, then multi-entry GPP, each by size tier. DFS access only; empty without it. |
↳key groups[].key | string | — | The group key: kind, entry type (GPP only) and size tier, e.g. cash:3-100, gpp:single_entry:1k-10k, gpp:multi_entry:100k+. |
↳kind groups[].kind | string | — | cash or gpp, as the operator labels the contest (Frank 2026-10-01): contest_type 1 is cash, every other type gpp. A DraftKings Triple Up (contest_type 0) is gpp, although the model's archetype calls it cash. Only a contest without a contest_type falls back to the model's name rule (Double Up, 50/50, H2H, Triple Up). Values:cashgpp |
↳entry_type groups[].entry_type | stringnullable | — | GPP only: single_entry (max_entries_per_user 1) or multi_entry. Null for cash. Values:single_entrymulti_entry |
↳size_tier groups[].size_tier | string | — | Size tier by max_entries. Values:23-100101-1k1k-10k10k-100k100k+ |
↳contest_count groups[].contest_count | bigint | — | Contests of the slate in this group that have learned rows. |
↳contest groups[].contest | object | — | The representative contest, whose stored values the group shows: paid first, then the largest max_entries, then the most entries, then the largest prize pool, then the lowest id. |
↳contest_id groups[].contest.contest_id | bigint | — | dfs.contests id. |
↳external_id groups[].contest.external_id | bigint | — | Operator contest ID. |
↳name groups[].contest.name | string | — | Contest name. |
↳entries groups[].contest.entries | bigint | — | Entries (entry_count) when last read. |
↳max_entries groups[].contest.max_entries | bigint | — | Maximum entries (the model's size feature). |
↳max_entries_per_user groups[].contest.max_entries_per_user | bigint | — | Maximum entries per user. |
↳entry_fee_cents groups[].contest.entry_fee_cents | bigint | — | Entry fee in cents. |
↳prize_pool_cents groups[].contest.prize_pool_cents | bigint | — | Prize pool in cents. |
↳archetype groups[].contest.archetype | string | — | The stored contest_archetype of its rows, else the model's rule. Values:cashgpp_single_entrygpp_small_fieldgpp_mmebaseline |
↳position_totals groups[].position_totals | list | — | The group's ownership summed by real position, captain and FLEX apart, over every player of the representative contest (also the players a preview does not list). Captain sums to about 100, FLEX to about 100 x flex_seats. |
↳position groups[].position_totals[].position | string | — | Real position (QB, RB, WR, TE, K, DST on DraftKings, D on FanDuel). |
↳captain_pct groups[].position_totals[].captain_pct | decimal | — | Sum of the captain ownership, in percent. |
↳flex_pct groups[].position_totals[].flex_pct | decimal | — | Sum of the FLEX ownership, in percent. |
↳seats groups[].position_totals[].seats | list | — | On a slate with boost seats, each seat's sum (MVP, STAR, PRO, FLEX). Empty on any other slate. |
↳seat groups[].position_totals[].seats[].seat | string | — | The seat (MVP, STAR, PRO or FLEX). |
↳pct groups[].position_totals[].seats[].pct | decimalnullable | — | The seat's share, in percent. Null when the player has no row for the seat. |
players | list | — | The players, highest peak total first (all with DFS access, else the 5 featured players or the 5-row preview). The order is the same for every caller, so the first 5 of a Pro answer are the featured players. |
↳player_id players[].player_id | bigintnullable | — | nfl.players id. |
↳name players[].name | stringnullable | — | Player name. |
↳team players[].team | stringnullable | — | Team abbreviation. |
↳position players[].position | stringnullable | — | Real position (QB, RB, WR, TE, K, DST or D). |
↳captain players[].captain | objectnullable | — | The captain (CPT or MVP) slot. Null on a format without one. |
↳slate_player_id players[].captain.slate_player_id | bigint | — | dfs.slate_players id of this slot. |
↳salary players[].captain.salary | integernullable | — | Salary of this slot. |
↳projected_points players[].captain.projected_points | decimalnullable | — | STAT_API_LATEST projected fantasy points of this slot. |
↳points_per_1k players[].captain.points_per_1k | decimalnullable | — | Projected points per $1,000 of salary. |
↳floor players[].captain.floor | decimalnullable | — | The projection's floor for this slot, its 15th percentile (the floor of GET /api/v1/dfs/slates/{slate_id}/projections). |
↳ceiling players[].captain.ceiling | decimalnullable | — | The projection's ceiling for this slot, its 85th percentile (the ceiling of GET /api/v1/dfs/slates/{slate_id}/projections). |
↳flex players[].flex | objectnullable | — | The FLEX slot. |
↳slate_player_id players[].flex.slate_player_id | bigint | — | dfs.slate_players id of this slot. |
↳salary players[].flex.salary | integernullable | — | Salary of this slot. |
↳projected_points players[].flex.projected_points | decimalnullable | — | STAT_API_LATEST projected fantasy points of this slot. |
↳points_per_1k players[].flex.points_per_1k | decimalnullable | — | Projected points per $1,000 of salary. |
↳floor players[].flex.floor | decimalnullable | — | The projection's floor for this slot, its 15th percentile (the floor of GET /api/v1/dfs/slates/{slate_id}/projections). |
↳ceiling players[].flex.ceiling | decimalnullable | — | The projection's ceiling for this slot, its 85th percentile (the ceiling of GET /api/v1/dfs/slates/{slate_id}/projections). |
↳seats players[].seats | list | — | On a slate with boost seats (FanDuel's old single game: MVP 2x, STAR 1.5x, PRO 1.2x and FLEX), the slot of each seat the player holds, in that order: the seat and the fields of a slot (slate_player_id, salary, projected_points, points_per_1k, floor, ceiling). `captain` is the MVP seat and `flex` the FLEX seat. Empty on any other slate. |
↳seat players[].seats[].seat | string | — | The seat (MVP, STAR, PRO or FLEX). |
↳slate_player_id players[].seats[].slate_player_id | bigint | — | dfs.slate_players id of this seat. |
↳salary players[].seats[].salary | integernullable | — | Salary of this seat. |
↳projected_points players[].seats[].projected_points | decimalnullable | — | STAT_API_LATEST projected fantasy points of this seat. |
↳points_per_1k players[].seats[].points_per_1k | decimalnullable | — | Projected points per $1,000 of salary. |
↳floor players[].seats[].floor | decimalnullable | — | The projection's floor for this seat, its 15th percentile. |
↳ceiling players[].seats[].ceiling | decimalnullable | — | The projection's ceiling for this seat, its 85th percentile. |
↳projected_minutes players[].projected_minutes | decimalnullable | — | The minutes we project the player to play, on an NBA slate (the value of the NBA projections). Null on an NFL slate. |
↳projection players[].projection | objectnullable | — | The essential fields of the player's projection: from the flat row (`format=flat`) GET /api/v1/dfs/slates/{slate_id}/projections serves for the player's FLEX (not multiplied) seat, as it stood at kickoff (`mode=pre`), with that route's keys and values. NBA: opponent, std_dev, usage_rate, play_probability, start_probability, pts, reb, ast, stl, blk, tov, fg3m, double_double_probability, triple_double_probability. NFL: opponent, std_dev, projected_team_snaps (the team's offensive snaps), projected_snaps (the player's), passing_attempts, passing_completions, passing_yds, passing_tds, interceptions_thrown, carries, rushing_yds, rushing_tds, targets, receptions, receiving_yds, receiving_tds. Null when the route has no row for the player. The players CSV (csv=players) adds one `projection.<field>` column per field. |
↳actual players[].actual | objectnullable | — | The player's actual result, once the stats services hold one (null before his game). |
↳fantasy_pts players[].actual.fantasy_pts | decimalnullable | — | The fantasy points he scored on the slate's scoring (GET /api/v1/dfs/player_stats `fantasy_pts` of his FLEX row). |
↳minutes players[].actual.minutes | decimalnullable | — | The minutes he played, on an NBA slate (GET /api/v1/nba/game_player_stats `minutes`). Null on NFL. |
↳peak_total_pct players[].peak_total_pct | decimalnullable | — | The highest total ownership in any free contest (the 5 biggest prize pools of the slate), in percent. The order of players and the featured pick, the same for every caller. |
↳captain_spread players[].captain_spread | objectnullable | — | Max minus min of the captain ownership across the groups, with the groups at both ends. Null without a value, and always null without DFS access (no groups). |
↳spread_pct players[].captain_spread.spread_pct | decimal | — | high_pct minus low_pct. |
↳high_group players[].captain_spread.high_group | string | — | The group key with the highest value (the first in group order on a tie). |
↳high_pct players[].captain_spread.high_pct | decimal | — | The highest value, in percent. |
↳low_group players[].captain_spread.low_group | string | — | The group key with the lowest value (the first in group order on a tie). |
↳low_pct players[].captain_spread.low_pct | decimal | — | The lowest value, in percent. |
↳flex_spread players[].flex_spread | objectnullable | — | The same for the FLEX ownership. |
↳spread_pct players[].flex_spread.spread_pct | decimal | — | high_pct minus low_pct. |
↳high_group players[].flex_spread.high_group | string | — | The group key with the highest value (the first in group order on a tie). |
↳high_pct players[].flex_spread.high_pct | decimal | — | The highest value, in percent. |
↳low_group players[].flex_spread.low_group | string | — | The group key with the lowest value (the first in group order on a tie). |
↳low_pct players[].flex_spread.low_pct | decimal | — | The lowest value, in percent. |
↳by_group players[].by_group | list | — | The player's values in each group, in the order of `groups`. Empty without DFS access. |
↳key players[].by_group[].key | string | — | The group key. |
↳captain_pct players[].by_group[].captain_pct | decimalnullable | — | Captain ownership in the representative contest, in percent (the stored projected_ownership of the captain row x 100). |
↳flex_pct players[].by_group[].flex_pct | decimalnullable | — | FLEX ownership in the representative contest, in percent. |
↳seats players[].by_group[].seats | list | — | On a slate with boost seats (FanDuel's old single game: MVP 2x, STAR 1.5x, PRO 1.2x and FLEX), one entry per seat. Empty on any other slate. |
↳seat players[].by_group[].seats[].seat | string | — | The seat (MVP, STAR, PRO or FLEX). |
↳pct players[].by_group[].seats[].pct | decimalnullable | — | The seat's share, in percent. Null when the player has no row for the seat. |
↳total_pct players[].by_group[].total_pct | decimalnullable | — | captain_pct + flex_pct, plus the STAR and PRO seats on a slate with boost seats (the sum of `seats`). |
↳captain_rate players[].by_group[].captain_rate | decimalnullable | — | captain_pct / total_pct (0-1). Null when the total is 0 or a value is missing. |
↳captain_rank players[].by_group[].captain_rank | bigintnullable | — | Rank of the captain ownership among all players of the group (1 = most owned; ties share a rank). |
↳flex_rank players[].by_group[].flex_rank | bigintnullable | — | Rank of the FLEX ownership among all players of the group. |
_metadata | object | — | Where the values come from, and on a gated answer the plan that opens the rest. |
↳contest_ownership _metadata.contest_ownership | stringnullable | — | persisted (the stored rows of the learned model) when contests are served, else null. Values:persisted |
↳required_tier _metadata.required_tier | stringnullable | — | Sent only when players or contests are held back - pro. |
↳message _metadata.message | stringnullable | — | Sent only when players or contests are held back - what the plan opens. |
↳total_actual_records _metadata.total_actual_records | bigintnullable | — | Sent only when players or contests are held back - the players on the board. |
GET/api/v1/dfs/slates/{slate_id}/projectionsDFS slate player projections, distributions, and betting props
slate_idpathbigintrequiredsourcequerystringoptionaldefault STAT_API_LATESTpositionquerystringoptionalformatquerystringoptionaldefault jsonenrichquerystringoptionalmodequerystringoptionaldefault preprojection_idquerybigintoptionalcurl -sS --compressed \
-H 'Authorization: Bearer YOUR_API_KEY' \
'https://api.stat-api.com/api/v1/dfs/slates/1126128/projections'200DFS slate player projections, distributions, and betting propsapplication/jsonshow example ▸
Response Schema(8 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
projection_status | string | — | Whether the slate's format has projections. `available`: the format has a projection source, and the arrays hold its rows (a player without a projection has null values). `none_by_design`: the format has no projections by decision (the in-game formats: DraftKings In-Game Showdown H2 and Q4, FanDuel single game 2nd half and 4th quarter); `source` is null and the arrays are empty. `no_player_pool`: the slate has no player pool yet, so there is nothing to project; `source` is null and the arrays are empty. `not_projected_yet` (NBA, NHL): no player of the slate has a projection of our NBA or NHL engine yet. A game's first projection appears on game day, once its betting line and roster (NHL: lineup reading) are in, and preseason games are never projected; the arrays are empty. `not_projected` (NBA, NHL): every game of the slate started with no projection of our NBA or NHL engine (the games before the engine ran), so none will come; the arrays are empty. `league_not_projected`: our engines do not project the slate's league (MLB, golf); the arrays are empty. Values:availablenone_by_designno_player_poolnot_projected_yetnot_projectedleague_not_projected |
slate | object | — | Contest slate summary. |
↳id slate.id | bigint | — | Slate ID. |
↳external_id slate.external_id | string | — | Operator-specific contest slate identifier. |
↳operator slate.operator | string | — | DFS operator name (DraftKings, FanDuel, Yahoo). |
↳actual_ownership_contest_id slate.actual_ownership_contest_id | bigintnullable | — | The one contest (dfs.contests id) whose actual_ownership the player rows of this slate carry: the contest with actuals and the biggest prize pool, then the most entries, then the lowest id. Absent when no contest of the slate has actuals. The contest answer never uses this value. |
↳league slate.league | stringnullable | — | The slate's league (nfl, nba, mlb, nhl, golf). It decides which row fields the answer carries: the fields marked NBA only come on NBA rows, the fields marked NHL only and the fields marked NBA and NHL on NHL rows, every other row field on NFL rows. |
source | objectnullable | — | Projection source metadata. Null when projection_status is none_by_design or no_player_pool, and on every NBA and NHL answer (our NBA and NHL engines have no stored source row; `_metadata.served_source` names the engine, STAT_API_NBA or STAT_API_NHL). |
↳id source.id | bigint | — | Source ID. |
↳slate_setting_id source.slate_setting_id | bigint | — | Slate setting ID. |
↳name source.name | string | — | Projection model name. |
↳source_type source.source_type | integer | — | Source type code. |
↳updated_at source.updated_at | string | — | Timestamp of projection generation. |
computed | object | — | Projection coverage and calculation summary. |
↳eligible_players computed.eligible_players | bigint | — | Total eligible players in contest pool. |
↳projected_players computed.projected_players | bigint | — | Number of players with generated projections. |
↳missing_players computed.missing_players | bigint | — | Unprojected player count. |
↳coverage computed.coverage | decimal | — | Percentage of pool successfully projected. |
↳total_teams computed.total_teams | integernullable | — | Total active teams projected on the slate. |
↳position computed.position | stringnullable | — | Roster position filter applied to request. |
↳total_roster_mass computed.total_roster_mass | decimalnullable | — | Total roster mass. |
↳position_ownership_totals computed.position_ownership_totals | objectnullable | — | Aggregated projected ownership percentage by position group across the slate. |
↳refused_seats computed.refused_seats | listnullable | — | NBA and NHL: the seats that have a projection but are left out of the rows, each with the reason (never guessed). Absent on NFL answers. |
↳slate_player_id computed.refused_seats[].slate_player_id | bigint | — | The seat (dfs.slate_players.id). |
↳position computed.refused_seats[].position | stringnullable | — | The seat's position as the operator names it. |
↳reason computed.refused_seats[].reason | string | — | no_seat_multiplier: a CPT, MVP, STAR or PRO seat whose slate setting states no score multiplier. no_scoring_rules: no scoring table of the operator is in force at the game's time. bad_stat_line: the player's stat line cannot be scored. Values:no_seat_multiplierno_scoring_rulesbad_stat_line |
player_stats | list | — | The player projections as flat rows, one per slate player. Sent with format=flat. format=csv returns these rows as CSV: one column per field below, in this order, then one column per `enrich` tag. An NFL row sends every field that is not marked NBA only, NBA and NHL, or NHL only; an NBA row sends the shared fields and the fields marked NBA only or NBA and NHL, in this order, and no NFL-only field; an NHL row sends the shared fields, the fields marked NBA and NHL and the fields marked NHL only, in this order, and no NFL-only or NBA-only field. A value the projection does not have is null. |
↳id player_stats[].id | bigint | — | Slate player ID (dfs.slate_players.id). |
↳slate_player_id player_stats[].slate_player_id | bigint | — | Slate player ID (dfs.slate_players.id), the same value as id. |
↳league_id player_stats[].league_id | bigint | — | League ID. |
↳slate_id player_stats[].slate_id | bigint | — | Slate ID. |
↳operator_id player_stats[].operator_id | bigint | — | Operator ID (1 DraftKings, 2 FanDuel, 3 Yahoo). |
↳scoring_format player_stats[].scoring_format | string | — | The slate's scoring format: showdown when the pool has captain (CPT/MVP) rows, else classic. Values:classicshowdown |
↳player_id player_stats[].player_id | bigintnullable | — | Canonical player ID (nfl.players.id). |
↳operator_player_id player_stats[].operator_player_id | stringnullable | — | Operator athlete ID (dfs.slate_players.external_id). |
↳operator_player_export_id player_stats[].operator_player_export_id | stringnullable | — | Operator export / draftable ID for lineup CSV uploads (dfs.slate_players.export_id). |
↳slate_game_id player_stats[].slate_game_id | bigintnullable | — | Slate game ID (dfs.slate_games.id). |
↳game_id player_stats[].game_id | bigintnullable | — | Canonical game ID (nfl.games.id). |
↳team_id player_stats[].team_id | bigintnullable | — | Team ID (nfl.teams.id). |
↳slate_date player_stats[].slate_date | stringnullable | — | Slate date (YYYY-MM-DD). |
↳salary player_stats[].salary | integernullable | — | Contest player salary in currency units. |
↳position player_stats[].position | stringnullable | — | Contest roster position (e.g. QB, RB, WR, TE, DST, K, CPT). |
↳name player_stats[].name | stringnullable | — | Player name. |
↳team player_stats[].team | stringnullable | — | Team abbreviation. |
↳opponent player_stats[].opponent | stringnullable | — | Opponent team abbreviation. |
↳gsis player_stats[].gsis | stringnullable | — | NFL GSIS player ID. |
↳fantasy_pts player_stats[].fantasy_pts | decimalnullable | — | Projected fantasy points under the slate's scoring rules. Null when the player has no projection. |
↳floor player_stats[].floor | decimalnullable | — | Projected 10th percentile fantasy point outcome. |
↳ceiling player_stats[].ceiling | decimalnullable | — | Projected 90th percentile fantasy point outcome. |
↳std_dev player_stats[].std_dev | decimalnullable | — | Standard deviation of the projected fantasy point distribution. |
↳value player_stats[].value | decimalnullable | — | Projected fantasy points per $1k of salary. |
↳quantiles player_stats[].quantiles | objectnullable | — | Quantile outcomes of the simulated fantasy point distribution (p05 to p95). |
↳passing_yds_fpts player_stats[].passing_yds_fpts | decimalnullable | — | Fantasy points from projected passing yards. |
↳passing_td_fpts player_stats[].passing_td_fpts | decimalnullable | — | Fantasy points from projected passing touchdowns. |
↳interception_fpts player_stats[].interception_fpts | decimalnullable | — | Fantasy points lost to projected interceptions. |
↳passing_2pt_conversion_fpts player_stats[].passing_2pt_conversion_fpts | decimalnullable | — | Fantasy points from 2-point passing conversions (0 when the player has a projection; the model projects none). |
↳passing_bonus_fpts player_stats[].passing_bonus_fpts | decimalnullable | — | Fantasy bonus points for milestone passing (DraftKings 300+ yards). |
↳rushing_yds_fpts player_stats[].rushing_yds_fpts | decimalnullable | — | Fantasy points from projected rushing yards. |
↳rushing_td_fpts player_stats[].rushing_td_fpts | decimalnullable | — | Fantasy points from projected rushing touchdowns. |
↳fumble_lost_fpts player_stats[].fumble_lost_fpts | decimalnullable | — | Fantasy points lost to projected lost fumbles. |
↳rushing_2pt_conversion_fpts player_stats[].rushing_2pt_conversion_fpts | decimalnullable | — | Fantasy points from 2-point rushing conversions (0 when the player has a projection; the model projects none). |
↳rushing_bonus_fpts player_stats[].rushing_bonus_fpts | decimalnullable | — | Fantasy bonus points for milestone rushing (DraftKings 100+ yards). |
↳receiving_yds_fpts player_stats[].receiving_yds_fpts | decimalnullable | — | Fantasy points from projected receiving yards. |
↳reception_fpts player_stats[].reception_fpts | decimalnullable | — | Fantasy points from projected receptions (DraftKings full PPR, FanDuel half PPR). |
↳receiving_td_fpts player_stats[].receiving_td_fpts | decimalnullable | — | Fantasy points from projected receiving touchdowns. |
↳receiving_2pt_conversion_fpts player_stats[].receiving_2pt_conversion_fpts | decimalnullable | — | Fantasy points from 2-point receiving conversions (0 when the player has a projection; the model projects none). |
↳receiving_bonus_fpts player_stats[].receiving_bonus_fpts | decimalnullable | — | Fantasy bonus points for milestone receiving (DraftKings 100+ yards). |
↳passing_yds player_stats[].passing_yds | decimalnullable | — | Projected passing yards (QB, or a player with 1+ projected pass attempt). |
↳passing_tds player_stats[].passing_tds | decimalnullable | — | Projected passing touchdowns. |
↳interceptions_thrown player_stats[].interceptions_thrown | decimalnullable | — | Projected interceptions thrown. |
↳rushing_yds player_stats[].rushing_yds | decimalnullable | — | Projected rushing yards. |
↳rushing_tds player_stats[].rushing_tds | decimalnullable | — | Projected rushing touchdowns. |
↳rushing_fumbles_lost player_stats[].rushing_fumbles_lost | decimalnullable | — | Projected lost fumbles (0 when the player has a projection and the model gives none). |
↳receptions player_stats[].receptions | decimalnullable | — | Projected receptions. |
↳receiving_yds player_stats[].receiving_yds | decimalnullable | — | Projected receiving yards. |
↳receiving_tds player_stats[].receiving_tds | decimalnullable | — | Projected receiving touchdowns. |
↳carries player_stats[].carries | decimalnullable | — | Projected rushing attempts. |
↳targets player_stats[].targets | decimalnullable | — | Projected receiving targets. |
↳catch_rate player_stats[].catch_rate | decimalnullable | — | Projected receptions per target, as a percentage (0-100). |
↳passing_attempts player_stats[].passing_attempts | decimalnullable | — | Projected pass attempts. |
↳passing_completions player_stats[].passing_completions | decimalnullable | — | Projected pass completions. |
↳snap_pct player_stats[].snap_pct | decimalnullable | — | Projected offensive snap share, as a percentage (0-100). |
↳projected_snap_share player_stats[].projected_snap_share | decimalnullable | — | Projected offensive snap share, as a fraction (0-1). |
↳projected_snaps player_stats[].projected_snaps | decimalnullable | — | Projected offensive snaps. |
↳projected_team_snaps player_stats[].projected_team_snaps | decimalnullable | — | Projected team offensive snaps. |
↳player_game_note player_stats[].player_game_note | stringnullable | — | Game note for the player from the projection model. |
↳projected_ownership player_stats[].projected_ownership | decimalnullable | — | Projected tournament roster share, as a fraction (0-1). |
↳ownership_pct player_stats[].ownership_pct | decimalnullable | — | Projected tournament roster share, as a percentage (e.g. 15.5 for 15.5%). |
↳ownership_volatility player_stats[].ownership_volatility | decimalnullable | — | Standard deviation of the projected ownership percentage across simulated crowds. |
↳ownership_low player_stats[].ownership_low | decimalnullable | — | 10th percentile projected ownership percentage. |
↳ownership_high player_stats[].ownership_high | decimalnullable | — | 90th percentile projected ownership percentage. |
↳chalk_fragility player_stats[].chalk_fragility | decimalnullable | — | Chalk fragility index in [0, 1] (0 = stable across cap allocations, 1 = fragile). |
↳cash_projected_ownership player_stats[].cash_projected_ownership | decimalnullable | — | Projected cash-game (double-up, 50/50) roster share, as a fraction (0-1). Null on contest projections. |
↳cash_ownership_pct player_stats[].cash_ownership_pct | decimalnullable | — | Projected cash-game roster share, as a percentage. Null on contest projections. |
↳captain_ownership player_stats[].captain_ownership | decimalnullable | — | Showdown: projected ownership percentage of this player's captain (CPT/MVP) row. Null on classic slates. |
↳flex_ownership player_stats[].flex_ownership | decimalnullable | — | Showdown: projected ownership percentage of this player's FLEX row. Null on classic slates. |
↳total_ownership player_stats[].total_ownership | decimalnullable | — | Showdown: captain plus FLEX ownership percentage. Null on classic slates. |
↳captain_ratio player_stats[].captain_ratio | decimalnullable | — | Showdown: captain ownership divided by total ownership (0-1). Null on classic slates. |
↳play_profile player_stats[].play_profile | objectnullable | — | Play profile with upside and safety metrics, boom/bust probabilities, archetype and analysis. |
↳upside_tier player_stats[].upside_tier | stringnullable | — | Salary-adjusted upside tier (ELITE, BOOM, STEADY, LOW_CAP, NONE). |
↳ceiling_multiplier player_stats[].ceiling_multiplier | decimalnullable | — | Ceiling per $1k of salary. |
↳boom_probability player_stats[].boom_probability | decimalnullable | — | Probability of scoring at least the boom multiple of salary. |
↳cash_safety_tier player_stats[].cash_safety_tier | stringnullable | — | Salary-adjusted cash safety tier (CORE_CASH, CASH_VIABLE, MODERATE, HIGH_RISK, UNVIABLE). |
↳floor_multiplier player_stats[].floor_multiplier | decimalnullable | — | Floor per $1k of salary. |
↳bust_probability player_stats[].bust_probability | decimalnullable | — | Probability of scoring under 1.5x salary. |
↳play_archetype player_stats[].play_archetype | stringnullable | — | Archetype (GPP_BOOM, CORE_CASH, LEVERAGE, FRAGILE_CHALK, BALANCED, LOW_CAP, OUT_INACTIVE, or the model's tactical label). |
↳leverage_factor player_stats[].leverage_factor | decimalnullable | — | Tournament leverage factor (ceiling_multiplier / max(0.02, ownership)). |
↳tactical_tag player_stats[].tactical_tag | stringnullable | — | Tactical play tag from the projection model (e.g. GOOD_CHALK, FRAGILE_CHALK, LEVERAGE). |
↳fade_leverage_score player_stats[].fade_leverage_score | decimalnullable | — | Score for fading the player in tournaments, from the projection model. |
↳knapsack_shadow_price player_stats[].knapsack_shadow_price | decimalnullable | — | Marginal points per salary dollar at the optimizer's cap constraint, from the projection model. |
↳relative_fragility player_stats[].relative_fragility | decimalnullable | — | Fragility relative to the player's position peers on the slate, from the projection model. |
↳analysis_headline player_stats[].analysis_headline | stringnullable | — | One-line summary of the player's role, floor or ceiling. |
↳cash_verdict player_stats[].cash_verdict | stringnullable | — | Cash-game verdict. |
↳gpp_verdict player_stats[].gpp_verdict | stringnullable | — | Tournament verdict. |
↳vegas_odds player_stats[].vegas_odds | objectnullable | — | The player's betting props used as calibration anchors. |
↳anytime_td player_stats[].vegas_odds.anytime_td | integernullable | — | Anytime touchdown odds (American format). |
↳rushing_yards player_stats[].vegas_odds.rushing_yards | decimalnullable | — | Rushing yards consensus betting line. |
↳receiving_yards player_stats[].vegas_odds.receiving_yards | decimalnullable | — | Receiving yards consensus betting line. |
↳receptions player_stats[].vegas_odds.receptions | decimalnullable | — | Receptions consensus betting line. |
↳passing_yards player_stats[].vegas_odds.passing_yards | decimalnullable | — | Passing yards consensus betting line. |
↳passing_tds player_stats[].vegas_odds.passing_tds | decimalnullable | — | Passing touchdowns consensus betting line. |
↳dvp_archetype player_stats[].dvp_archetype | stringnullable | — | Player usage archetype the defense-vs-position rating uses. |
↳dvp_rank player_stats[].dvp_rank | integernullable | — | Opponent defense rank against the archetype (1 = best matchup). |
↳dvp_rating player_stats[].dvp_rating | decimalnullable | — | Defense-vs-position matchup rating. |
↳dvp_matchup player_stats[].dvp_matchup | stringnullable | — | Matchup label (e.g. Favorable, Neutral, Tough). |
↳dvp_explanation player_stats[].dvp_explanation | stringnullable | — | Explanation of the defensive matchup. |
↳dvp_metrics player_stats[].dvp_metrics | objectnullable | — | Defense-vs-position metrics behind the rating. |
↳scheme_metrics player_stats[].scheme_metrics | objectnullable | — | Defensive scheme indicators behind the rating. |
↳last_update_time player_stats[].last_update_time | timestamptznullable | — | When the projection last changed (UTC). |
↳update_explanation player_stats[].update_explanation | stringnullable | — | Why the projection last changed. |
↳update_reason player_stats[].update_reason | objectnullable | — | Structured reason of the last change. |
↳update_history player_stats[].update_history | list<object>nullable | — | The last 5 projection changes, oldest first. |
↳actual_fantasy_pts player_stats[].actual_fantasy_pts | decimalnullable | — | Post-game: fantasy points scored (dfs.player_stats). Null in mode=pre. |
↳actual_ownership player_stats[].actual_ownership | decimalnullable | — | Post-game: roster share in the slate's largest contest with results, as a fraction (0-1). Null in mode=pre. |
↳actual_rank player_stats[].actual_rank | integernullable | — | Post-game: the player's rank by actual ownership in the contest (contest projections only). Null in mode=pre. |
↳leverage_delta player_stats[].leverage_delta | decimalnullable | — | Post-game: actual_ownership minus projected_ownership. Null in mode=pre. |
↳status player_stats[].status | stringnullable | — | NBA and NHL: the player's status. NBA: the status in our NBA game roster when the projection ran (available, questionable, out, ...). NHL: the slate player's status as the operator lists it; null when the operator lists none. |
↳seat_multiplier player_stats[].seat_multiplier | decimalnullable | — | NBA and NHL: the seat's score multiplier from the slate setting (DraftKings CPT 1.5, FanDuel MVP 1.5); 1 for every other seat. fantasy_pts, floor, ceiling, std_dev and quantiles are already multiplied. |
↳chance_5x player_stats[].chance_5x | decimalnullable | — | NBA and NHL: chance the seat's points reach 5x salary / 1000, 0 to 1 (see the route description); null without a salary. |
↳chance_5x_bound player_stats[].chance_5x_bound | stringnullable | — | NBA and NHL: set when chance_5x is a bound, not a value: above_99pct (the chance is 0.99 or more) or below_1pct (0.01 or less). Values:above_99pctbelow_1pct |
↳chance_6x player_stats[].chance_6x | decimalnullable | — | NBA and NHL: chance the seat's points reach 6x salary / 1000, 0 to 1; null without a salary. |
↳chance_6x_bound player_stats[].chance_6x_bound | stringnullable | — | NBA and NHL: set when chance_6x is a bound, not a value. Values:above_99pctbelow_1pct |
↳minutes_mean player_stats[].minutes_mean | decimalnullable | — | NBA and NHL: projected minutes (mean); on NHL the projected time on ice. |
↳minutes_std player_stats[].minutes_std | decimalnullable | — | NBA and NHL: standard deviation of the projected minutes. |
↳minutes_p10 player_stats[].minutes_p10 | decimalnullable | — | NBA and NHL: 10th percentile of the projected minutes. |
↳minutes_p25 player_stats[].minutes_p25 | decimalnullable | — | NBA and NHL: 25th percentile of the projected minutes. |
↳minutes_p50 player_stats[].minutes_p50 | decimalnullable | — | NBA and NHL: median of the projected minutes. |
↳minutes_p75 player_stats[].minutes_p75 | decimalnullable | — | NBA and NHL: 75th percentile of the projected minutes. |
↳minutes_p90 player_stats[].minutes_p90 | decimalnullable | — | NBA and NHL: 90th percentile of the projected minutes. |
↳usage_rate player_stats[].usage_rate | decimalnullable | — | NBA only: projected usage rate, 0 to 1. |
↳play_probability player_stats[].play_probability | decimalnullable | — | NBA and NHL: chance the player plays, 0 to 1 (NHL: the chance the player dresses for the game). |
↳start_probability player_stats[].start_probability | decimalnullable | — | NBA and NHL: chance the player starts, 0 to 1. |
↳pts player_stats[].pts | decimalnullable | — | NBA only: projected points (the stat). |
↳reb player_stats[].reb | decimalnullable | — | NBA only: projected rebounds. |
↳ast player_stats[].ast | decimalnullable | — | NBA only: projected assists. |
↳stl player_stats[].stl | decimalnullable | — | NBA only: projected steals. |
↳g player_stats[].g | decimalnullable | — | NHL only: projected goals (regulation and overtime; a shootout goal is so_g). |
↳a player_stats[].a | decimalnullable | — | NHL only: projected assists. |
↳sog player_stats[].sog | decimalnullable | — | NHL only: projected shots on goal. |
↳blk player_stats[].blk | decimalnullable | — | NBA and NHL: projected blocks (NBA) or blocked shots (NHL). |
↳fg3m player_stats[].fg3m | decimalnullable | — | NBA only: projected three-pointers made. |
↳tov player_stats[].tov | decimalnullable | — | NBA only: projected turnovers. |
↳double_double_probability player_stats[].double_double_probability | decimalnullable | — | NBA only: chance of a double-double, 0 to 1. |
↳triple_double_probability player_stats[].triple_double_probability | decimalnullable | — | NBA only: chance of a triple-double, 0 to 1. |
↳ppg player_stats[].ppg | decimalnullable | — | NHL only: projected power-play goals (a part of g). |
↳ppa player_stats[].ppa | decimalnullable | — | NHL only: projected power-play assists (a part of a). |
↳shg player_stats[].shg | decimalnullable | — | NHL only: projected short-handed goals (a part of g). |
↳sha player_stats[].sha | decimalnullable | — | NHL only: projected short-handed assists (a part of a). |
↳so_g player_stats[].so_g | decimalnullable | — | NHL only: projected shootout goals. |
↳w player_stats[].w | decimalnullable | — | NHL only: chance the goalie is credited with the win, 0 to 1 (0 for a skater). |
↳sv player_stats[].sv | decimalnullable | — | NHL only: projected saves (0 for a skater). |
↳ga player_stats[].ga | decimalnullable | — | NHL only: projected goals against (0 for a skater). |
↳so player_stats[].so | decimalnullable | — | NHL only: chance of a shutout, 0 to 1 (0 for a skater). |
↳otl player_stats[].otl | decimalnullable | — | NHL only: chance the goalie is charged with the overtime loss, 0 to 1 (0 for a skater). |
↳hat_trick_probability player_stats[].hat_trick_probability | decimalnullable | — | NHL only: chance of 3 or more goals, 0 to 1. |
↳shots_5_probability player_stats[].shots_5_probability | decimalnullable | — | NHL only: chance of 5 or more shots on goal, 0 to 1. |
↳blocks_3_probability player_stats[].blocks_3_probability | decimalnullable | — | NHL only: chance of 3 or more blocked shots, 0 to 1. |
↳points_3_probability player_stats[].points_3_probability | decimalnullable | — | NHL only: chance of 3 or more points (goals plus assists), 0 to 1. |
↳saves_35_probability player_stats[].saves_35_probability | decimalnullable | — | NHL only: chance of 35 or more saves, 0 to 1. |
↳player_position player_stats[].player_position | stringnullable | — | NHL only: the player's position in our engine: C, W, D or G (the seat's `position` is the operator's: CPT on a captain seat, LW or RW on DraftKings). |
↳lineup_unit player_stats[].lineup_unit | stringnullable | — | NHL only: the player's unit in the lineup reading the projection used: line1 to line4, pair1 to pair3, pp1, pp2, goalie or injured; null without a reading. |
↳injury_tag player_stats[].injury_tag | stringnullable | — | NHL only: the injury tag of the lineup reading (IR, DTD, ...); null when none. |
↳relief_probability player_stats[].relief_probability | decimalnullable | — | NHL only: chance the goalie enters in relief, 0 to 1 (0 for a skater). |
↳pp_minutes_mean player_stats[].pp_minutes_mean | decimalnullable | — | NHL only: projected power-play time on ice, minutes (mean). |
↳sh_minutes_mean player_stats[].sh_minutes_mean | decimalnullable | — | NHL only: projected short-handed time on ice, minutes (mean). |
↳profile_id player_stats[].profile_id | bigintnullable | — | NBA and NHL: the contest segment (dfs.contest_profiles.id) of the ownership on this row; NBA contest projections only, null on a slate and on every NHL row (our NHL engine projects no ownership). |
↳ownership_model player_stats[].ownership_model | stringnullable | — | NBA only: the ownership model that wrote the row's ownership; contest projections only, null on a slate. |
teams | listnullable | — | Team projections and game pace for every team on the slate. Sent with the default format and with format=flat. Null when the team model fails for the slate. |
↳team_id teams[].team_id | bigint | — | Canonical team ID (references nfl.teams). |
↳team_code teams[].team_code | string | — | Team abbreviation code (e.g. DET, KC, LAR). |
↳opponent_team_id teams[].opponent_team_id | bigintnullable | — | Opponent team ID. |
↳opponent_team_code teams[].opponent_team_code | stringnullable | — | Opponent team abbreviation code. |
↳matchup_id teams[].matchup_id | bigintnullable | — | Unique slate game matchup identifier. |
↳primary_qb_player_id teams[].primary_qb_player_id | bigintnullable | — | Projected starting quarterback player ID. |
↳total_offensive_snaps teams[].total_offensive_snaps | decimal | — | Projected team total offensive snaps. |
↳implied_total teams[].implied_total | decimalnullable | — | Implied team total points from betting game line and spread. |
↳spread teams[].spread | decimalnullable | — | Point spread consensus line. |
↳game_total teams[].game_total | decimalnullable | — | Over/under game total consensus line. |
↳vegas_odds teams[].vegas_odds | objectnullable | — | Associated team game betting props. |
↳pass_play_pct teams[].pass_play_pct | decimal | — | Projected offensive passing play rate percentage. |
↳run_play_pct teams[].run_play_pct | decimal | — | Projected offensive rushing play rate percentage. |
↳seconds_per_play teams[].seconds_per_play | decimalnullable | — | Projected seconds per offensive play (nfl.projected_team_snaps). |
↳no_huddle_rate teams[].no_huddle_rate | decimalnullable | — | Projected no-huddle play rate (nfl.projected_team_snaps). |
↳pass_oe teams[].pass_oe | decimalnullable | — | Projected pass rate over expected (nfl.projected_team_snaps). |
↳projected_defensive_snaps teams[].projected_defensive_snaps | decimalnullable | — | Projected defensive snaps (nfl.projected_team_snaps). |
↳passing teams[].passing | object | — | Team passing volume totals. |
↳attempts teams[].passing.attempts | decimal | — | Projected team pass attempts. |
↳completions teams[].passing.completions | decimal | — | Projected team pass completions. |
↳yards teams[].passing.yards | decimal | — | Projected team passing yards. |
↳touchdowns teams[].passing.touchdowns | decimal | — | Projected team passing touchdowns. |
↳interceptions teams[].passing.interceptions | decimal | — | Projected team interceptions. |
↳targets teams[].passing.targets | decimal | — | Projected team pass targets. |
↳rushing teams[].rushing | object | — | Team rushing volume totals. |
↳attempts teams[].rushing.attempts | decimal | — | Projected team rushing attempts. |
↳yards teams[].rushing.yards | decimal | — | Projected team rushing yards. |
↳touchdowns teams[].rushing.touchdowns | decimal | — | Projected team rushing touchdowns. |
↳players teams[].players | list<object> | — | Distribution of projections across team skill position roster. |
↳game_id teams[].game_id | bigintnullable | — | NBA and NHL: the game (nba.games.id or nhl.games.id). |
↳is_home teams[].is_home | booleannullable | — | NBA and NHL: the team plays at home. |
↳possessions_mean teams[].possessions_mean | decimalnullable | — | NBA only: projected possessions (mean). |
↳possessions_p10 teams[].possessions_p10 | decimalnullable | — | NBA only: 10th percentile of the projected possessions. |
↳possessions_p50 teams[].possessions_p50 | decimalnullable | — | NBA only: median of the projected possessions. |
↳possessions_p90 teams[].possessions_p90 | decimalnullable | — | NBA only: 90th percentile of the projected possessions. |
↳pace_per_48 teams[].pace_per_48 | decimalnullable | — | NBA only: projected pace per 48 minutes. |
↳team_points_mean teams[].team_points_mean | decimalnullable | — | NBA only: projected team points (mean). |
↳team_points_std teams[].team_points_std | decimalnullable | — | NBA only: standard deviation of the projected team points. |
↳team_points_p10 teams[].team_points_p10 | decimalnullable | — | NBA only: 10th percentile of the projected team points. |
↳team_points_p25 teams[].team_points_p25 | decimalnullable | — | NBA only: 25th percentile of the projected team points. |
↳team_points_p50 teams[].team_points_p50 | decimalnullable | — | NBA only: median of the projected team points. |
↳team_points_p75 teams[].team_points_p75 | decimalnullable | — | NBA only: 75th percentile of the projected team points. |
↳team_points_p90 teams[].team_points_p90 | decimalnullable | — | NBA only: 90th percentile of the projected team points. |
↳opponent_points_mean teams[].opponent_points_mean | decimalnullable | — | NBA only: projected opponent points (mean). |
↳offensive_rating teams[].offensive_rating | decimalnullable | — | NBA only: projected offensive rating. |
↳win_probability teams[].win_probability | decimalnullable | — | NBA and NHL: chance the team wins, 0 to 1. |
↳overtime_probability teams[].overtime_probability | decimalnullable | — | NBA and NHL: chance the game goes to overtime, 0 to 1. |
↳reb_mean teams[].reb_mean | decimalnullable | — | NBA only: projected team rebounds. |
↳ast_mean teams[].ast_mean | decimalnullable | — | NBA only: projected team assists. |
↳stl_mean teams[].stl_mean | decimalnullable | — | NBA only: projected team steals. |
↳blk_mean teams[].blk_mean | decimalnullable | — | NBA only: projected team blocks. |
↳fg3m_mean teams[].fg3m_mean | decimalnullable | — | NBA only: projected team three-pointers made. |
↳tov_mean teams[].tov_mean | decimalnullable | — | NBA only: projected team turnovers. |
↳vegas_total teams[].vegas_total | decimalnullable | — | NBA and NHL: the game total of the betting line the projection used. |
↳vegas_spread teams[].vegas_spread | decimalnullable | — | NBA and NHL: the spread of the betting line the projection used, from this team's side (NHL: the puck line). |
↳implied_team_total teams[].implied_team_total | decimalnullable | — | NBA and NHL: the team total the betting line implies (NHL: goals). |
↳lines_captured_at teams[].lines_captured_at | timestamptznullable | — | NBA and NHL: time the betting line was captured (UTC). |
↳inputs_as_of teams[].inputs_as_of | timestamptznullable | — | NBA and NHL: time of the newest input of the team projection (UTC). |
↳goals_mean teams[].goals_mean | decimalnullable | — | NHL only: projected team goals, regulation and overtime (mean). |
↳goals_std teams[].goals_std | decimalnullable | — | NHL only: standard deviation of the projected team goals. |
↳goals_p10 teams[].goals_p10 | decimalnullable | — | NHL only: 10th percentile of the projected team goals. |
↳goals_p25 teams[].goals_p25 | decimalnullable | — | NHL only: 25th percentile of the projected team goals. |
↳goals_p50 teams[].goals_p50 | decimalnullable | — | NHL only: median of the projected team goals. |
↳goals_p75 teams[].goals_p75 | decimalnullable | — | NHL only: 75th percentile of the projected team goals. |
↳goals_p90 teams[].goals_p90 | decimalnullable | — | NHL only: 90th percentile of the projected team goals. |
↳opponent_goals_mean teams[].opponent_goals_mean | decimalnullable | — | NHL only: projected goals of the opponent (mean). |
↳empty_net_goals_mean teams[].empty_net_goals_mean | decimalnullable | — | NHL only: projected empty-net goals (mean). |
↳sog_mean teams[].sog_mean | decimalnullable | — | NHL only: projected team shots on goal (mean). |
↳sog_p10 teams[].sog_p10 | decimalnullable | — | NHL only: 10th percentile of the projected team shots on goal. |
↳sog_p50 teams[].sog_p50 | decimalnullable | — | NHL only: median of the projected team shots on goal. |
↳sog_p90 teams[].sog_p90 | decimalnullable | — | NHL only: 90th percentile of the projected team shots on goal. |
↳power_play_minutes_mean teams[].power_play_minutes_mean | decimalnullable | — | NHL only: projected power-play time, minutes (mean). |
↳shootout_probability teams[].shootout_probability | decimalnullable | — | NHL only: chance the game goes to a shootout, 0 to 1 (at most overtime_probability). |
↳vegas_moneyline teams[].vegas_moneyline | integernullable | — | NHL only: the team's moneyline of the betting line the projection used (American odds). |
projections | list | — | The player projections as nested rows, one per slate player: identity, distribution, opportunity, scoring breakdown, ownership, matchup, betting props and update provenance. Sent with the default format (no format param). An NFL row sends every field that is not marked NBA only, NBA and NHL, or NHL only; a value the projection does not have is null. An NBA row sends the groups player, projection, opportunity, breakdown, ownership and provenance, with the shared fields and the fields marked NBA only or NBA and NHL. An NHL row sends the same groups with the shared fields, the fields marked NBA and NHL and the fields marked NHL only; its ownership is null. |
↳player projections[].player | object | — | Player identity, team context, and slate metadata. |
↳id projections[].player.id | bigint | — | Unique slate player identifier. |
↳slate_player_id projections[].player.slate_player_id | bigint | — | Slate player ID (references dfs.slate_players.id). |
↳player_id projections[].player.player_id | bigintnullable | — | Canonical player ID in sport schema (references nfl.players.id). |
↳operator_player_id projections[].player.operator_player_id | stringnullable | — | Operator athlete identifier (from dfs.slate_players.external_id). |
↳operator_player_export_id projections[].player.operator_player_export_id | stringnullable | — | Operator export / draftable ID for lineup CSV uploads (from dfs.slate_players.export_id). |
↳name projections[].player.name | stringnullable | — | Player display name. |
↳position projections[].player.position | stringnullable | — | Contest roster position eligibility (e.g. QB, RB, WR, TE, DST, K). |
↳team projections[].player.team | stringnullable | — | Team abbreviation code (e.g. DET). |
↳opponent projections[].player.opponent | stringnullable | — | Opponent team abbreviation code (e.g. NO). |
↳salary projections[].player.salary | integernullable | — | Contest player salary in currency units (e.g. 8000). |
↳status projections[].player.status | stringnullable | — | Injury / roster status (e.g. Active, Questionable, Out). |
↳game_id projections[].player.game_id | bigintnullable | — | Canonical game ID. |
↳slate_date projections[].player.slate_date | stringnullable | — | Contest slate date (YYYY-MM-DD). |
↳player_game_note projections[].player.player_game_note | stringnullable | — | Contextual scouting and game note for player. |
↳projection projections[].projection | object | — | Fantasy points distribution, simulation bounds, and value ratio. |
↳fantasy_pts projections[].projection.fantasy_pts | decimalnullable | — | Mean projected fantasy points under contest scoring rules. |
↳floor projections[].projection.floor | decimalnullable | — | 10th percentile fantasy point outcome (floor). |
↳ceiling projections[].projection.ceiling | decimalnullable | — | 90th percentile fantasy point outcome (ceiling). |
↳std_dev projections[].projection.std_dev | decimalnullable | — | Standard deviation of projected fantasy point distribution. |
↳value projections[].projection.value | decimalnullable | — | Projected fantasy points per $1k of salary (pts / (salary / 1000)). |
↳quantiles projections[].projection.quantiles | objectnullable | — | Quantile simulation distribution outcomes across Monte Carlo runs. |
↳p05 projections[].projection.quantiles.p05 | decimalnullable | — | 5th percentile outcome. |
↳p10 projections[].projection.quantiles.p10 | decimalnullable | — | 10th percentile outcome. |
↳p15 projections[].projection.quantiles.p15 | decimalnullable | — | 15th percentile outcome. |
↳p25 projections[].projection.quantiles.p25 | decimalnullable | — | 25th percentile outcome. |
↳p50 projections[].projection.quantiles.p50 | decimalnullable | — | 50th percentile (median) outcome. |
↳p75 projections[].projection.quantiles.p75 | decimalnullable | — | 75th percentile outcome. |
↳p85 projections[].projection.quantiles.p85 | decimalnullable | — | 85th percentile outcome. |
↳p90 projections[].projection.quantiles.p90 | decimalnullable | — | 90th percentile outcome. |
↳p95 projections[].projection.quantiles.p95 | decimalnullable | — | 95th percentile outcome. |
↳seat_multiplier projections[].projection.seat_multiplier | decimalnullable | — | NBA and NHL: the seat's score multiplier (DraftKings CPT 1.5, FanDuel MVP 1.5; 1 for every other seat). The points fields are already multiplied. |
↳chance_5x projections[].projection.chance_5x | decimalnullable | — | NBA and NHL: chance the seat's points reach 5x salary / 1000, 0 to 1; null without a salary. |
↳chance_5x_bound projections[].projection.chance_5x_bound | stringnullable | — | NBA and NHL: set when chance_5x is a bound: above_99pct or below_1pct. Values:above_99pctbelow_1pct |
↳chance_6x projections[].projection.chance_6x | decimalnullable | — | NBA and NHL: chance the seat's points reach 6x salary / 1000, 0 to 1; null without a salary. |
↳chance_6x_bound projections[].projection.chance_6x_bound | stringnullable | — | NBA and NHL: set when chance_6x is a bound. Values:above_99pctbelow_1pct |
↳opportunity projections[].opportunity | object | — | Volume and snap share opportunity metrics. |
↳snap_pct projections[].opportunity.snap_pct | decimalnullable | — | Projected offensive snap percentage (0-100%). |
↳projected_snaps projections[].opportunity.projected_snaps | decimalnullable | — | Projected offensive snaps. |
↳projected_team_snaps projections[].opportunity.projected_team_snaps | decimalnullable | — | Projected team total offensive snaps. |
↳carries projections[].opportunity.carries | decimalnullable | — | Projected rushing attempts. |
↳targets projections[].opportunity.targets | decimalnullable | — | Projected receiving targets. |
↳receptions projections[].opportunity.receptions | decimalnullable | — | Projected receptions. |
↳catch_rate projections[].opportunity.catch_rate | decimalnullable | — | Projected reception catch rate percentage. |
↳passing_attempts projections[].opportunity.passing_attempts | decimalnullable | — | Projected passing attempts (QB only). |
↳passing_completions projections[].opportunity.passing_completions | decimalnullable | — | Projected passing completions (QB only). |
↳minutes_mean projections[].opportunity.minutes_mean | decimalnullable | — | NBA and NHL: projected minutes (mean); on NHL the projected time on ice. |
↳minutes_std projections[].opportunity.minutes_std | decimalnullable | — | NBA and NHL: standard deviation of the projected minutes. |
↳minutes_p10 projections[].opportunity.minutes_p10 | decimalnullable | — | NBA and NHL: 10th percentile of the projected minutes. |
↳minutes_p25 projections[].opportunity.minutes_p25 | decimalnullable | — | NBA and NHL: 25th percentile of the projected minutes. |
↳minutes_p50 projections[].opportunity.minutes_p50 | decimalnullable | — | NBA and NHL: median of the projected minutes. |
↳minutes_p75 projections[].opportunity.minutes_p75 | decimalnullable | — | NBA and NHL: 75th percentile of the projected minutes. |
↳minutes_p90 projections[].opportunity.minutes_p90 | decimalnullable | — | NBA and NHL: 90th percentile of the projected minutes. |
↳usage_rate projections[].opportunity.usage_rate | decimalnullable | — | NBA only: projected usage rate, 0 to 1. |
↳play_probability projections[].opportunity.play_probability | decimalnullable | — | NBA and NHL: chance the player plays, 0 to 1 (NHL: the chance the player dresses for the game). |
↳start_probability projections[].opportunity.start_probability | decimalnullable | — | NBA and NHL: chance the player starts, 0 to 1. |
↳player_position projections[].opportunity.player_position | stringnullable | — | NHL only: the player's position in our engine: C, W, D or G (the seat's `position` is the operator's: CPT on a captain seat, LW or RW on DraftKings). |
↳lineup_unit projections[].opportunity.lineup_unit | stringnullable | — | NHL only: the player's unit in the lineup reading the projection used: line1 to line4, pair1 to pair3, pp1, pp2, goalie or injured; null without a reading. |
↳injury_tag projections[].opportunity.injury_tag | stringnullable | — | NHL only: the injury tag of the lineup reading (IR, DTD, ...); null when none. |
↳relief_probability projections[].opportunity.relief_probability | decimalnullable | — | NHL only: chance the goalie enters in relief, 0 to 1 (0 for a skater). |
↳pp_minutes_mean projections[].opportunity.pp_minutes_mean | decimalnullable | — | NHL only: projected power-play time on ice, minutes (mean). |
↳sh_minutes_mean projections[].opportunity.sh_minutes_mean | decimalnullable | — | NHL only: projected short-handed time on ice, minutes (mean). |
↳breakdown projections[].breakdown | object | — | Granular fantasy point component breakdown and counting stats. |
↳passing_yds projections[].breakdown.passing_yds | decimalnullable | — | Projected passing yards. |
↳passing_tds projections[].breakdown.passing_tds | decimalnullable | — | Projected passing touchdowns. |
↳passing_yds_fpts projections[].breakdown.passing_yds_fpts | decimalnullable | — | Fantasy points from passing yards. |
↳passing_td_fpts projections[].breakdown.passing_td_fpts | decimalnullable | — | Fantasy points from passing touchdowns. |
↳interception_fpts projections[].breakdown.interception_fpts | decimalnullable | — | Fantasy point deduction from interceptions. |
↳rushing_yds projections[].breakdown.rushing_yds | decimalnullable | — | Projected rushing yards. |
↳rushing_tds projections[].breakdown.rushing_tds | decimalnullable | — | Projected rushing touchdowns. |
↳rushing_yds_fpts projections[].breakdown.rushing_yds_fpts | decimalnullable | — | Fantasy points from rushing yards. |
↳rushing_td_fpts projections[].breakdown.rushing_td_fpts | decimalnullable | — | Fantasy points from rushing touchdowns. |
↳receiving_yds projections[].breakdown.receiving_yds | decimalnullable | — | Projected receiving yards. |
↳receiving_tds projections[].breakdown.receiving_tds | decimalnullable | — | Projected receiving touchdowns. |
↳receiving_yds_fpts projections[].breakdown.receiving_yds_fpts | decimalnullable | — | Fantasy points from receiving yards. |
↳reception_fpts projections[].breakdown.reception_fpts | decimalnullable | — | Fantasy points from receptions (PPR / half-PPR). |
↳receiving_td_fpts projections[].breakdown.receiving_td_fpts | decimalnullable | — | Fantasy points from receiving touchdowns. |
↳bonus_fpts projections[].breakdown.bonus_fpts | decimalnullable | — | Fantasy points from milestone performance bonuses (e.g. 100+ rush/rec, 300+ pass). |
↳defensive_td_fpts projections[].breakdown.defensive_td_fpts | decimalnullable | — | Fantasy points from defensive touchdowns (DST). |
↳sack_fpts projections[].breakdown.sack_fpts | decimalnullable | — | Fantasy points from sacks (DST). |
↳pts_allowed_fpts projections[].breakdown.pts_allowed_fpts | decimalnullable | — | Fantasy points from points allowed tiers (DST). |
↳pts projections[].breakdown.pts | decimalnullable | — | NBA only: projected points (the stat). |
↳reb projections[].breakdown.reb | decimalnullable | — | NBA only: projected rebounds. |
↳ast projections[].breakdown.ast | decimalnullable | — | NBA only: projected assists. |
↳stl projections[].breakdown.stl | decimalnullable | — | NBA only: projected steals. |
↳g projections[].breakdown.g | decimalnullable | — | NHL only: projected goals (regulation and overtime; a shootout goal is so_g). |
↳a projections[].breakdown.a | decimalnullable | — | NHL only: projected assists. |
↳sog projections[].breakdown.sog | decimalnullable | — | NHL only: projected shots on goal. |
↳blk projections[].breakdown.blk | decimalnullable | — | NBA and NHL: projected blocks (NBA) or blocked shots (NHL). |
↳fg3m projections[].breakdown.fg3m | decimalnullable | — | NBA only: projected three-pointers made. |
↳tov projections[].breakdown.tov | decimalnullable | — | NBA only: projected turnovers. |
↳double_double_probability projections[].breakdown.double_double_probability | decimalnullable | — | NBA only: chance of a double-double, 0 to 1. |
↳triple_double_probability projections[].breakdown.triple_double_probability | decimalnullable | — | NBA only: chance of a triple-double, 0 to 1. |
↳ppg projections[].breakdown.ppg | decimalnullable | — | NHL only: projected power-play goals (a part of g). |
↳ppa projections[].breakdown.ppa | decimalnullable | — | NHL only: projected power-play assists (a part of a). |
↳shg projections[].breakdown.shg | decimalnullable | — | NHL only: projected short-handed goals (a part of g). |
↳sha projections[].breakdown.sha | decimalnullable | — | NHL only: projected short-handed assists (a part of a). |
↳so_g projections[].breakdown.so_g | decimalnullable | — | NHL only: projected shootout goals. |
↳w projections[].breakdown.w | decimalnullable | — | NHL only: chance the goalie is credited with the win, 0 to 1 (0 for a skater). |
↳sv projections[].breakdown.sv | decimalnullable | — | NHL only: projected saves (0 for a skater). |
↳ga projections[].breakdown.ga | decimalnullable | — | NHL only: projected goals against (0 for a skater). |
↳so projections[].breakdown.so | decimalnullable | — | NHL only: chance of a shutout, 0 to 1 (0 for a skater). |
↳otl projections[].breakdown.otl | decimalnullable | — | NHL only: chance the goalie is charged with the overtime loss, 0 to 1 (0 for a skater). |
↳hat_trick_probability projections[].breakdown.hat_trick_probability | decimalnullable | — | NHL only: chance of 3 or more goals, 0 to 1. |
↳shots_5_probability projections[].breakdown.shots_5_probability | decimalnullable | — | NHL only: chance of 5 or more shots on goal, 0 to 1. |
↳blocks_3_probability projections[].breakdown.blocks_3_probability | decimalnullable | — | NHL only: chance of 3 or more blocked shots, 0 to 1. |
↳points_3_probability projections[].breakdown.points_3_probability | decimalnullable | — | NHL only: chance of 3 or more points (goals plus assists), 0 to 1. |
↳saves_35_probability projections[].breakdown.saves_35_probability | decimalnullable | — | NHL only: chance of 35 or more saves, 0 to 1. |
↳ownership projections[].ownership | objectnullable | — | Projected crowd ownership and bounds. On /dfs/slates/{slate_id}/projections, returns the array of the slate's representative (contest_kind, size_tier) contest segments (gpp then cash, ordered from largest size_tier down) when profile segment ownership rows exist (NBA slates and NFL STAT_API_LATEST slates), or the single ownership summary object on historical NFL slates; on /dfs/contests/{contest_id}/projections, returns that contest's ownership object. On single-game / Showdown slates, each segment object also includes slot (CPT, MVP, STAR, PRO, or FLEX), captain_ownership, flex_ownership, total_ownership, and captain_ratio. |
↳projected_ownership projections[].ownership.projected_ownership | decimalnullable | — | Projected roster share in decimal form (0.0000 - 1.0000). |
↳ownership_pct projections[].ownership.ownership_pct | decimalnullable | — | Projected roster percentage formatted as 0-100% (e.g. 15.5 for 15.5%). |
↳volatility projections[].ownership.volatility | decimalnullable | — | Standard deviation of projected ownership percentage across simulations. |
↳low projections[].ownership.low | decimalnullable | — | 10th percentile crowd ownership lower bound (0.0000 - 1.0000 in segment objects; 0-100% in legacy summary). |
↳high projections[].ownership.high | decimalnullable | — | 90th percentile crowd ownership upper bound (0.0000 - 1.0000 in segment objects; 0-100% in legacy summary). |
↳chalk_fragility projections[].ownership.chalk_fragility | decimalnullable | — | Sensitivity of player ownership to salary cap allocations [0, 1]. |
↳cash_projected_ownership projections[].ownership.cash_projected_ownership | decimalnullable | — | Projected roster share in cash game double-ups / 50-50s (0.0000 - 1.0000). |
↳cash_ownership_pct projections[].ownership.cash_ownership_pct | decimalnullable | — | Projected roster percentage in cash games formatted as 0-100% (e.g. 12.3 for 12.3%). |
↳slot projections[].ownership.slot | stringnullable | — | Single-game / Showdown slates: the seat's lineup slot role (CPT, MVP, STAR, PRO, or FLEX). Omitted on classic slates. |
↳captain_ownership projections[].ownership.captain_ownership | decimalnullable | — | Projected Captain / MVP seat roster share in single-game / Showdown slates (0.0000 - 1.0000 in segment objects and NBA rows; 0-100% in legacy NFL summary). |
↳flex_ownership projections[].ownership.flex_ownership | decimalnullable | — | Projected FLEX utility seat roster share in single-game / Showdown slates (0.0000 - 1.0000 in segment objects and NBA rows; 0-100% in legacy NFL summary). |
↳total_ownership projections[].ownership.total_ownership | decimalnullable | — | Total combined roster share across all seats (Captain + FLEX, plus STAR/PRO when present) of the player in that segment (0.0000 - 1.0000 in segment objects and NBA rows; 0-100% in legacy NFL summary). |
↳captain_ratio projections[].ownership.captain_ratio | decimalnullable | — | Ratio of Captain / MVP ownership relative to total ownership (0.0000 - 1.0000). |
↳profile_id projections[].ownership.profile_id | bigintnullable | — | The contest segment (dfs.contest_profiles.id) the ownership belongs to. |
↳contest_kind projections[].ownership.contest_kind | stringnullable | — | Contest segment kind on slate segment arrays: gpp or cash. |
↳size_tier projections[].ownership.size_tier | stringnullable | — | Contest segment field size tier on slate segment arrays (100k+, 10k-100k, 1k-10k, 101-1k, 3-100, 2). |
↳multi_entry_per_user_band projections[].ownership.multi_entry_per_user_band | stringnullable | — | Contest segment per-user entry limit band on slate segment arrays (1, 2-5, 6-19, 20+). |
↳fee_tier projections[].ownership.fee_tier | stringnullable | — | Contest segment entry fee tier on slate segment arrays. |
↳model projections[].ownership.model | stringnullable | — | NBA contest route: the ownership model that wrote the row. |
↳inputs_as_of projections[].ownership.inputs_as_of | timestamptznullable | — | NBA contest route: time of the newest input of the ownership projection (UTC). |
↳dvp projections[].dvp | objectnullable | — | Defense vs Position (DvP) matchup ratings, scheme metrics, and qualitative context. |
↳archetype projections[].dvp.archetype | stringnullable | — | Player usage archetype (e.g. Pass-Catching Back, Deep Threat, Slot). |
↳rank projections[].dvp.rank | integernullable | — | Opponent defense positional ranking against archetype (1 = best matchup / 32 = worst). |
↳rating projections[].dvp.rating | decimalnullable | — | Matchup rating multiplier or score. |
↳matchup projections[].dvp.matchup | stringnullable | — | Matchup label (e.g. Favorable, Neutral, Tough). |
↳explanation projections[].dvp.explanation | stringnullable | — | Qualitative analytical explanation of defensive matchup. |
↳metrics projections[].dvp.metrics | objectnullable | — | Detailed defensive metrics breakdown. |
↳rank projections[].dvp.metrics.rank | integernullable | — | Opponent defense ranking vs archetype. |
↳archetype projections[].dvp.metrics.archetype | stringnullable | — | Target archetype. |
↳multiplier projections[].dvp.metrics.multiplier | decimalnullable | — | DvP projection multiplier applied. |
↳explanation projections[].dvp.metrics.explanation | stringnullable | — | Detailed qualitative explanation. |
↳matchup_grade projections[].dvp.metrics.matchup_grade | stringnullable | — | Letter grade or qualitative category. |
↳fpts_allowed_pg projections[].dvp.metrics.fpts_allowed_pg | decimalnullable | — | Fantasy points allowed per game to archetype. |
↳league_avg_fpts projections[].dvp.metrics.league_avg_fpts | decimalnullable | — | League average fantasy points per game to archetype. |
↳def_adot_allowed projections[].dvp.metrics.def_adot_allowed | decimalnullable | — | Defensive average depth of target allowed. |
↳def_pressure_rate projections[].dvp.metrics.def_pressure_rate | decimalnullable | — | Defensive pressure rate. |
↳opponent_team_code projections[].dvp.metrics.opponent_team_code | stringnullable | — | Opponent team abbreviation code. |
↳scheme_metrics projections[].dvp.scheme_metrics | objectnullable | — | Scheme-specific indicators (man/zone frequency, blitz rate, etc.). |
↳opponent projections[].dvp.scheme_metrics.opponent | stringnullable | — | Opponent team abbreviation code. |
↳composite projections[].dvp.scheme_metrics.composite | decimalnullable | — | Composite scheme matchup score. |
↳shadow_cb projections[].dvp.scheme_metrics.shadow_cb | stringnullable | — | Shadow cornerback assignment if active. |
↳db_injuries projections[].dvp.scheme_metrics.db_injuries | list<object>nullable | — | Opponent defensive back injuries impacting scheme. |
↳funnel_tilt projections[].dvp.scheme_metrics.funnel_tilt | decimalnullable | — | Run/pass funnel defensive tilt factor. |
↳scheme_mult projections[].dvp.scheme_metrics.scheme_mult | decimalnullable | — | Scheme matchup multiplier. |
↳injury_boost projections[].dvp.scheme_metrics.injury_boost | decimalnullable | — | Injury adjustment boost multiplier. |
↳pressure_mult projections[].dvp.scheme_metrics.pressure_mult | decimalnullable | — | Pressure rate multiplier. |
↳rb_target_rate_allowed projections[].dvp.scheme_metrics.rb_target_rate_allowed | decimalnullable | — | Defensive target rate allowed to running backs. |
↳te_target_rate_allowed projections[].dvp.scheme_metrics.te_target_rate_allowed | decimalnullable | — | Defensive target rate allowed to tight ends. |
↳two_high_shell_rate projections[].dvp.scheme_metrics.two_high_shell_rate | decimalnullable | — | Defensive two-high safety shell rate. |
↳vegas_odds projections[].vegas_odds | objectnullable | — | Active player betting lines and props used as model calibration anchors. |
↳anytime_td projections[].vegas_odds.anytime_td | integernullable | — | Anytime touchdown odds (American format). |
↳first_td projections[].vegas_odds.first_td | integernullable | — | First touchdown odds. |
↳last_td projections[].vegas_odds.last_td | integernullable | — | Last touchdown odds. |
↳rushing_yds projections[].vegas_odds.rushing_yds | decimalnullable | — | Rushing yards consensus betting line. |
↳receiving_yds projections[].vegas_odds.receiving_yds | decimalnullable | — | Receiving yards consensus betting line. |
↳receptions projections[].vegas_odds.receptions | decimalnullable | — | Receptions consensus betting line. |
↳rushing_attempts projections[].vegas_odds.rushing_attempts | decimalnullable | — | Rushing attempts betting line. |
↳passing_yards projections[].vegas_odds.passing_yards | decimalnullable | — | Passing yards consensus betting line. |
↳passing_tds projections[].vegas_odds.passing_tds | decimalnullable | — | Passing touchdowns consensus betting line. |
↳passing_yds projections[].vegas_odds.passing_yds | decimalnullable | — | Passing yards consensus betting line. |
↳passing_attempts projections[].vegas_odds.passing_attempts | decimalnullable | — | Passing attempts consensus betting line. |
↳completions projections[].vegas_odds.completions | decimalnullable | — | Pass completions consensus betting line. |
↳interceptions projections[].vegas_odds.interceptions | decimalnullable | — | Passing interceptions consensus betting line. |
↳provenance projections[].provenance | objectnullable | — | Projection update history, audit timestamps, and explanation of adjustments. |
↳last_update_time projections[].provenance.last_update_time | stringnullable | — | ISO-8601 UTC timestamp of most recent projection adjustment. |
↳update_explanation projections[].provenance.update_explanation | stringnullable | — | Human-readable explanation of why projection was updated (e.g. injury news, weather). |
↳update_reason projections[].provenance.update_reason | objectnullable | — | Structured metadata describing event triggering update. |
↳primary_code projections[].provenance.update_reason.primary_code | stringnullable | — | Primary change classification code (e.g. DEFENSE_DEGRADED). |
↳secondary_codes projections[].provenance.update_reason.secondary_codes | list<S>nullable | — | Secondary change classification codes. |
↳factors projections[].provenance.update_reason.factors | objectnullable | — | Detailed factor adjustments triggering projection update. |
↳update_history projections[].provenance.update_history | listnullable | — | Chronological audit trail of prior projection snapshots. |
↳id projections[].provenance.update_history[].id | string | — | Snapshot change identifier. |
↳timestamp projections[].provenance.update_history[].timestamp | string | — | UTC timestamp of snapshot. |
↳explanation projections[].provenance.update_history[].explanation | stringnullable | — | Change explanation text. |
↳reason projections[].provenance.update_history[].reason | objectnullable | — | Event trigger that provoked update. |
↳current_value projections[].provenance.update_history[].current_value | objectnullable | — | New projection values after adjustment. |
↳previous_value projections[].provenance.update_history[].previous_value | objectnullable | — | Prior projection values before adjustment. |
↳play_profile projections[].play_profile | objectnullable | — | Complete native play profile with upside and safety metrics, empirical boom/bust probabilities, and archetype. |
↳upside projections[].play_profile.upside | objectnullable | — | Upside and ceiling distribution metrics. |
↳tier projections[].play_profile.upside.tier | stringnullable | — | Salary-adjusted upside tier (ELITE, BOOM, STEADY, LOW_CAP). |
↳ceiling_multiplier projections[].play_profile.upside.ceiling_multiplier | decimalnullable | — | Salary-adjusted ceiling multiplier (ceiling / (salary / 1000)). |
↳boom_probability projections[].play_profile.upside.boom_probability | decimalnullable | — | Probability of reaching 4.0x boom value. |
↳leverage_factor projections[].play_profile.upside.leverage_factor | decimalnullable | — | Tournament leverage factor. |
↳safety projections[].play_profile.safety | objectnullable | — | Safety and floor stability metrics. |
↳tier projections[].play_profile.safety.tier | stringnullable | — | Cash safety tier (CORE_CASH, CASH_VIABLE, MODERATE, HIGH_RISK). |
↳floor_multiplier projections[].play_profile.safety.floor_multiplier | decimalnullable | — | Salary-adjusted floor multiplier. |
↳bust_probability projections[].play_profile.safety.bust_probability | decimalnullable | — | Probability of falling below 1.5x salary value. |
↳chalk_fragility projections[].play_profile.safety.chalk_fragility | decimalnullable | — | Chalk fragility rating. |
↳play_archetype projections[].play_profile.play_archetype | stringnullable | — | Archetype classification. |
↳is_leverage projections[].play_profile.is_leverage | booleannullable | — | Whether player is a top leverage candidate. |
↳is_fragile_chalk projections[].play_profile.is_fragile_chalk | booleannullable | — | Whether player represents fragile chalk. |
↳analysis projections[].play_profile.analysis | objectnullable | — | Qualitative analytical breakdowns and recommendations. |
↳headline projections[].play_profile.analysis.headline | stringnullable | — | Synthesized headline summarizing player outlook. |
↳cash_analysis projections[].play_profile.analysis.cash_analysis | objectnullable | — | Detailed cash game outlook. |
↳status projections[].play_profile.analysis.cash_analysis.status | stringnullable | — | Cash status (CORE_CASH, CASH_VIABLE, NEUTRAL, UNVIABLE). |
↳verdict projections[].play_profile.analysis.cash_analysis.verdict | stringnullable | — | Cash game verdict narrative. |
↳key_positives projections[].play_profile.analysis.cash_analysis.key_positives | list<S>nullable | — | Positive factors supporting cash game viability. |
↳key_risks projections[].play_profile.analysis.cash_analysis.key_risks | list<S>nullable | — | Downside risks impacting cash game safety. |
↳cohort_comparison projections[].play_profile.analysis.cash_analysis.cohort_comparison | stringnullable | — | Performance comparison relative to salary cohort. |
↳gpp_analysis projections[].play_profile.analysis.gpp_analysis | objectnullable | — | Detailed GPP tournament outlook. |
↳status projections[].play_profile.analysis.gpp_analysis.status | stringnullable | — | GPP status. |
↳verdict projections[].play_profile.analysis.gpp_analysis.verdict | stringnullable | — | Tournament verdict narrative. |
↳ceiling_thesis projections[].play_profile.analysis.gpp_analysis.ceiling_thesis | stringnullable | — | Upside potential thesis. |
↳leverage_thesis projections[].play_profile.analysis.gpp_analysis.leverage_thesis | stringnullable | — | Ownership leverage thesis. |
↳pivot_recommendation projections[].play_profile.analysis.gpp_analysis.pivot_recommendation | stringnullable | — | Suggested tournament pivots. |
↳comparative_context projections[].play_profile.analysis.comparative_context | objectnullable | — | Relative rankings and cohort differentials. |
↳positional_floor_rank projections[].play_profile.analysis.comparative_context.positional_floor_rank | stringnullable | — | Positional floor ranking text. |
↳positional_ceiling_rank projections[].play_profile.analysis.comparative_context.positional_ceiling_rank | stringnullable | — | Positional ceiling ranking text. |
↳positional_ownership_rank projections[].play_profile.analysis.comparative_context.positional_ownership_rank | stringnullable | — | Positional ownership ranking text. |
↳floor_vs_position_median projections[].play_profile.analysis.comparative_context.floor_vs_position_median | stringnullable | — | Floor points differential relative to positional median. |
↳value_vs_salary_cohort projections[].play_profile.analysis.comparative_context.value_vs_salary_cohort | stringnullable | — | Value differential relative to salary tier. |
↳tactical_tag projections[].play_profile.tactical_tag | stringnullable | — | Tactical play tag (e.g. GOOD_CHALK, FRAGILE_CHALK, LEVERAGE). |
↳fade_leverage_score projections[].play_profile.fade_leverage_score | decimalnullable | — | Quantitative score for fading the player in tournaments. |
↳knapsack_shadow_price projections[].play_profile.knapsack_shadow_price | decimalnullable | — | Knapsack constraint shadow price indicating marginal point value per dollar. |
↳relative_fragility projections[].play_profile.relative_fragility | decimalnullable | — | Normalized fragility relative to slate position peers. |
↳upside_tier projections[].upside_tier | stringnullable | — | Salary-adjusted upside tier (ELITE, BOOM, STEADY, LOW_CAP). |
↳ceiling_multiplier projections[].ceiling_multiplier | decimalnullable | — | Salary-adjusted ceiling multiplier (ceiling / (salary / 1000)). |
↳boom_probability projections[].boom_probability | decimalnullable | — | Empirical probability of scoring >= 4.0x salary in 10,000 Monte Carlo simulations. |
↳cash_safety_tier projections[].cash_safety_tier | stringnullable | — | Salary-adjusted cash safety tier (CORE_CASH, CASH_VIABLE, MODERATE, HIGH_RISK). |
↳floor_multiplier projections[].floor_multiplier | decimalnullable | — | Salary-adjusted floor multiplier (floor / (salary / 1000)). |
↳bust_probability projections[].bust_probability | decimalnullable | — | Empirical probability of scoring < 1.5x salary in 10,000 Monte Carlo simulations. |
↳play_archetype projections[].play_archetype | stringnullable | — | Summary archetype classification (GPP_BOOM, CORE_CASH, LEVERAGE, FRAGILE_CHALK, BALANCED, LOW_CAP). |
↳leverage_factor projections[].leverage_factor | decimalnullable | — | Tournament leverage factor (ceiling_multiplier / max(0.02, ownership)). |
↳analysis_headline projections[].analysis_headline | stringnullable | — | Synthesized qualitative headline capturing player role, floor equity, or ceiling upside. |
↳cash_verdict projections[].cash_verdict | stringnullable | — | Qualitative cash game analysis verdict with touch/floor security and bust risk reasoning. |
↳gpp_verdict projections[].gpp_verdict | stringnullable | — | Qualitative GPP tournament analysis verdict with ceiling potential and ownership leverage reasoning. |
↳tactical_tag projections[].tactical_tag | stringnullable | — | Tactical play tag (e.g. GOOD_CHALK, FRAGILE_CHALK, LEVERAGE). |
↳fade_leverage_score projections[].fade_leverage_score | decimalnullable | — | Quantitative score for fading the player in tournaments. |
↳knapsack_shadow_price projections[].knapsack_shadow_price | decimalnullable | — | Knapsack constraint shadow price indicating marginal point value per dollar. |
↳relative_fragility projections[].relative_fragility | decimalnullable | — | Normalized fragility relative to slate position peers. |
_metadata | objectnullable | — | Which projection source served this response, and which stat-api engine made its rows. Sent last, with the default format and with format=flat. The `source` object describes the served source. |
↳requested_source _metadata.requested_source | string | — | The source the request asked for, the `source` parameter, else the default (STAT_API_LATEST). |
↳served_source _metadata.served_source | string | — | The source whose rows this response holds. It differs from `requested_source` when STAT_API_LATEST serves a request for STAT_API, or when STAT_API serves a slate that STAT_API_LATEST has no projections for (`fallback`). A slate served per game by both sources gives "STAT_API,STAT_API_LATEST" (see `fallback_games`). |
↳engine_version _metadata.engine_version | stringnullable | — | The stat-api engine version of the served rows, for example "2.2". A row without a version is "2.1". Rows of several versions give a comma-separated list. Null when the response holds no rows. |
↳deprecated _metadata.deprecated | boolean | — | True when the requested source is deprecated. STAT_API is deprecated, and STAT_API_LATEST serves it. |
↳replacement _metadata.replacement | stringnullable | — | The source that replaces the deprecated requested source (STAT_API_LATEST). Null when `deprecated` is false. |
↳backfilled _metadata.backfilled | boolean | — | True when any served row is a backfill: a projection written after the slate locked, for a slate that locked before its engine went live. |
↳fallback _metadata.fallback | boolean | — | True when the request was for STAT_API or named no source, and STAT_API served this slate, or the games of it that STAT_API_LATEST has no projections for (`fallback_games`). The source is chosen per game: STAT_API_LATEST serves every game of the slate it has projections for; STAT_API (engine 2.1) serves only a game without them that kicked off before the slate's first STAT_API_LATEST projection was written (the Thursday game of a Thursday-to-Monday slate); every other game without them gets no projection (`pending_games`). |
↳note _metadata.note | stringnullable | — | The same facts in one sentence. Null when the requested source is not deprecated, did not fall back and has no pending game. |
↳fallback_games _metadata.fallback_games | list<L>nullable | — | The NFL games (`game_id`) of the slate whose rows come from STAT_API because STAT_API_LATEST has no projections for them, while STAT_API_LATEST served the other games; `served_source` then names both sources. Only games that kicked off before the slate's first STAT_API_LATEST projection was written. Sent only then (absent otherwise). |
↳pending_games _metadata.pending_games | list<L>nullable | — | The NFL games (`game_id`) of a slate that STAT_API_LATEST serves in part, that have no STAT_API_LATEST projections and did not kick off before the slate's first one was written: their players have no points projection in this response (no 2.1 value stands in; a stored contest ownership may still show). Sent only when there is one (absent otherwise). |
GET/api/v1/dfs/slates/seasonsDFS contest slate seasons and schedule manifest
sportquerystringoptionalleague_idquerybigintoptionalcurl -sS --compressed \
-H 'Authorization: Bearer YOUR_API_KEY' \
'https://api.stat-api.com/api/v1/dfs/slates/seasons?sport=nfl'200DFS contest slate seasons and schedule manifestapplication/jsonshow example ▸
Response Schema(6 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
sport | string | — | Sport code. |
league_id | bigint | — | Numeric league ID. |
earliest_date | stringnullable | — | Earliest slate date on file (YYYY-MM-DD). |
latest_date | stringnullable | — | Latest slate date on file (YYYY-MM-DD). |
total_slates | bigint | — | Total slates across all seasons. |
seasons | list | — | List of available seasons with week breakdowns. |
↳season seasons[].season | integer | — | Season start year (e.g. 2026). |
↳slate_count seasons[].slate_count | bigint | — | Total slates in this season. |
↳contest_count seasons[].contest_count | bigint | — | Total contests in this season. |
↳earliest_date seasons[].earliest_date | stringnullable | — | Earliest slate date in this season. |
↳latest_date seasons[].latest_date | stringnullable | — | Latest slate date in this season. |
↳min_week seasons[].min_week | integer | — | Minimum available week. |
↳max_week seasons[].max_week | integer | — | Maximum available week. |
↳available_weeks seasons[].available_weeks | list<I> | — | Regular-season week numbers that have at least one slate. |
↳weeks seasons[].weeks | list | — | Every regular-season week of the schedule, with its window and slate counts (NFL). Other sports return one entry per calendar year. |
↳week seasons[].weeks[].week | integer | — | Regular-season week number. |
↳start_date seasons[].weeks[].start_date | stringnullable | — | First day of the week window (YYYY-MM-DD, US Eastern). Null outside the NFL. |
↳end_date seasons[].weeks[].end_date | stringnullable | — | Last day of the week window, the week's last game day (YYYY-MM-DD, US Eastern). Null outside the NFL. |
↳slate_count seasons[].weeks[].slate_count | bigint | — | Slates whose lock date falls in the window (0 for a week with no slate yet). |
↳contest_count seasons[].weeks[].contest_count | bigint | — | Contests on those slates. |
↳min_date seasons[].weeks[].min_date | stringnullable | — | First slate date in the window. Null when the week has no slate. |
↳max_date seasons[].weeks[].max_date | stringnullable | — | Last slate date in the window. Null when the week has no slate. |
POST/api/v1/dfs/slates/{slate_id}/lineupsBuild ROI-optimized lineups for a slate or contest with SIM + strategy guardrailsbeta
slate_idpathbigintrequiredlineup_countintegeroptionalin example = 20Number of lineups to select in the final portfolio (`1` to `500`, default `20`). Ignored in late-swap mode (`entries_csv`/`entries`), which always returns 1:1 entries preserving every contest seat.
In fresh SIM builds and `pool_id` re-selection, the portfolio picker grows a large simulated candidate pool and selects the top `lineup_count` entries optimizing joint contest Added EV.
20Range:1..=500Build 20 EV-maximizing lineups priced against contest 81183052 with a QB+2WR stack, 1 lock, and a field ownership override.
curl -sS --compressed -X POST \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-H 'Prefer: wait' \
'https://api.stat-api.com/api/v1/dfs/slates/1045169/lineups' \
-d '{
"contest_id": 81183052,
"lineup_count": 20,
"lineup_stacks": [
{
"positions": [
"QB",
"WR",
"WR"
],
"bring_back_count": 1
}
],
"players": [
{
"slate_player_id": 43912853,
"lock": true
},
{
"slate_player_id": 43912847,
"player_field_ownership": 40
}
]
}'200Build ROI-optimized lineups for a slate or contest with SIM + strategy guardrailsapplication/jsonshow example ▸
Response Schema(16 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
strategy_summary | objectnullable | — | Active strategy explanation, model receipt, and locked-holdout evidence when built with strategy="optimal". Omitted when strategy="none". |
slate | object | — | The slate. |
↳id slate.id | bigint | — | The slate. |
↳league slate.league | string | — | The league. |
↳name slate.name | string | — | The slate name. |
↳operator slate.operator | string | — | The operator. |
↳salary_cap slate.salary_cap | integer | — | The salary cap. |
↳slots slate.slots | list<S> | — | The slots of a lineup, in order. |
contest | object | — | The contest that priced the lineups. |
↳archetype contest.archetype | string | — | The field type that the simulated opponents follow, such as gpp_mme or cash. |
↳cash_line_rank contest.cash_line_rank | integer | — | The last paid place. |
↳contest_id contest.contest_id | bigint | — | The contest. |
↳entry_fee_dollars contest.entry_fee_dollars | decimal | — | The entry fee, in dollars. |
↳field_size contest.field_size | integer | — | The entries of the contest: its final count after lock. |
↳first_place_prize_dollars contest.first_place_prize_dollars | decimal | — | The prize of first place, in dollars. |
↳min_cash_dollars contest.min_cash_dollars | decimal | — | The smallest prize, in dollars. |
↳name contest.name | string | — | The contest name. |
↳paid_pct contest.paid_pct | decimal | — | The share of entries that win a prize, in percent. |
↳payout_source contest.payout_source | string | — | contest_payouts (the stored payout ladder) or modeled_profile (a modeled curve for a contest without a stored ladder). |
↳payout_tiers contest.payout_tiers | list<object> | — | The payout ladder: one row per prize band (min_rank, max_rank, payout_dollars, pct_of_pool). |
↳prize_pool_dollars contest.prize_pool_dollars | decimal | — | The prize pool, in dollars. |
↳rake_pct contest.rake_pct | decimal | — | The share of the entry fees that the operator keeps, in percent. |
source | object | — | The source of the candidates' projections: SIM by default, or caller for your own projections. |
↳name source.name | string | — | The source name. |
↳test_input source.test_input | boolean | — | True when the source is a test input. |
↳updated_at source.updated_at | timestamptznullable | — | When the source last changed. |
↳version source.version | string | — | The source version. |
sim | object | — | The draws of the run. |
↳draws sim.draws | object | — | The draws of each set: building (built the candidates), picking (picked the set) and report (every printed number). No draw is in two sets. |
↳building sim.draws.building | integer | — | Draws allocated to candidate pool building. |
↳picking sim.draws.picking | integer | — | Draws allocated to portfolio selection. |
↳report sim.draws.report | integer | — | Holdout draws allocated to reported EV, ROI, and finish rates. |
↳engine sim.engine | string | — | The engine of the draws: the NFL play-by-play sim, or the NBA sim's stored draws. |
↳field_cache_hit sim.field_cache_hit | boolean | — | True when the field came from the cache. |
↳game_count sim.game_count | integer | — | The games of the run. |
↳input_sha256 sim.input_sha256 | string | — | The hash of the sim's inputs. |
↳n_draws sim.n_draws | integer | — | The draws of the run: sim_game_runs, or the draws that the NBA sim stored. |
↳scenarios_per_game sim.scenarios_per_game | integer | — | The scenarios of each game. |
↳seed sim.seed | integer | — | The seed of the run. |
↳sim_cache_hit sim.sim_cache_hit | boolean | — | True when the draws came from the cache. |
↳simulated_field_lineups sim.simulated_field_lineups | integer | — | The lineups of the simulated field. |
↳versions sim.versions | object | — | Version keys of the run's caches: draws_key, ownership_model_key, field_values_key, terms_hash, rules_hash, engine_version, and pool_id. |
↳engine_version sim.versions.engine_version | string | — | Semantic version tag of the lineup engine. |
↳draws_key sim.versions.draws_key | string | — | Content key identifying the simulation draws matrix. |
↳ownership_model_key sim.versions.ownership_model_key | string | — | Content key identifying the opponent field ownership model. |
↳field_values_key sim.versions.field_values_key | string | — | Content key identifying field projections and salaries. |
↳terms_hash sim.versions.terms_hash | string | — | Hash of the target contest payout ladder and entry fee. |
↳rules_hash sim.versions.rules_hash | string | — | Hash of roster rules, locks, excludes, and stacking constraints. |
↳pool_id sim.versions.pool_id | stringnullable | — | Content-addressed SlateKernel handle for sub-50ms `pool_id` portfolio re-selection. |
rules | object | — | The inputs as the run applied them, in the request's names, with the defaults that the run filled in. |
warnings | listnullable | — | Notes on the request, each with its code, the inputs it names and a message. A note never stops the run. Absent when the run has no note. |
↳code warnings[].code | string | — | The note code, such as W_DRAWS_FROM_STORED_RUNS. |
↳fields warnings[].fields | list<S> | — | The inputs that the note names. |
↳message warnings[].message | string | — | The note. |
games | list | — | The games of the slate, with the sim's numbers. |
↳away games[].away | object | — | The away team: its abbreviation and its sim numbers. |
↳correlations games[].correlations | object | — | The correlation matrix of the skill players' points in the game's draws (NFL). |
↳game_id games[].game_id | bigint | — | The game. |
↳has_overrides games[].has_overrides | boolean | — | True when sim_game_changes changed this game. |
↳home games[].home | object | — | The home team: its abbreviation and its sim numbers. |
↳kickoff games[].kickoff | string | — | The kickoff time. |
↳scenarios games[].scenarios | list<object> | — | The game scenarios (1 to 5), each with its share of the draws and its box score. |
↳sim games[].sim | object | — | The game's sim summary: the home margin, the overtime rate and the shootout rate. |
↳vegas games[].vegas | object | — | The betting line: the implied totals and the spread. |
↳weather games[].weather | object | — | The weather of the game. |
player_pool | list | — | Each pool row of the slate, once. A lineup names its players by slate_player_id. |
↳base_position player_pool[].base_position | string | — | The position without a captain mark. |
↳export_id player_pool[].export_id | string | — | The operator's ID of the row, for the upload file. |
↳game_id player_pool[].game_id | bigint | — | The game of the player. |
↳is_captain player_pool[].is_captain | boolean | — | True for a captain row (CPT, MVP). |
↳name player_pool[].name | string | — | The player's name. |
↳opponent player_pool[].opponent | string | — | The opponent team. |
↳player_id player_pool[].player_id | bigint | — | The player: the same for every row of the player. |
↳points player_pool[].points | object | — | The player's points on the report draws: the mean, the percentiles and the spread. |
↳mean player_pool[].points.mean | decimal | — | Mean simulated fantasy points. |
↳sd player_pool[].points.sd | decimal | — | Standard deviation of fantasy points across report draws. |
↳p10 player_pool[].points.p10 | decimal | — | 10th percentile fantasy points. |
↳p50 player_pool[].points.p50 | decimal | — | Median (50th percentile) fantasy points. |
↳p90 player_pool[].points.p90 | decimal | — | 90th percentile fantasy points. |
↳p99 player_pool[].points.p99 | decimal | — | 99th percentile ceiling fantasy points. |
↳position player_pool[].position | string | — | The position of the row. |
↳rates player_pool[].rates | object | — | Boom and bust rates, the field ownership (the target and the realized share) and the optimal rates, in percent. |
↳field_ownership_pct player_pool[].rates.field_ownership_pct | decimal | — | Target field ownership percentage (0 to 100). |
↳field_realized_pct player_pool[].rates.field_realized_pct | decimalnullable | — | Realized ownership percentage in the simulated opponent field (0 to 100). |
↳optimal_pct player_pool[].rates.optimal_pct | decimal | — | Optimal lineup rate across report draws (0 to 100). |
↳optimal_leverage_pct player_pool[].rates.optimal_leverage_pct | decimal | — | Optimal rate minus field ownership percentage. |
↳boom_pct player_pool[].rates.boom_pct | decimal | — | Boom outcome probability percentage across report draws. |
↳bust_pct player_pool[].rates.bust_pct | decimal | — | Bust outcome probability percentage across report draws. |
↳salary player_pool[].salary | integer | — | The salary of the row. |
↳slate_player_id player_pool[].slate_player_id | bigint | — | The pool row. |
↳stats player_pool[].stats | object | — | The player's mean simulated stats. |
↳usage player_pool[].stats.usage | objectnullable | — | Simulated usage means (snaps, routes, target_share_pct, carry_share_pct). |
↳passing player_pool[].stats.passing | objectnullable | — | Simulated passing means (cmp, att, yd, td, int). |
↳rushing player_pool[].stats.rushing | objectnullable | — | Simulated rushing means (att, yd, td). |
↳receiving player_pool[].stats.receiving | objectnullable | — | Simulated receiving means (targets, rec, yd, td). |
↳kicking player_pool[].stats.kicking | objectnullable | — | Simulated kicking means (fg_made, xp_made). |
↳defense player_pool[].stats.defense | objectnullable | — | Simulated DST means (sacks, takeaways, pts_allowed). |
↳team player_pool[].team | string | — | The team of the player. |
↳value_per_1k player_pool[].value_per_1k | decimal | — | The mean points per $1,000 of salary. |
portfolio | object | — | The set of lineups: EV, ROI, rates and exposures, on the report draws. |
↳best_lineup_points portfolio.best_lineup_points | object | — | The points of the set's best lineup on each draw: the mean and the percentiles. |
↳mean portfolio.best_lineup_points.mean | decimal | — | Mean best-lineup score across report draws. |
↳sd portfolio.best_lineup_points.sd | decimal | — | Standard deviation of best-lineup score. |
↳p10 portfolio.best_lineup_points.p10 | decimal | — | 10th percentile best-lineup score. |
↳p50 portfolio.best_lineup_points.p50 | decimal | — | Median best-lineup score. |
↳p90 portfolio.best_lineup_points.p90 | decimal | — | 90th percentile best-lineup score. |
↳p99 portfolio.best_lineup_points.p99 | decimal | — | 99th percentile best-lineup score. |
↳diversity portfolio.diversity | object | — | Normalized mathematical portfolio diversity report across overlap, Jaccard distance, Schur-normalized entropy, effective breadth, and SIM draw decorrelation. |
↳composite_diversity_score portfolio.diversity.composite_diversity_score | decimal | — | Equal-weighted composite Portfolio Diversity Score (PDS) in [0, 1]. |
↳diversification_ratio_pts portfolio.diversity.diversification_ratio_pts | decimalnullable | — | Portfolio diversification ratio of lineup points across report SIM draws (>= 1.0). |
↳effective_players_hhi portfolio.diversity.effective_players_hhi | decimal | — | Effective number of seat appearances by inverse Herfindahl index 1 / sum(w_p^2). |
↳effective_players_shannon portfolio.diversity.effective_players_shannon | decimal | — | Effective number of seat appearances by exp(Shannon entropy). |
↳max_pair_overlap portfolio.diversity.max_pair_overlap | integer | — | Maximum shared players between any pair of selected lineups. |
↳mean_pairwise_jaccard_distance portfolio.diversity.mean_pairwise_jaccard_distance | decimal | — | Mean pairwise Jaccard distance across selected lineups (0 to 1). |
↳mean_pairwise_payout_corr portfolio.diversity.mean_pairwise_payout_corr | decimalnullable | — | Mean pairwise correlation of lineup contest payouts across the report SIM draws. |
↳mean_pairwise_points_corr portfolio.diversity.mean_pairwise_points_corr | decimalnullable | — | Mean pairwise correlation of lineup fantasy points across the report SIM draws. |
↳normalized_exposure_entropy portfolio.diversity.normalized_exposure_entropy | decimal | — | Schur-normalized Shannon entropy of lineup seat appearances in [0, 1]. |
↳overlap_histogram portfolio.diversity.overlap_histogram | list<I> | — | Pair counts sharing k = 0..=slots seats across all C(M, 2) lineup pairs. |
↳structural_overlap_diversity portfolio.diversity.structural_overlap_diversity | decimal | — | Normalized complement of mean pairwise lineup overlap: 1 - mean_overlap / slots (0 to 1). |
↳exposures portfolio.exposures | object | — | The share of lineups that hold each player, stack, team and game. |
↳players portfolio.exposures.players | list<object> | — | Per-player exposure and leverage breakdown across selected lineups. |
↳stacks portfolio.exposures.stacks | list<object> | — | Per-stack exposure, EV, and ROI breakdown. |
↳teams portfolio.exposures.teams | list<object> | — | Per-team roster and stack exposure breakdown. |
↳games portfolio.exposures.games | list<object> | — | Per-game roster and stack exposure breakdown. |
↳lineup_count portfolio.lineup_count | integer | — | The lineups of the set. |
↳mean_leverage_sum_pct portfolio.mean_leverage_sum_pct | decimal | — | The mean leverage sum of a lineup, in percent. |
↳mean_lineup_points portfolio.mean_lineup_points | decimal | — | The mean points of a lineup. |
↳mean_ownership_sum_pct portfolio.mean_ownership_sum_pct | decimal | — | The mean sum of the field ownership of a lineup, in percent. |
↳mean_pairwise_overlap portfolio.mean_pairwise_overlap | decimal | — | The mean count of players that two lineups share. |
↳payout portfolio.payout | object | — | The set's payout on the report draws: ev_dollars with its standard error, roi_pct, win_pct, cash_pct, and top-finish rates. |
↳ev_dollars portfolio.payout.ev_dollars | decimal | — | Expected gross contest payout in dollars. |
↳net_ev_dollars portfolio.payout.net_ev_dollars | decimal | — | Expected net profit in dollars (EV minus entry fees). |
↳roi_pct portfolio.payout.roi_pct | decimal | — | Expected return on investment percentage. |
↳win_pct portfolio.payout.win_pct | decimal | — | Probability of finishing 1st place, in percent (0 to 100). |
↳top_01_pct portfolio.payout.top_01_pct | decimal | — | Probability of finishing in top 0.1%, in percent. |
↳top_1_pct portfolio.payout.top_1_pct | decimal | — | Probability of finishing in top 1%, in percent. |
↳top_5_pct portfolio.payout.top_5_pct | decimal | — | Probability of finishing in top 5%, in percent. |
↳top_10_pct portfolio.payout.top_10_pct | decimal | — | Probability of finishing in top 10%, in percent. |
↳cash_pct portfolio.payout.cash_pct | decimal | — | Cash probability percentage (0 to 100). |
↳ev_se_dollars portfolio.payout.ev_se_dollars | decimalnullable | — | Monte Carlo standard error of ev_dollars over report draws. |
↳roi_se_pct portfolio.payout.roi_se_pct | decimalnullable | — | Monte Carlo standard error of roi_pct over report draws. |
↳profitable_draws_pct portfolio.profitable_draws_pct | decimal | — | The share of the report draws in which the set wins more than its fees. |
↳total_entry_cost_dollars portfolio.total_entry_cost_dollars | decimal | — | The fees of the set, in dollars. |
↳unique_players portfolio.unique_players | integer | — | The players in one or more lineups of the set. |
lineups | list | — | The lineups of the set, in the order of the pick. |
↳best_scenario lineups[].best_scenario | objectnullable | — | The game scenario in which the lineup earns the most. |
↳game_id lineups[].best_scenario.game_id | bigint | — | Game identifier for the scenario. |
↳scenario_id lineups[].best_scenario.scenario_id | integer | — | Scenario cluster index. |
↳mean_points lineups[].best_scenario.mean_points | decimal | — | Lineup mean points under this scenario. |
↳ev_dollars lineups[].best_scenario.ev_dollars | decimal | — | Lineup EV in dollars under this scenario. |
↳roi_pct lineups[].best_scenario.roi_pct | decimal | — | Lineup ROI percentage under this scenario. |
↳ownership lineups[].ownership | object | — | The field ownership of the lineup: its geometric mean, its sum, its leverage and its expected duplicates. |
↳sum_pct lineups[].ownership.sum_pct | decimal | — | Sum of player field ownership percentages. |
↳geomean_pct lineups[].ownership.geomean_pct | decimal | — | Geometric mean player field ownership percentage. |
↳product lineups[].ownership.product | decimal | — | Joint product of lineup seat ownership probabilities. |
↳optimal_sum_pct lineups[].ownership.optimal_sum_pct | decimal | — | Sum of player optimal lineup percentages. |
↳leverage_sum_pct lineups[].ownership.leverage_sum_pct | decimal | — | Sum of player optimal leverage percentages. |
↳expected_dupes lineups[].ownership.expected_dupes | decimal | — | Expected exact duplicate count in the contest field. |
↳uncontested_pct lineups[].ownership.uncontested_pct | decimal | — | Probability of zero identical opponent lineups (0 to 100). |
↳payout lineups[].payout | object | — | The lineup's payout on the report draws: ev_dollars with its standard error, roi_pct, win_pct, cash_pct, and top-finish rates. |
↳ev_dollars lineups[].payout.ev_dollars | decimal | — | Expected gross contest payout in dollars. |
↳net_ev_dollars lineups[].payout.net_ev_dollars | decimal | — | Expected net profit in dollars. |
↳roi_pct lineups[].payout.roi_pct | decimal | — | Expected ROI percentage. |
↳win_pct lineups[].payout.win_pct | decimal | — | Probability of 1st-place finish, in percent. |
↳top_01_pct lineups[].payout.top_01_pct | decimal | — | Probability of top 0.1% finish, in percent. |
↳top_1_pct lineups[].payout.top_1_pct | decimal | — | Probability of top 1% finish, in percent. |
↳top_5_pct lineups[].payout.top_5_pct | decimal | — | Probability of top 5% finish, in percent. |
↳top_10_pct lineups[].payout.top_10_pct | decimal | — | Probability of top 10% finish, in percent. |
↳cash_pct lineups[].payout.cash_pct | decimal | — | Probability of cashing, in percent. |
↳ev_se_dollars lineups[].payout.ev_se_dollars | decimalnullable | — | Monte Carlo standard error of ev_dollars. |
↳roi_se_pct lineups[].payout.roi_se_pct | decimalnullable | — | Monte Carlo standard error of roi_pct. |
↳points lineups[].points | object | — | The lineup's points on the report draws: the mean and the percentiles. |
↳mean lineups[].points.mean | decimal | — | Mean simulated lineup points. |
↳sd lineups[].points.sd | decimal | — | Standard deviation of simulated lineup points. |
↳p10 lineups[].points.p10 | decimal | — | 10th percentile lineup score. |
↳p50 lineups[].points.p50 | decimal | — | Median (50th percentile) lineup score. |
↳p90 lineups[].points.p90 | decimal | — | 90th percentile lineup score. |
↳p99 lineups[].points.p99 | decimal | — | 99th percentile ceiling score. |
↳projected_points lineups[].projected_points | decimal | — | The sum of the players' projected points. |
↳rank lineups[].rank | integer | — | The place of the lineup in the pick, from 1. |
↳ranking lineups[].ranking | objectnullable | — | Ranking breakdown when player ROI boosts are active. |
↳roi_boost_pct lineups[].ranking.roi_boost_pct | decimal | — | Sum of caller ROI boosts applied to this lineup. |
↳score lineups[].ranking.score | decimal | — | Boosted selection score. |
↳salary lineups[].salary | integer | — | The salary of the lineup. |
↳salary_remaining lineups[].salary_remaining | integer | — | The salary cap minus the salary. |
↳seats lineups[].seats | list | — | The slots of the lineup, each with its slate_player_id. |
↳slot lineups[].seats[].slot | string | — | Assigned roster slot name. |
↳slate_player_id lineups[].seats[].slate_player_id | bigint | — | Slate player pool row ID (resolves against player_pool). |
↳stack lineups[].stack | object | — | The lineup's stack: its shape, its correlation and a summary. |
↳archetype lineups[].stack.archetype | string | — | Primary stack pattern label. |
↳summary lineups[].stack.summary | string | — | Human-readable stack description. |
↳correlation lineups[].stack.correlation | decimal | — | Intra-lineup player correlation across report draws. |
opponent_field | object | — | The simulated field of opponents. |
↳classic_composition opponent_field.classic_composition | object | — | The shares of the stack and FLEX shapes in the field. |
↳sample_lineups opponent_field.sample_lineups | list<object> | — | A sample of the field's lineups, each with its count. |
↳summary opponent_field.summary | object | — | The field build: the fit, the mean points and the mean salary. |
↳top_stacks opponent_field.top_stacks | list<object> | — | The field's most common stacks, with their shares and leverage. |
diagnostics | object | — | Counts and times of the run. Times are in milliseconds. |
↳built diagnostics.built | integer | — | The lineups in the response. |
↳candidate_pool_size diagnostics.candidate_pool_size | integer | — | The candidate lineups that the pick read: the pool that the rounds grew. |
↳contest_eval_ms diagnostics.contest_eval_ms | integer | — | The time that the contest evaluation took. |
↳excluded diagnostics.excluded | object | — | The pool rows left out, by reason. |
↳field_ms diagnostics.field_ms | integer | — | The time that the field build took. |
↳max_overlap diagnostics.max_overlap | integer | — | The most players that two lineups share: the slots minus min_unique_players. |
↳optimizer_ms diagnostics.optimizer_ms | integer | — | The time that the candidate builds took. |
↳requested diagnostics.requested | integer | — | The lineup_count of the request, or its default. |
↳sim_ms diagnostics.sim_ms | integer | — | The time that the game sim took. |
↳sort_by diagnostics.sort_by | string | — | How the set was picked: roi (by added EV) for a SIM build, projected_points for a projection build. |
↳total_ms diagnostics.total_ms | integer | — | The time of the whole run. |
↳reason diagnostics.reason | stringnullable | — | Diagnostic explanation when fewer than requested lineups could be built. |
frontier | list<object>nullable | — | Present in pool_id mode when include_diversity_frontier is true; Pareto diversity frontier points. |
patched_upload_csv | stringnullable | — | Present in late-swap mode for full paid responses when entries_csv was uploaded; 1:1 patched Entries CSV preserving Entry ID, Contest Name, Contest ID, and Fee. |
_metadata | objectnullable | — | The preview envelope for a caller without a paid plan: the first 5 lineups, the required plan and the full count. Absent for a paid plan. |
POST/api/v1/dfs/slates/{slate_id}/optimizer/lineupsFast deterministic lineup optimizer and contest-file late swapperbeta
slate_idpathbigintrequiredentries_csvstringoptionalDraftKings or FanDuel Contest Entries CSV string for fast projection late-swap mode. Preserves Entry ID, Contest Name, Contest ID, and Fee 1:1 into `patched_upload_csv` (or direct CSV stream when `response_format` is `"csv"`).
Omit for fresh lineup builds. Operator `LOCKED` markers inside CSV cells are honored alongside `as_of`, `locked_game_ids`, and `live_actual_points`.
Build 20 diversified lineups with a QB+2WR stack, 1 bring-back, 1 lock, and a 60% global exposure cap.
curl -sS --compressed -X POST \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
'https://api.stat-api.com/api/v1/dfs/slates/1045169/optimizer/lineups' \
-d '{
"lineup_count": 20,
"max_player_exposure_pct": 60,
"min_unique_players": 2,
"diversity_weight": 0.25,
"lineup_stacks": [
{
"positions": [
"QB",
"WR",
"WR"
],
"bring_back_count": 1
}
],
"players": [
{
"slate_player_id": 43912853,
"lock": true
}
]
}'200Fast deterministic lineup optimizer and contest-file late swapperapplication/jsonshow example ▸
Response Schema(8 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
slate | object | — | Slate metadata. |
↳id slate.id | bigint | — | Slate ID (dfs.slates.id). |
↳league slate.league | string | — | League code (e.g. nfl, nba, nhl). |
↳name slate.name | string | — | Slate display name. |
↳operator slate.operator | string | — | DFS operator name (e.g. DraftKings, FanDuel). |
↳salary_cap slate.salary_cap | integer | — | Maximum lineup salary cap. |
↳slots slate.slots | list<S> | — | Ordered roster slot names for the slate. |
source | object | — | Projection source metadata (stored source or caller custom projections). |
↳name source.name | string | — | Projection source name (e.g. STAT_API_LATEST or caller). |
↳version source.version | stringnullable | — | Projection source version. |
↳updated_at source.updated_at | timestamptznullable | — | When the projection source last updated. |
↳test_input source.test_input | boolean | — | True when using a test projection source. |
warnings | listnullable | — | Non-fatal request validation notes, each with code, fields, and message. |
↳code warnings[].code | string | — | Warning code (e.g. W_GROUP_EXPOSURE_CONTRADICTS_MIN_PLAYERS). |
↳fields warnings[].fields | list<S> | — | Request fields referenced by the warning. |
↳message warnings[].message | string | — | Human-readable explanation of the warning. |
portfolio | object | — | Built lineup count, mean projection, mean salary, structural diversity metrics, and realized player exposures. |
↳lineup_count portfolio.lineup_count | integer | — | Number of lineups returned. |
↳unique_players portfolio.unique_players | integer | — | Distinct slate_player_id rows used across the portfolio. |
↳mean_projected_points portfolio.mean_projected_points | decimal | — | Mean projected points across built lineups. |
↳mean_salary portfolio.mean_salary | decimal | — | Mean salary across built lineups. |
↳mean_pairwise_overlap portfolio.mean_pairwise_overlap | decimal | — | Mean shared seats between pairs of built lineups. |
↳diversity portfolio.diversity | object | — | Normalized mathematical portfolio diversity report across overlap, Jaccard distance, Schur-normalized entropy, and effective breadth. |
↳structural_overlap_diversity portfolio.diversity.structural_overlap_diversity | decimal | — | Normalized complement of mean pairwise lineup overlap: 1 - mean_overlap / slots (0 to 1). |
↳mean_pairwise_jaccard_distance portfolio.diversity.mean_pairwise_jaccard_distance | decimal | — | Mean pairwise Jaccard distance across built lineups (0 to 1). |
↳max_pair_overlap portfolio.diversity.max_pair_overlap | integer | — | Maximum shared players between any pair of built lineups. |
↳overlap_histogram portfolio.diversity.overlap_histogram | list<I> | — | Pair counts sharing k = 0..=slots seats across all C(M, 2) lineup pairs. |
↳normalized_exposure_entropy portfolio.diversity.normalized_exposure_entropy | decimal | — | Schur-normalized Shannon entropy of lineup seat appearances in [0, 1]. |
↳effective_players_shannon portfolio.diversity.effective_players_shannon | decimal | — | Effective number of seat appearances by exp(Shannon entropy). |
↳effective_players_hhi portfolio.diversity.effective_players_hhi | decimal | — | Effective number of seat appearances by inverse Herfindahl index 1 / sum(w_p^2). |
↳mean_pairwise_points_corr portfolio.diversity.mean_pairwise_points_corr | decimalnullable | — | Null for deterministic optimizer builds. |
↳mean_pairwise_payout_corr portfolio.diversity.mean_pairwise_payout_corr | decimalnullable | — | Null for deterministic optimizer builds. |
↳diversification_ratio_pts portfolio.diversity.diversification_ratio_pts | decimalnullable | — | Null for deterministic optimizer builds. |
↳composite_diversity_score portfolio.diversity.composite_diversity_score | decimal | — | Equal-weighted composite Portfolio Diversity Score (PDS) in [0, 1]. |
↳exposures portfolio.exposures | list | — | Realized exposure breakdown per selected player. |
↳slate_player_id portfolio.exposures[].slate_player_id | bigint | — | Slate player pool row ID. |
↳player_id portfolio.exposures[].player_id | bigint | — | Canonical player ID. |
↳name portfolio.exposures[].name | stringnullable | — | Player name. |
↳team portfolio.exposures[].team | stringnullable | — | Player team abbreviation. |
↳lineups portfolio.exposures[].lineups | integer | — | Number of built lineups containing the player. |
↳exposure_pct portfolio.exposures[].exposure_pct | decimal | — | Share of built lineups containing the player, in percent (0 to 100). |
↳min_exposure_shortfalls portfolio.min_exposure_shortfalls | list | — | Players whose requested min_exposure_pct could not be fully satisfied. |
↳slate_player_id portfolio.min_exposure_shortfalls[].slate_player_id | bigint | — | Slate player pool row ID. |
↳needed portfolio.min_exposure_shortfalls[].needed | integer | — | Minimum lineups required by min_exposure_pct. |
↳picked portfolio.min_exposure_shortfalls[].picked | integer | — | Actual lineups containing the player. |
↳swapped_count portfolio.swapped_count | integernullable | — | Present in late-swap mode. Number of entries that swapped at least one unlocked slot. |
↳held_count portfolio.held_count | integernullable | — | Present in late-swap mode. Number of entries kept unchanged. |
↳before_mean_projected_points portfolio.before_mean_projected_points | decimalnullable | — | Present in late-swap mode. Mean projected points of the original submitted lineups. |
↳total_projection_gain portfolio.total_projection_gain | decimalnullable | — | Present in late-swap mode. Total projected points gained across all entries. |
patched_upload_csv | stringnullable | — | Present in late-swap mode for full paid responses when entries_csv was uploaded; 1:1 patched Contest Entries CSV preserving Entry ID, Contest Name, Contest ID, and Fee. |
lineups | list | — | Ranked lineups (or post-swap entries in late-swap mode) with projected_points, salary, stack summary, and slot-ordered seats. |
↳rank lineups[].rank | integer | — | 1-based rank in the built lineup set. |
↳salary lineups[].salary | integer | — | Total salary of the lineup. |
↳salary_remaining lineups[].salary_remaining | integer | — | Remaining unused salary below salary_cap. |
↳projected_points lineups[].projected_points | decimal | — | Sum of projected points across the lineup seats. |
↳entry_id lineups[].entry_id | stringnullable | — | Present in late-swap mode. Contest entry ID from entries_csv or JSON entries. |
↳contest_id lineups[].contest_id | bigintnullable | — | Present in late-swap mode. Contest ID from entries_csv or JSON entries. |
↳action lineups[].action | stringnullable | — | Present in late-swap mode. Swap decision for this entry (swapped or held). |
↳locked_slots lineups[].locked_slots | list<S>nullable | — | Present in late-swap mode. Slot names locked before optimization. |
↳before_player_ids lineups[].before_player_ids | list<L>nullable | — | Present in late-swap mode. Ordered slate_player_id values prior to swap. |
↳hold_projected_points lineups[].hold_projected_points | decimalnullable | — | Present in late-swap mode. Projected points if keeping the original lineup unchanged. |
↳projection_gain lineups[].projection_gain | decimalnullable | — | Present in late-swap mode. Projected point delta (projected_points minus hold_projected_points). |
↳swap_reason lineups[].swap_reason | stringnullable | — | Present in late-swap mode. Explanation of why the entry was swapped or held. |
↳stack lineups[].stack | object | — | Detected team/game stack structure for the lineup. |
↳archetype lineups[].stack.archetype | string | — | Primary stack pattern label (e.g. QB+2, Game 3+1). |
↳summary lineups[].stack.summary | string | — | Human-readable stack breakdown. |
↳correlation lineups[].stack.correlation | decimal | — | Intra-lineup teammate and bring-back correlation score. |
↳seats lineups[].seats | list | — | Slot-ordered players filling every roster seat. |
↳slot lineups[].seats[].slot | string | — | Assigned roster slot name. |
↳slate_player_id lineups[].seats[].slate_player_id | bigint | — | Slate player pool row ID. |
↳player_id lineups[].seats[].player_id | bigint | — | Canonical player ID. |
↳export_id lineups[].seats[].export_id | stringnullable | — | Operator upload identifier for CSV export. |
↳name lineups[].seats[].name | stringnullable | — | Player display name. |
↳base_position lineups[].seats[].base_position | string | — | Player underlying position (e.g. QB, RB, WR). |
↳team lineups[].seats[].team | stringnullable | — | Player team abbreviation. |
↳game_id lineups[].seats[].game_id | bigintnullable | — | Slate game ID. |
↳salary lineups[].seats[].salary | integer | — | Player salary on this slate. |
↳projection lineups[].seats[].projection | decimal | — | Projected fantasy points used for optimization. |
diagnostics | object | — | Pool sizes, exclusion breakdown, optimizer_ms, total_ms, and shortfall reason if any. |
↳requested diagnostics.requested | integer | — | Requested lineup_count. |
↳candidate_pool_size diagnostics.candidate_pool_size | integer | — | Eligible slate player rows sent to the solver. |
↳built diagnostics.built | integer | — | Number of lineups built. |
↳max_overlap diagnostics.max_overlap | integer | — | Maximum allowed shared seats between any pair of lineups. |
↳excluded diagnostics.excluded | object | — | Pool rows excluded before solving, broken down by reason. |
↳no_projection diagnostics.excluded.no_projection | integer | — | Rows without a projection. |
↳zero_projection diagnostics.excluded.zero_projection | integer | — | Rows with zero or non-positive projection. |
↳game_started diagnostics.excluded.game_started | integer | — | Rows whose game already started as of as_of. |
↳no_game diagnostics.excluded.no_game | integer | — | Rows without a mapped game. |
↳no_salary diagnostics.excluded.no_salary | integer | — | Rows without a salary. |
↳team_not_in_game diagnostics.excluded.team_not_in_game | integer | — | Rows whose team is not in a slate game. |
↳by_caller diagnostics.excluded.by_caller | integer | — | Rows excluded by caller constraints. |
↳below_depth diagnostics.excluded.below_depth | integer | — | NFL classic rows deeper than the pool depth rule. |
↳refused diagnostics.excluded.refused | object | — | Projection-service refusal counts keyed by reason. |
↳optimizer_ms diagnostics.optimizer_ms | integer | — | Solver duration in milliseconds. |
↳total_ms diagnostics.total_ms | integer | — | Total request duration in milliseconds. |
↳reason diagnostics.reason | stringnullable | — | Reason fewer than requested lineups were built, if any. |
↳unique_lock_signatures diagnostics.unique_lock_signatures | integernullable | — | Present in late-swap mode. Distinct slot-lock combinations evaluated across entries. |
↳locked_game_count diagnostics.locked_game_count | integernullable | — | Present in late-swap mode. Number of games locked as of as_of / locked_game_ids. |
_metadata | objectnullable | — | Preview envelope for callers below the Pro tier. Absent on full paid responses. |