Bring your own player projections and exposure overrides
Passing `players[].projected_points` switches the solver cleanly to all-or-nothing caller projections (`source.name: "caller"`) so proprietary scales never mix with stored baseline projections (`projection_source` must be omitted).
- What it is
- Solves 5 lineups on slate `1126128` using caller-supplied `players[].projected_points` across an 18-player custom projection board with per-player exposure bounds.
- When to use it
- Use this when integrating your own proprietary fantasy point model directly into STAT-API's fast MILP solver and exposure engine.
- What you get back
- A response reporting `source=caller`, custom-scale mean projected points, realized exposures, and top ranked lineups.
1.Optimize 5 lineups from caller-supplied projections
Submit custom `projected_points` and per-player exposure bounds across an 18-player pool on slate `1126128`.
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,
"min_unique_players": 2,
"players": [
{
"slate_player_id": 44186567,
"projected_points": 25,
"max_exposure_pct": 70
},
{
"slate_player_id": 44186595,
"projected_points": 22,
"min_exposure_pct": 30
},
{
"slate_player_id": 44186556,
"projected_points": 24.5,
"max_exposure_pct": 60
},
{
"slate_player_id": 44186645,
"projected_points": 19.5
},
{
"slate_player_id": 44186564,
"projected_points": 20.5
},
{
"slate_player_id": 44186562,
"projected_points": 21
},
{
"slate_player_id": 44186596,
"projected_points": 16
},
{
"slate_player_id": 44186554,
"projected_points": 24
},
{
"slate_player_id": 44186570,
"projected_points": 23.5,
"min_exposure_pct": 40
},
{
"slate_player_id": 44186568,
"projected_points": 19
},
{
"slate_player_id": 44186574,
"projected_points": 18.5
},
{
"slate_player_id": 44186641,
"projected_points": 13.5
},
{
"slate_player_id": 44186789,
"projected_points": 11.5
},
{
"slate_player_id": 44186860,
"projected_points": 9
},
{
"slate_player_id": 44186666,
"projected_points": 14
},
{
"slate_player_id": 44187005,
"projected_points": 9.5
},
{
"slate_player_id": 44187045,
"projected_points": 9
},
{
"slate_player_id": 44187052,
"projected_points": 7.5
}
],
"response_format": "json"
}const byopRes = await api.dfs.slates.optimizerLineups(1126128, { lineup_count: 5, min_unique_players: 2, players: [{ slate_player_id: 44186567, projected_points: 25, max_exposure_pct: 70 }, { slate_player_id: 44186595, projected_points: 22, min_exposure_pct: 30 }, { slate_player_id: 44186556, projected_points: 24.5, max_exposure_pct: 60 }, { slate_player_id: 44186645, projected_points: 19.5 }, { slate_player_id: 44186564, projected_points: 20.5 }, { slate_player_id: 44186562, projected_points: 21 }, { slate_player_id: 44186596, projected_points: 16 }, { slate_player_id: 44186554, projected_points: 24 }, { slate_player_id: 44186570, projected_points: 23.5, min_exposure_pct: 40 }, { slate_player_id: 44186568, projected_points: 19 }, { slate_player_id: 44186574, projected_points: 18.5 }, { slate_player_id: 44186641, projected_points: 13.5 }, { slate_player_id: 44186789, projected_points: 11.5 }, { slate_player_id: 44186860, projected_points: 9 }, { slate_player_id: 44186666, projected_points: 14 }, { slate_player_id: 44187005, projected_points: 9.5 }, { slate_player_id: 44187045, projected_points: 9 }, { slate_player_id: 44187052, projected_points: 7.5 }] })The complete program
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
// Optimize 5 lineups from caller-supplied projections
const byopRes = await api.dfs.slates.optimizerLineups(1126128, { lineup_count: 5, min_unique_players: 2, players: [{ slate_player_id: 44186567, projected_points: 25, max_exposure_pct: 70 }, { slate_player_id: 44186595, projected_points: 22, min_exposure_pct: 30 }, { slate_player_id: 44186556, projected_points: 24.5, max_exposure_pct: 60 }, { slate_player_id: 44186645, projected_points: 19.5 }, { slate_player_id: 44186564, projected_points: 20.5 }, { slate_player_id: 44186562, projected_points: 21 }, { slate_player_id: 44186596, projected_points: 16 }, { slate_player_id: 44186554, projected_points: 24 }, { slate_player_id: 44186570, projected_points: 23.5, min_exposure_pct: 40 }, { slate_player_id: 44186568, projected_points: 19 }, { slate_player_id: 44186574, projected_points: 18.5 }, { slate_player_id: 44186641, projected_points: 13.5 }, { slate_player_id: 44186789, projected_points: 11.5 }, { slate_player_id: 44186860, projected_points: 9 }, { slate_player_id: 44186666, projected_points: 14 }, { slate_player_id: 44187005, projected_points: 9.5 }, { slate_player_id: 44187045, projected_points: 9 }, { slate_player_id: 44187052, projected_points: 7.5 }] })
// Print caller-source portfolio and exposures
const p = byopRes.portfolio
const excl = byopRes.diagnostics.excluded?.by_caller ?? 0
const shortfalls = (p.min_exposure_shortfalls ?? []).length
console.log(`Slate ${byopRes.slate.id} (${byopRes.slate.league}/${byopRes.slate.operator}) | source=${byopRes.source.name} lineups=${p.lineup_count} unique=${p.unique_players} mean_pts=${p.mean_projected_points.toFixed(2)}`)
console.log(`Diversity pds=${p.diversity.composite_diversity_score.toFixed(2)} overlap=${p.mean_pairwise_overlap.toFixed(2)} max_overlap=${p.diversity.max_pair_overlap} eff_shannon=${p.diversity.effective_players_shannon.toFixed(2)} excluded=${excl} shortfalls=${shortfalls}`)
const sortedExps = [...p.exposures].sort((a, b) => b.lineups - a.lineups || a.slate_player_id - b.slate_player_id)
for (const e of sortedExps.slice(0, 8)) {
console.log(`Exposure ${e.name ?? ''} (${e.team ?? ''}) | lineups=${e.lineups}/${p.lineup_count} pct=${e.exposure_pct.toFixed(2)}%`)
}
for (const l of byopRes.lineups.slice(0, 3)) {
console.log(`Lineup #${l.rank} | salary=${l.salary} pts=${l.projected_points.toFixed(2)} stack=${l.stack.summary}`)
}Verified output across all 4 SDKs
TypeScript, Python, Go, and Java execute cleanly and print byte-identical output:
Slate 1126128 (nfl/draftkings) | source=caller lineups=5 unique=15 mean_pts=161.80
Diversity pds=0.49 overlap=6.10 max_overlap=7 eff_shannon=13.15 excluded=0 shortfalls=0
Exposure Justin Jefferson (MIN) | lineups=5/5 pct=100.00%
Exposure Tyler Shough (NO) | lineups=5/5 pct=100.00%
Exposure Emmett Johnson (KC) | lineups=5/5 pct=100.00%
Exposure CeeDee Lamb (DAL) | lineups=4/5 pct=80.00%
Exposure Tyler Warren (IND) | lineups=4/5 pct=80.00%
Exposure Gavin Bartholomew (MIN) | lineups=4/5 pct=80.00%
Exposure Bijan Robinson (ATL) | lineups=3/5 pct=60.00%
Exposure James Cook III (BUF) | lineups=3/5 pct=60.00%
Lineup #1 | salary=50000 pts=163.00 stack=Naked QB (NO)
Lineup #2 | salary=50000 pts=162.00 stack=Naked QB (NO)
Lineup #3 | salary=50000 pts=162.00 stack=Naked QB (NO)