STAT-API
← DFS Cookbook

Restrict builds to a curated liked-players pool with FLEX and team rules

Combine `liked_players_only: true` with `players[].like: true`, `lineup_flex_positions`, `lineup_max_players_per_team`, `lineup_min_salary`, and `lineup_allow_defense_vs_offense: false` to build strictly from your shortlisted player pool.

What it is
Solves 5 lineups on slate `1126128` using only locked/liked players (`liked_players_only: true`), forcing FLEX to `WR`/`TE`, capping 3 players per team, and enforcing a $49,000 salary floor.
When to use it
Use this for hand-builder workflows where you shortlist your favorite plays and enforce strict slot and correlation hygiene.
What you get back
Portfolio mean salary and 5 slot-by-slot lineups proving every FLEX seat is WR or TE.

1.Build 5 lineups from the curated liked/locked pool

Lock 1 QB, tag 17 liked players across positions, restrict FLEX to `["WR", "TE"]`, and enforce a $49,000 minimum salary.

POST request (requires your API key in STAT_API_KEY). Run the SDK program on the right or the curl snippet below.

{
  "lineup_count": 5,
  "liked_players_only": true,
  "lineup_min_salary": 49000,
  "lineup_max_players_per_team": 3,
  "lineup_flex_positions": [
    "WR",
    "TE"
  ],
  "lineup_allow_defense_vs_offense": false,
  "min_unique_players": 2,
  "players": [
    {
      "slate_player_id": 44186595,
      "lock": true
    },
    {
      "slate_player_id": 44186556,
      "like": true,
      "max_exposure_pct": 70
    },
    {
      "slate_player_id": 44186567,
      "like": true
    },
    {
      "slate_player_id": 44186645,
      "like": true
    },
    {
      "slate_player_id": 44186564,
      "like": true
    },
    {
      "slate_player_id": 44186562,
      "like": true
    },
    {
      "slate_player_id": 44186596,
      "like": true
    },
    {
      "slate_player_id": 44186554,
      "like": true
    },
    {
      "slate_player_id": 44186570,
      "like": true
    },
    {
      "slate_player_id": 44186568,
      "like": true
    },
    {
      "slate_player_id": 44186574,
      "like": true
    },
    {
      "slate_player_id": 44186641,
      "like": true
    },
    {
      "slate_player_id": 44186789,
      "like": true
    },
    {
      "slate_player_id": 44186860,
      "like": true
    },
    {
      "slate_player_id": 44186666,
      "like": true
    },
    {
      "slate_player_id": 44187005,
      "like": true
    },
    {
      "slate_player_id": 44187045,
      "like": true
    },
    {
      "slate_player_id": 44187052,
      "like": true
    }
  ],
  "response_format": "json"
}
const likedRes = await api.dfs.slates.optimizerLineups(1126128, { lineup_count: 5, liked_players_only: true, lineup_min_salary: 49000, lineup_max_players_per_team: 3, lineup_flex_positions: ["WR", "TE"], lineup_allow_defense_vs_offense: false, min_unique_players: 2, players: [{ slate_player_id: 44186595, lock: true }, { slate_player_id: 44186556, like: true, max_exposure_pct: 70 }, { slate_player_id: 44186567, like: true }, { slate_player_id: 44186645, like: true }, { slate_player_id: 44186564, like: true }, { slate_player_id: 44186562, like: true }, { slate_player_id: 44186596, like: true }, { slate_player_id: 44186554, like: true }, { slate_player_id: 44186570, like: true }, { slate_player_id: 44186568, like: true }, { slate_player_id: 44186574, like: true }, { slate_player_id: 44186641, like: true }, { slate_player_id: 44186789, like: true }, { slate_player_id: 44186860, like: true }, { slate_player_id: 44186666, like: true }, { slate_player_id: 44187005, like: true }, { slate_player_id: 44187045, like: true }, { slate_player_id: 44187052, like: true }] })

Every step as one runnable file. It reads STAT_API_KEY from the environment, and is the same file that ships in the cookbook project for each SDK.

import { StatApi } from '@stat-api/client'

const api = new StatApi() // reads STAT_API_KEY from the environment

// Build 5 lineups from the curated liked/locked pool
const likedRes = await api.dfs.slates.optimizerLineups(1126128, { lineup_count: 5, liked_players_only: true, lineup_min_salary: 49000, lineup_max_players_per_team: 3, lineup_flex_positions: ["WR", "TE"], lineup_allow_defense_vs_offense: false, min_unique_players: 2, players: [{ slate_player_id: 44186595, lock: true }, { slate_player_id: 44186556, like: true, max_exposure_pct: 70 }, { slate_player_id: 44186567, like: true }, { slate_player_id: 44186645, like: true }, { slate_player_id: 44186564, like: true }, { slate_player_id: 44186562, like: true }, { slate_player_id: 44186596, like: true }, { slate_player_id: 44186554, like: true }, { slate_player_id: 44186570, like: true }, { slate_player_id: 44186568, like: true }, { slate_player_id: 44186574, like: true }, { slate_player_id: 44186641, like: true }, { slate_player_id: 44186789, like: true }, { slate_player_id: 44186860, like: true }, { slate_player_id: 44186666, like: true }, { slate_player_id: 44187005, like: true }, { slate_player_id: 44187045, like: true }, { slate_player_id: 44187052, like: true }] })

// Print slot-by-slot lineups verifying FLEX eligibility
const p = likedRes.portfolio
console.log(`Slate ${likedRes.slate.id} (${likedRes.slate.league}/${likedRes.slate.operator}) | lineups=${p.lineup_count} unique=${p.unique_players} mean_pts=${p.mean_projected_points.toFixed(2)} mean_sal=${p.mean_salary.toFixed(2)}`)
for (const l of likedRes.lineups.slice(0, 5)) {
  console.log(`Lineup #${l.rank} | salary=${l.salary} pts=${l.projected_points.toFixed(2)} stack=${l.stack.summary}`)
  const seatText = l.seats.map((s) => `${s.slot}:${s.name ?? ''}(${s.team ?? ''},${s.base_position})`).join(' ')
  console.log(`  Seats: ${seatText}`)
}

Verified output across all 4 SDKs

TypeScript, Python, Go, and Java execute cleanly and print byte-identical output:

Slate 1126128 (nfl/draftkings) | lineups=5 unique=15 mean_pts=153.85 mean_sal=49880.00
Lineup #1 | salary=50000 pts=154.90 stack=QB+1 (NO) + 1 Opp (CAR)
  Seats: QB:Tyler Shough(NO,QB) RB:Emmett Johnson(KC,RB) RB:Chuba Hubbard(CAR,RB) WR:CeeDee Lamb(DAL,WR) WR:Justin Jefferson(MIN,WR) WR:Chris Olave(NO,WR) TE:Tyler Warren(IND,TE) FLEX:Gavin Bartholomew(MIN,TE) DST:Colts(IND,DST)
Lineup #2 | salary=50000 pts=154.42 stack=Naked QB (NO)
  Seats: QB:Tyler Shough(NO,QB) RB:Bijan Robinson(ATL,RB) RB:Emmett Johnson(KC,RB) WR:CeeDee Lamb(DAL,WR) WR:Justin Jefferson(MIN,WR) WR:Drake London(ATL,WR) TE:Tyler Warren(IND,TE) FLEX:Gavin Bartholomew(MIN,TE) DST:Raiders(LV,DST)
Lineup #3 | salary=49800 pts=153.76 stack=Naked QB (NO)
  Seats: QB:Tyler Shough(NO,QB) RB:Emmett Johnson(KC,RB) RB:James Cook III(BUF,RB) WR:CeeDee Lamb(DAL,WR) WR:Justin Jefferson(MIN,WR) WR:Drake London(ATL,WR) TE:Tyler Warren(IND,TE) FLEX:Gavin Bartholomew(MIN,TE) DST:Colts(IND,DST)
Lineup #4 | salary=50000 pts=153.23 stack=QB (NO) + 1 Opp (CAR)
  Seats: QB:Tyler Shough(NO,QB) RB:Emmett Johnson(KC,RB) RB:Chuba Hubbard(CAR,RB) WR:CeeDee Lamb(DAL,WR) WR:Justin Jefferson(MIN,WR) WR:Drake London(ATL,WR) TE:Gavin Bartholomew(MIN,TE) FLEX:KC Concepcion Jr.(CLE,WR) DST:Colts(IND,DST)
Lineup #5 | salary=49600 pts=152.92 stack=QB+1 (NO)
  Seats: QB:Tyler Shough(NO,QB) RB:Bijan Robinson(ATL,RB) RB:Emmett Johnson(KC,RB) WR:CeeDee Lamb(DAL,WR) WR:Justin Jefferson(MIN,WR) WR:Chris Olave(NO,WR) TE:Gavin Bartholomew(MIN,TE) FLEX:Chimere Dike(TEN,WR) DST:Colts(IND,DST)