SIM nfl API
nfl
sim.nflbetaNFL play-by-play simulator (`SIM` module). Runs N parallel Monte Carlo rollouts from `game_id` with optional simple overrides (`total`, `home_spread`, `weather`, `home`, `away`, `players`) and returns `summary`, `distributions`, `scorebox`, `pbp`, `scenarios`, and `simulations` sections controlled by `include`.
POST/api/v1/sim/nfl/runAuto-hydrate pre-kickoff inputs from game_id and run N parallel play-by-play Monte Carlo draws with optional simple v1 overridesbeta
Used in the tutorial: 1. Run your first NFL game simulation, 2. See the whole range of outcomes, 3. Meet six typical games, 4. Replay one simulated game, 5. Ask a what-if question
Request Body & Explorer(19 top-level · 53 total fields · depth 2)
Interactive Schema Skeleton (click any row to inspect & expand/collapse)
19 top-level
{
"game_id":0,
"n_draws":0,
"seed":0,
"include":{
"summary":false,
"distributions":false,
"scorebox":false,
"pbp":false,
"scorebox_limit":0,
"pbp_draws":"...",
"scenarios":false,
"scenarios_pbp":false,
"scenarios_limit":0,
"simulations":false,
"simulations_pbp":false,
"simulations_limit":0
},
"scenarios":0,
"scenarios_pbp":false,
"simulations":false,
"simulations_pbp":false,
"simulations_limit":0,
"home_score":"...",
"away_score":"...",
"total":"...",
"home_spread":"...",
"home_win_pct":"...",
"mode":"...",
"weather":{
"roof":"...",
"temp_f":"...",
"wind_mph":"...",
"precip_in_hr":"..."
},
"home":{
"out":"...",
"expected_plays":"...",
"neutral_pass_rate_pct":"..."
},
"away":{
"out":"...",
"expected_plays":"...",
"neutral_pass_rate_pct":"..."
},
"players":{
"player_id":0,
"out":false,
"status":"...",
"play_chance_pct":"...",
"snap_share_pct":"...",
"pass_yd":"...",
"pass_td":"...",
"rush_yd":"...",
"rec_yd":"...",
"receptions":"...",
"carries":"...",
"td":"..."
}
}
›game_id
game_idintegerrequiredGame ID to simulate (`43418` is free for all users).
Request
curl -sS --compressed -X POST \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"game_id":43418,"n_draws":2500,"seed":20261028,"include":{"summary":true,"distributions":true,"scorebox":true,"pbp":false,"scorebox_limit":10,"pbp_draws":[]}}' \
'https://api.stat-api.com/api/v1/sim/nfl/run'Responses
200Auto-hydrate pre-kickoff inputs from game_id and run N parallel play-by-play Monte Carlo draws with optional simple v1 overridesapplication/jsonshow example ▸
402PlanRequiredError when requesting a non-free game_id (game_id != 43418) without a Pro or Elite plan, or the DFS add-on.
Response Schema(3 fields)show schema ▸
1494 total fields (76 nested object/array groups)
Focus:
| Field | Type | References | Description |
|---|---|---|---|
matchup | NFLMatchupSummary | — | Effective matchup summary reflecting any spread/total overrides. |
↳game_id matchup.game_id | integer | — | Unique NFL game identifier (`43418` = `2026 Week 1 DEN @ KC`). |
↳season matchup.season | integer | — | NFL season year. |
↳week matchup.week | integer | — | NFL week number. |
↳season_type matchup.season_type | string | — | Season phase (`regular_season` or `postseason`). |
↳kickoff matchup.kickoff | stringnullable | — | Scheduled UTC kickoff timestamp (ISO-8601). |
↳day matchup.day | integernullable | — | Game date integer in `YYYYMMDD` format. |
↳home_team_id matchup.home_team_id | integer | — | Canonical home team ID. |
↳home_abbr matchup.home_abbr | string | — | Home team 2/3-letter abbreviation (e.g., `KC`). |
↳away_team_id matchup.away_team_id | integer | — | Canonical away team ID. |
↳away_abbr matchup.away_abbr | string | — | Away team 2/3-letter abbreviation (e.g., `DEN`). |
↳spread_home matchup.spread_home | number | — | Pre-kickoff Vegas home spread in points (negative means home is favored, e.g. `-3.0`). |
↳game_total matchup.game_total | number | — | Pre-kickoff Vegas over/under total points (e.g., `47.5`). |
↳home_team_total matchup.home_team_total | number | — | Implied pre-kickoff home team total points (`(game_total - spread_home) / 2`). |
↳away_team_total matchup.away_team_total | number | — | Implied pre-kickoff away team total points (`(game_total + spread_home) / 2`). |
↳moneyline_home matchup.moneyline_home | integernullable | — | Pre-kickoff American moneyline for the home team (e.g., `-162`). |
↳moneyline_away matchup.moneyline_away | integernullable | — | Pre-kickoff American moneyline for the away team (e.g., `+136`). |
↳is_final matchup.is_final | boolean | — | True if the real NFL game has completed. |
↳real_home_pts matchup.real_home_pts | integernullable | — | Actual final home points scored (populated when `is_final = true`). |
↳real_away_pts matchup.real_away_pts | integernullable | — | Actual final away points scored (populated when `is_final = true`). |
↳is_free matchup.is_free | boolean | — | True when this game is unlocked for free full-depth simulation (`game_id == 43418`). |
input_sha256 | string | — | SHA-256 fingerprint of the compiled simulation input pack. |
output | NFLSimGranularOutput | — | Monte Carlo simulation output holding the sections requested in `include`. |
↳game_id output.game_id | integer | — | Simulated NFL game ID. |
↳n_draws output.n_draws | integer | — | Number of Monte Carlo draws executed. |
↳seed output.seed | integer | — | 64-bit CRN seed used for the rollout. |
↳solve_elapsed_ms output.solve_elapsed_ms | number | — | Wall-clock milliseconds spent in the Pre-Sim CRN Vegas Calibration Solver. |
↳sim_elapsed_ms output.sim_elapsed_ms | number | — | Wall-clock milliseconds spent executing the parallel play-by-play rollout. |
↳summary output.summary | NFLSimSummarySectionnullable | — | Populated when `include.summary = true`. |
↳game_id output.summary.game_id | integer | — | Canonical game ID. |
↳season output.summary.season | integer | — | NFL season year. |
↳week output.summary.week | integer | — | NFL week number. |
↳n_draws output.summary.n_draws | integer | — | Number of simulated draws aggregated. |
↳seed output.summary.seed | integer | — | 64-bit CRN seed. |
↳has_vegas_line output.summary.has_vegas_line | boolean | — | True if calibrated to Vegas lines; false in Zero-Vegas Mode 0. |
↳vegas_spread_home output.summary.vegas_spread_home | number | — | Input Vegas home spread. |
↳vegas_total output.summary.vegas_total | number | — | Input Vegas game total. |
↳sim_total_mean output.summary.sim_total_mean | number | — | Simulated mean combined points across all draws. |
↳sim_total_sd output.summary.sim_total_sd | number | — | Simulated standard deviation of combined points. |
↳sim_spread_home_mean output.summary.sim_spread_home_mean | number | — | Simulated mean home spread (`away_pts - home_pts`). |
↳sim_spread_home_sd output.summary.sim_spread_home_sd | number | — | Simulated standard deviation of score margin. |
↳home_win_prob output.summary.home_win_prob | number | — | Simulated home win probability (`0.0..1.0`). |
↳away_win_prob output.summary.away_win_prob | number | — | Simulated away win probability (`0.0..1.0`). |
↳tie_prob output.summary.tie_prob | number | — | Simulated tie probability after overtime (`0.0..1.0`). |
↳home_cover_prob output.summary.home_cover_prob | number | — | Probability that the home team covers `vegas_spread_home` (excluding pushes). |
↳over_prob output.summary.over_prob | number | — | Probability that combined points exceed `vegas_total` (excluding pushes). |
↳overtime_rate output.summary.overtime_rate | number | — | Fraction of simulated games that went to overtime (`0.0..1.0`). |
↳solve_elapsed_ms output.summary.solve_elapsed_ms | number | — | Pre-sim CRN Vegas solver runtime in milliseconds. |
↳sim_elapsed_ms output.summary.sim_elapsed_ms | number | — | Parallel play-by-play simulation runtime in milliseconds. |
↳conservation_ok output.summary.conservation_ok | boolean | — | True when 100% of simulated draws satisfied every C0 physical conservation identity. |
↳c0_max_diff output.summary.c0_max_diff | number | — | Maximum absolute discrepancy across all C0 conservation identities (`0.0` when exact). |
↳home_team output.summary.home_team | NFLSimTeamSummary | — | Aggregated home team summary statistics. |
↳team_id output.summary.home_team.team_id | integer | — | Canonical team ID. |
↳is_home output.summary.home_team.is_home | boolean | — | True for home team, false for away team. |
↳vegas_team_total output.summary.home_team.vegas_team_total | number | — | Input implied Vegas team total points. |
↳points_mean output.summary.home_team.points_mean | number | — | Simulated mean points scored. |
↳points_sd output.summary.home_team.points_sd | number | — | Standard deviation of points scored. |
↳points_p10 output.summary.home_team.points_p10 | number | — | 10th percentile of points scored. |
↳points_p50 output.summary.home_team.points_p50 | number | — | Median (50th percentile) points scored. |
↳points_p90 output.summary.home_team.points_p90 | number | — | 90th percentile of points scored. |
↳q1_points_mean output.summary.home_team.q1_points_mean | number | — | Mean 1st-quarter points. |
↳q2_points_mean output.summary.home_team.q2_points_mean | number | — | Mean 2nd-quarter points. |
↳q3_points_mean output.summary.home_team.q3_points_mean | number | — | Mean 3rd-quarter points. |
↳q4_points_mean output.summary.home_team.q4_points_mean | number | — | Mean 4th-quarter points. |
↳ot_points_mean output.summary.home_team.ot_points_mean | number | — | Mean overtime points. |
↳win_prob output.summary.home_team.win_prob | number | — | Team win probability (`0.0..1.0`). |
↳plays_mean output.summary.home_team.plays_mean | number | — | Mean offensive plays (`pass_att + rush_att + sacks_taken`). |
↳pass_att_mean output.summary.home_team.pass_att_mean | number | — | Mean team pass attempts. |
↳pass_cmp_mean output.summary.home_team.pass_cmp_mean | number | — | Mean team pass completions. |
↳pass_yd_mean output.summary.home_team.pass_yd_mean | number | — | Mean team gross passing yards. |
↳pass_td_mean output.summary.home_team.pass_td_mean | number | — | Mean team passing touchdowns. |
↳int_mean output.summary.home_team.int_mean | number | — | Mean interceptions thrown. |
↳rush_att_mean output.summary.home_team.rush_att_mean | number | — | Mean team rushing attempts. |
↳rush_yd_mean output.summary.home_team.rush_yd_mean | number | — | Mean team rushing yards. |
↳rush_td_mean output.summary.home_team.rush_td_mean | number | — | Mean team rushing touchdowns. |
↳sacks_taken_mean output.summary.home_team.sacks_taken_mean | number | — | Mean sacks taken by the offense. |
↳drives_mean output.summary.home_team.drives_mean | number | — | Mean offensive drives per game. |
↳drive_td_rate output.summary.home_team.drive_td_rate | number | — | Fraction of offensive drives ending in an offensive touchdown (`0.0..1.0`). |
↳drive_fg_rate output.summary.home_team.drive_fg_rate | number | — | Fraction of offensive drives ending in a made field goal (`0.0..1.0`). |
↳drive_punt_rate output.summary.home_team.drive_punt_rate | number | — | Fraction of offensive drives ending in a punt (`0.0..1.0`). |
↳drive_turnover_rate output.summary.home_team.drive_turnover_rate | number | — | Fraction of offensive drives ending in an interception or lost fumble (`0.0..1.0`). |
↳third_down_conv_rate output.summary.home_team.third_down_conv_rate | number | — | 3rd-down conversion rate (`0.0..1.0`). |
↳fourth_down_conv_rate output.summary.home_team.fourth_down_conv_rate | number | — | 4th-down go-for-it conversion rate (`0.0..1.0`). |
↳dst_sacks_mean output.summary.home_team.dst_sacks_mean | number | — | Mean defensive sacks recorded against the opponent. |
↳dst_int_mean output.summary.home_team.dst_int_mean | number | — | Mean defensive interceptions recorded. |
↳dst_fumbles_rec_mean output.summary.home_team.dst_fumbles_rec_mean | number | — | Mean opponent fumbles recovered by the defense. |
↳dst_td_mean output.summary.home_team.dst_td_mean | number | — | Mean defensive/return touchdowns scored. |
↳dst_pts_allowed_mean output.summary.home_team.dst_pts_allowed_mean | number | — | Mean points allowed by the defense. |
↳away_team output.summary.away_team | NFLSimTeamSummary | — | Aggregated away team summary statistics. |
↳team_id output.summary.away_team.team_id | integer | — | Canonical team ID. |
↳is_home output.summary.away_team.is_home | boolean | — | True for home team, false for away team. |
↳vegas_team_total output.summary.away_team.vegas_team_total | number | — | Input implied Vegas team total points. |
↳points_mean output.summary.away_team.points_mean | number | — | Simulated mean points scored. |
↳points_sd output.summary.away_team.points_sd | number | — | Standard deviation of points scored. |
↳points_p10 output.summary.away_team.points_p10 | number | — | 10th percentile of points scored. |
↳points_p50 output.summary.away_team.points_p50 | number | — | Median (50th percentile) points scored. |
↳points_p90 output.summary.away_team.points_p90 | number | — | 90th percentile of points scored. |
↳q1_points_mean output.summary.away_team.q1_points_mean | number | — | Mean 1st-quarter points. |
↳q2_points_mean output.summary.away_team.q2_points_mean | number | — | Mean 2nd-quarter points. |
↳q3_points_mean output.summary.away_team.q3_points_mean | number | — | Mean 3rd-quarter points. |
↳q4_points_mean output.summary.away_team.q4_points_mean | number | — | Mean 4th-quarter points. |
↳ot_points_mean output.summary.away_team.ot_points_mean | number | — | Mean overtime points. |
↳win_prob output.summary.away_team.win_prob | number | — | Team win probability (`0.0..1.0`). |
↳plays_mean output.summary.away_team.plays_mean | number | — | Mean offensive plays (`pass_att + rush_att + sacks_taken`). |
↳pass_att_mean output.summary.away_team.pass_att_mean | number | — | Mean team pass attempts. |
↳pass_cmp_mean output.summary.away_team.pass_cmp_mean | number | — | Mean team pass completions. |
↳pass_yd_mean output.summary.away_team.pass_yd_mean | number | — | Mean team gross passing yards. |
↳pass_td_mean output.summary.away_team.pass_td_mean | number | — | Mean team passing touchdowns. |
↳int_mean output.summary.away_team.int_mean | number | — | Mean interceptions thrown. |
↳rush_att_mean output.summary.away_team.rush_att_mean | number | — | Mean team rushing attempts. |
↳rush_yd_mean output.summary.away_team.rush_yd_mean | number | — | Mean team rushing yards. |
↳rush_td_mean output.summary.away_team.rush_td_mean | number | — | Mean team rushing touchdowns. |
↳sacks_taken_mean output.summary.away_team.sacks_taken_mean | number | — | Mean sacks taken by the offense. |
↳drives_mean output.summary.away_team.drives_mean | number | — | Mean offensive drives per game. |
↳drive_td_rate output.summary.away_team.drive_td_rate | number | — | Fraction of offensive drives ending in an offensive touchdown (`0.0..1.0`). |
↳drive_fg_rate output.summary.away_team.drive_fg_rate | number | — | Fraction of offensive drives ending in a made field goal (`0.0..1.0`). |
↳drive_punt_rate output.summary.away_team.drive_punt_rate | number | — | Fraction of offensive drives ending in a punt (`0.0..1.0`). |
↳drive_turnover_rate output.summary.away_team.drive_turnover_rate | number | — | Fraction of offensive drives ending in an interception or lost fumble (`0.0..1.0`). |
↳third_down_conv_rate output.summary.away_team.third_down_conv_rate | number | — | 3rd-down conversion rate (`0.0..1.0`). |
↳fourth_down_conv_rate output.summary.away_team.fourth_down_conv_rate | number | — | 4th-down go-for-it conversion rate (`0.0..1.0`). |
↳dst_sacks_mean output.summary.away_team.dst_sacks_mean | number | — | Mean defensive sacks recorded against the opponent. |
↳dst_int_mean output.summary.away_team.dst_int_mean | number | — | Mean defensive interceptions recorded. |
↳dst_fumbles_rec_mean output.summary.away_team.dst_fumbles_rec_mean | number | — | Mean opponent fumbles recovered by the defense. |
↳dst_td_mean output.summary.away_team.dst_td_mean | number | — | Mean defensive/return touchdowns scored. |
↳dst_pts_allowed_mean output.summary.away_team.dst_pts_allowed_mean | number | — | Mean points allowed by the defense. |
↳players output.summary.players | NFLSimPlayerSummary[] | — | Aggregated per-player summary projections, quantiles, milestones, and Vegas medians. |
↳player_id output.summary.players.player_id | integer | — | Canonical player ID. |
↳team_id output.summary.players.team_id | integer | — | Canonical team ID. |
↳is_home output.summary.players.is_home | boolean | — | True if on the home team. |
↳position output.summary.players.position | string | — | Skill position (`QB`, `RB`, `WR`, `TE`, `K`, `DST`). |
↳depth_role output.summary.players.depth_role | string | — | Depth chart role (`QB1`, `RB1`, `WR1`, `TE1`, etc.). |
↳market_tier output.summary.players.market_tier | string | — | Market calibration tier (`RICH_LADDER`, `MAIN_LINES`, `NO_PROPS_SHRINKAGE`). |
↳p_active output.summary.players.p_active | number | — | Fraction of simulated draws in which the player was active (`0.0..1.0`). |
↳snaps_mean output.summary.players.snaps_mean | number | — | Mean offensive snaps played. |
↳snaps_p50 output.summary.players.snaps_p50 | number | — | Median offensive snaps played. |
↳routes_mean output.summary.players.routes_mean | number | — | Mean pass routes run. |
↳pass_cmp_mean output.summary.players.pass_cmp_mean | number | — | Mean pass completions. |
↳pass_att_mean output.summary.players.pass_att_mean | number | — | Mean pass attempts. |
↳pass_yd_mean output.summary.players.pass_yd_mean | number | — | Mean passing yards. |
↳pass_yd_sd output.summary.players.pass_yd_sd | number | — | Standard deviation of passing yards. |
↳pass_yd_p10 output.summary.players.pass_yd_p10 | number | — | 10th percentile passing yards. |
↳pass_yd_p50 output.summary.players.pass_yd_p50 | number | — | Median (50th percentile) passing yards. |
↳pass_yd_p90 output.summary.players.pass_yd_p90 | number | — | 90th percentile passing yards. |
↳pass_td_mean output.summary.players.pass_td_mean | number | — | Mean passing touchdowns. |
↳int_mean output.summary.players.int_mean | number | — | Mean interceptions thrown. |
↳longest_pass_p50 output.summary.players.longest_pass_p50 | number | — | Median longest completion in yards. |
↳carries_mean output.summary.players.carries_mean | number | — | Mean total rushing attempts (`designed_rushes + scrambles + kneels`). |
↳designed_rushes_mean output.summary.players.designed_rushes_mean | number | — | Mean designed rushing attempts. |
↳scrambles_mean output.summary.players.scrambles_mean | number | — | Mean QB scramble rushes. |
↳rush_yd_mean output.summary.players.rush_yd_mean | number | — | Mean rushing yards. |
↳rush_yd_sd output.summary.players.rush_yd_sd | number | — | Standard deviation of rushing yards. |
↳rush_yd_p10 output.summary.players.rush_yd_p10 | number | — | 10th percentile rushing yards. |
↳rush_yd_p50 output.summary.players.rush_yd_p50 | number | — | Median (50th percentile) rushing yards. |
↳rush_yd_p90 output.summary.players.rush_yd_p90 | number | — | 90th percentile rushing yards. |
↳rush_td_mean output.summary.players.rush_td_mean | number | — | Mean rushing touchdowns. |
↳longest_rush_p50 output.summary.players.longest_rush_p50 | number | — | Median longest rush in yards. |
↳targets_mean output.summary.players.targets_mean | number | — | Mean receiving targets. |
↳receptions_mean output.summary.players.receptions_mean | number | — | Mean receptions. |
↳rec_yd_mean output.summary.players.rec_yd_mean | number | — | Mean receiving yards. |
↳rec_yd_sd output.summary.players.rec_yd_sd | number | — | Standard deviation of receiving yards. |
↳rec_yd_p10 output.summary.players.rec_yd_p10 | number | — | 10th percentile receiving yards. |
↳rec_yd_p50 output.summary.players.rec_yd_p50 | number | — | Median (50th percentile) receiving yards. |
↳rec_yd_p90 output.summary.players.rec_yd_p90 | number | — | 90th percentile receiving yards. |
↳rec_td_mean output.summary.players.rec_td_mean | number | — | Mean receiving touchdowns. |
↳air_yd_mean output.summary.players.air_yd_mean | number | — | Mean target air yards. |
↳yac_yd_mean output.summary.players.yac_yd_mean | number | — | Mean yards after catch (YAC). |
↳longest_rec_p50 output.summary.players.longest_rec_p50 | number | — | Median longest reception in yards. |
↳fg_made_mean output.summary.players.fg_made_mean | number | — | Mean field goals made. |
↳fg_att_mean output.summary.players.fg_att_mean | number | — | Mean field goals attempted. |
↳xp_made_mean output.summary.players.xp_made_mean | number | — | Mean extra points (PATs) made. |
↳kick_pts_mean output.summary.players.kick_pts_mean | number | — | Mean kicking points (`3 * fg_made + xp_made`). |
↳fumbles_lost_mean output.summary.players.fumbles_lost_mean | number | — | Mean fumbles lost. |
↳p_anytime_td output.summary.players.p_anytime_td | number | — | Probability of scoring 1+ rushing or receiving touchdowns (`0.0..1.0`). |
↳p_2plus_td output.summary.players.p_2plus_td | number | — | Probability of scoring 2+ rushing or receiving touchdowns (`0.0..1.0`). |
↳p_pass_300yd output.summary.players.p_pass_300yd | number | — | Probability of recording 300+ passing yards (`0.0..1.0`). |
↳p_rush_100yd output.summary.players.p_rush_100yd | number | — | Probability of recording 100+ rushing yards (`0.0..1.0`). |
↳p_rec_100yd output.summary.players.p_rec_100yd | number | — | Probability of recording 100+ receiving yards (`0.0..1.0`). |
↳vegas_pass_yd output.summary.players.vegas_pass_yd | numbernullable | — | Input Vegas passing yards median for direct calibration comparison. |
↳vegas_pass_att output.summary.players.vegas_pass_att | numbernullable | — | Input Vegas pass attempts median. |
↳vegas_rush_yd output.summary.players.vegas_rush_yd | numbernullable | — | Input Vegas rushing yards median. |
↳vegas_carries output.summary.players.vegas_carries | numbernullable | — | Input Vegas rushing attempts median. |
↳vegas_rec_yd output.summary.players.vegas_rec_yd | numbernullable | — | Input Vegas receiving yards median. |
↳vegas_receptions output.summary.players.vegas_receptions | numbernullable | — | Input Vegas receptions median. |
↳vegas_td_prob output.summary.players.vegas_td_prob | numbernullable | — | Input de-vigged Vegas anytime TD probability. |
↳distributions output.distributions | NFLSimDistributionsSectionnullable | — | Populated when `include.distributions = true`. |
↳total_points output.distributions.total_points | NFLSimBellCurve | — | Bell curve of combined game points (`home_pts + away_pts`) with `vegas_line = total`. |
↳metric output.distributions.total_points.metric | string | — | Machine metric key (`total_points`, `home_points`, `pass_yd`, `rec_yd`, etc.). |
↳label output.distributions.total_points.label | string | — | Human-readable chart title. |
↳discrete output.distributions.total_points.discrete | boolean | — | True if the metric is integer-valued (`receptions`, `targets`, `carries`). |
↳n_draws output.distributions.total_points.n_draws | integer | — | Number of draws summarized in the distribution. |
↳mean output.distributions.total_points.mean | number | — | Empirical mean across all draws. |
↳sd output.distributions.total_points.sd | number | — | Empirical standard deviation. |
↳skew output.distributions.total_points.skew | number | — | Empirical third standardized moment (skewness). |
↳min output.distributions.total_points.min | number | — | Minimum observed value across all draws. |
↳max output.distributions.total_points.max | number | — | Maximum observed value across all draws. |
↳p05 output.distributions.total_points.p05 | number | — | 5th percentile. |
↳p10 output.distributions.total_points.p10 | number | — | 10th percentile. |
↳p25 output.distributions.total_points.p25 | number | — | 25th percentile. |
↳p50 output.distributions.total_points.p50 | number | — | 50th percentile (median). |
↳p75 output.distributions.total_points.p75 | number | — | 75th percentile. |
↳p90 output.distributions.total_points.p90 | number | — | 90th percentile. |
↳p95 output.distributions.total_points.p95 | number | — | 95th percentile. |
↳vegas_line output.distributions.total_points.vegas_line | numbernullable | — | Reference Vegas prop or game line for vertical chart overlay (`null` when unpriced). |
↳p_over_vegas output.distributions.total_points.p_over_vegas | numbernullable | — | Simulated probability of exceeding `vegas_line` (`0.0..1.0`). |
↳bins output.distributions.total_points.bins | NFLHistogramBin[] | — | Histogram bins with empirical probability, CDF, Gaussian density, KDE density, and representative `sample_draw_idx`. |
↳x_min output.distributions.total_points.bins.x_min | number | — | Inclusive lower bound of the bin. |
↳x_max output.distributions.total_points.bins.x_max | number | — | Upper bound of the bin. |
↳x_mid output.distributions.total_points.bins.x_mid | number | — | Midpoint of the bin (`0.5 * (x_min + x_max)`). |
↳count output.distributions.total_points.bins.count | integer | — | Number of simulated draws falling into this bin. |
↳prob output.distributions.total_points.bins.prob | number | — | Empirical bin probability mass (`count / n_draws`). |
↳cum_prob output.distributions.total_points.bins.cum_prob | number | — | Cumulative distribution function `P(X <= x_max)` (`0.0..1.0`). |
↳gaussian_density output.distributions.total_points.bins.gaussian_density | number | — | Moment-matched Gaussian probability mass over this bin width for normal-curve comparison. |
↳kde_density output.distributions.total_points.bins.kde_density | number | — | Silverman-bandwidth Gaussian Kernel Density Estimate (KDE) probability mass over this bin width. |
↳sample_draw_idx output.distributions.total_points.bins.sample_draw_idx | integernullable | — | Representative `draw_idx` closest to `x_mid` inside this bin (pass in `include.pbp_draws` on `POST /api/v1/sim/nfl/run` to replay its play-by-play). |
↳spread_margin_home output.distributions.spread_margin_home | NFLSimBellCurve | — | Bell curve of home score margin (`home_pts - away_pts`) with `vegas_line = -spread_home`. |
↳metric output.distributions.spread_margin_home.metric | string | — | Machine metric key (`total_points`, `home_points`, `pass_yd`, `rec_yd`, etc.). |
↳label output.distributions.spread_margin_home.label | string | — | Human-readable chart title. |
↳discrete output.distributions.spread_margin_home.discrete | boolean | — | True if the metric is integer-valued (`receptions`, `targets`, `carries`). |
↳n_draws output.distributions.spread_margin_home.n_draws | integer | — | Number of draws summarized in the distribution. |
↳mean output.distributions.spread_margin_home.mean | number | — | Empirical mean across all draws. |
↳sd output.distributions.spread_margin_home.sd | number | — | Empirical standard deviation. |
↳skew output.distributions.spread_margin_home.skew | number | — | Empirical third standardized moment (skewness). |
↳min output.distributions.spread_margin_home.min | number | — | Minimum observed value across all draws. |
↳max output.distributions.spread_margin_home.max | number | — | Maximum observed value across all draws. |
↳p05 output.distributions.spread_margin_home.p05 | number | — | 5th percentile. |
↳p10 output.distributions.spread_margin_home.p10 | number | — | 10th percentile. |
↳p25 output.distributions.spread_margin_home.p25 | number | — | 25th percentile. |
↳p50 output.distributions.spread_margin_home.p50 | number | — | 50th percentile (median). |
↳p75 output.distributions.spread_margin_home.p75 | number | — | 75th percentile. |
↳p90 output.distributions.spread_margin_home.p90 | number | — | 90th percentile. |
↳p95 output.distributions.spread_margin_home.p95 | number | — | 95th percentile. |
↳vegas_line output.distributions.spread_margin_home.vegas_line | numbernullable | — | Reference Vegas prop or game line for vertical chart overlay (`null` when unpriced). |
↳p_over_vegas output.distributions.spread_margin_home.p_over_vegas | numbernullable | — | Simulated probability of exceeding `vegas_line` (`0.0..1.0`). |
↳bins output.distributions.spread_margin_home.bins | NFLHistogramBin[] | — | Histogram bins with empirical probability, CDF, Gaussian density, KDE density, and representative `sample_draw_idx`. |
↳x_min output.distributions.spread_margin_home.bins.x_min | number | — | Inclusive lower bound of the bin. |
↳x_max output.distributions.spread_margin_home.bins.x_max | number | — | Upper bound of the bin. |
↳x_mid output.distributions.spread_margin_home.bins.x_mid | number | — | Midpoint of the bin (`0.5 * (x_min + x_max)`). |
↳count output.distributions.spread_margin_home.bins.count | integer | — | Number of simulated draws falling into this bin. |
↳prob output.distributions.spread_margin_home.bins.prob | number | — | Empirical bin probability mass (`count / n_draws`). |
↳cum_prob output.distributions.spread_margin_home.bins.cum_prob | number | — | Cumulative distribution function `P(X <= x_max)` (`0.0..1.0`). |
↳gaussian_density output.distributions.spread_margin_home.bins.gaussian_density | number | — | Moment-matched Gaussian probability mass over this bin width for normal-curve comparison. |
↳kde_density output.distributions.spread_margin_home.bins.kde_density | number | — | Silverman-bandwidth Gaussian Kernel Density Estimate (KDE) probability mass over this bin width. |
↳sample_draw_idx output.distributions.spread_margin_home.bins.sample_draw_idx | integernullable | — | Representative `draw_idx` closest to `x_mid` inside this bin (pass in `include.pbp_draws` on `POST /api/v1/sim/nfl/run` to replay its play-by-play). |
↳home_points output.distributions.home_points | NFLSimBellCurve | — | Bell curve of home team points scored. |
↳metric output.distributions.home_points.metric | string | — | Machine metric key (`total_points`, `home_points`, `pass_yd`, `rec_yd`, etc.). |
↳label output.distributions.home_points.label | string | — | Human-readable chart title. |
↳discrete output.distributions.home_points.discrete | boolean | — | True if the metric is integer-valued (`receptions`, `targets`, `carries`). |
↳n_draws output.distributions.home_points.n_draws | integer | — | Number of draws summarized in the distribution. |
↳mean output.distributions.home_points.mean | number | — | Empirical mean across all draws. |
↳sd output.distributions.home_points.sd | number | — | Empirical standard deviation. |
↳skew output.distributions.home_points.skew | number | — | Empirical third standardized moment (skewness). |
↳min output.distributions.home_points.min | number | — | Minimum observed value across all draws. |
↳max output.distributions.home_points.max | number | — | Maximum observed value across all draws. |
↳p05 output.distributions.home_points.p05 | number | — | 5th percentile. |
↳p10 output.distributions.home_points.p10 | number | — | 10th percentile. |
↳p25 output.distributions.home_points.p25 | number | — | 25th percentile. |
↳p50 output.distributions.home_points.p50 | number | — | 50th percentile (median). |
↳p75 output.distributions.home_points.p75 | number | — | 75th percentile. |
↳p90 output.distributions.home_points.p90 | number | — | 90th percentile. |
↳p95 output.distributions.home_points.p95 | number | — | 95th percentile. |
↳vegas_line output.distributions.home_points.vegas_line | numbernullable | — | Reference Vegas prop or game line for vertical chart overlay (`null` when unpriced). |
↳p_over_vegas output.distributions.home_points.p_over_vegas | numbernullable | — | Simulated probability of exceeding `vegas_line` (`0.0..1.0`). |
↳bins output.distributions.home_points.bins | NFLHistogramBin[] | — | Histogram bins with empirical probability, CDF, Gaussian density, KDE density, and representative `sample_draw_idx`. |
↳x_min output.distributions.home_points.bins.x_min | number | — | Inclusive lower bound of the bin. |
↳x_max output.distributions.home_points.bins.x_max | number | — | Upper bound of the bin. |
↳x_mid output.distributions.home_points.bins.x_mid | number | — | Midpoint of the bin (`0.5 * (x_min + x_max)`). |
↳count output.distributions.home_points.bins.count | integer | — | Number of simulated draws falling into this bin. |
↳prob output.distributions.home_points.bins.prob | number | — | Empirical bin probability mass (`count / n_draws`). |
↳cum_prob output.distributions.home_points.bins.cum_prob | number | — | Cumulative distribution function `P(X <= x_max)` (`0.0..1.0`). |
↳gaussian_density output.distributions.home_points.bins.gaussian_density | number | — | Moment-matched Gaussian probability mass over this bin width for normal-curve comparison. |
↳kde_density output.distributions.home_points.bins.kde_density | number | — | Silverman-bandwidth Gaussian Kernel Density Estimate (KDE) probability mass over this bin width. |
↳sample_draw_idx output.distributions.home_points.bins.sample_draw_idx | integernullable | — | Representative `draw_idx` closest to `x_mid` inside this bin (pass in `include.pbp_draws` on `POST /api/v1/sim/nfl/run` to replay its play-by-play). |
↳away_points output.distributions.away_points | NFLSimBellCurve | — | Bell curve of away team points scored. |
↳metric output.distributions.away_points.metric | string | — | Machine metric key (`total_points`, `home_points`, `pass_yd`, `rec_yd`, etc.). |
↳label output.distributions.away_points.label | string | — | Human-readable chart title. |
↳discrete output.distributions.away_points.discrete | boolean | — | True if the metric is integer-valued (`receptions`, `targets`, `carries`). |
↳n_draws output.distributions.away_points.n_draws | integer | — | Number of draws summarized in the distribution. |
↳mean output.distributions.away_points.mean | number | — | Empirical mean across all draws. |
↳sd output.distributions.away_points.sd | number | — | Empirical standard deviation. |
↳skew output.distributions.away_points.skew | number | — | Empirical third standardized moment (skewness). |
↳min output.distributions.away_points.min | number | — | Minimum observed value across all draws. |
↳max output.distributions.away_points.max | number | — | Maximum observed value across all draws. |
↳p05 output.distributions.away_points.p05 | number | — | 5th percentile. |
↳p10 output.distributions.away_points.p10 | number | — | 10th percentile. |
↳p25 output.distributions.away_points.p25 | number | — | 25th percentile. |
↳p50 output.distributions.away_points.p50 | number | — | 50th percentile (median). |
↳p75 output.distributions.away_points.p75 | number | — | 75th percentile. |
↳p90 output.distributions.away_points.p90 | number | — | 90th percentile. |
↳p95 output.distributions.away_points.p95 | number | — | 95th percentile. |
↳vegas_line output.distributions.away_points.vegas_line | numbernullable | — | Reference Vegas prop or game line for vertical chart overlay (`null` when unpriced). |
↳p_over_vegas output.distributions.away_points.p_over_vegas | numbernullable | — | Simulated probability of exceeding `vegas_line` (`0.0..1.0`). |
↳bins output.distributions.away_points.bins | NFLHistogramBin[] | — | Histogram bins with empirical probability, CDF, Gaussian density, KDE density, and representative `sample_draw_idx`. |
↳x_min output.distributions.away_points.bins.x_min | number | — | Inclusive lower bound of the bin. |
↳x_max output.distributions.away_points.bins.x_max | number | — | Upper bound of the bin. |
↳x_mid output.distributions.away_points.bins.x_mid | number | — | Midpoint of the bin (`0.5 * (x_min + x_max)`). |
↳count output.distributions.away_points.bins.count | integer | — | Number of simulated draws falling into this bin. |
↳prob output.distributions.away_points.bins.prob | number | — | Empirical bin probability mass (`count / n_draws`). |
↳cum_prob output.distributions.away_points.bins.cum_prob | number | — | Cumulative distribution function `P(X <= x_max)` (`0.0..1.0`). |
↳gaussian_density output.distributions.away_points.bins.gaussian_density | number | — | Moment-matched Gaussian probability mass over this bin width for normal-curve comparison. |
↳kde_density output.distributions.away_points.bins.kde_density | number | — | Silverman-bandwidth Gaussian Kernel Density Estimate (KDE) probability mass over this bin width. |
↳sample_draw_idx output.distributions.away_points.bins.sample_draw_idx | integernullable | — | Representative `draw_idx` closest to `x_mid` inside this bin (pass in `include.pbp_draws` on `POST /api/v1/sim/nfl/run` to replay its play-by-play). |
↳combined_plays output.distributions.combined_plays | NFLSimBellCurve | — | Bell curve of combined offensive plays run by both teams. |
↳metric output.distributions.combined_plays.metric | string | — | Machine metric key (`total_points`, `home_points`, `pass_yd`, `rec_yd`, etc.). |
↳label output.distributions.combined_plays.label | string | — | Human-readable chart title. |
↳discrete output.distributions.combined_plays.discrete | boolean | — | True if the metric is integer-valued (`receptions`, `targets`, `carries`). |
↳n_draws output.distributions.combined_plays.n_draws | integer | — | Number of draws summarized in the distribution. |
↳mean output.distributions.combined_plays.mean | number | — | Empirical mean across all draws. |
↳sd output.distributions.combined_plays.sd | number | — | Empirical standard deviation. |
↳skew output.distributions.combined_plays.skew | number | — | Empirical third standardized moment (skewness). |
↳min output.distributions.combined_plays.min | number | — | Minimum observed value across all draws. |
↳max output.distributions.combined_plays.max | number | — | Maximum observed value across all draws. |
↳p05 output.distributions.combined_plays.p05 | number | — | 5th percentile. |
↳p10 output.distributions.combined_plays.p10 | number | — | 10th percentile. |
↳p25 output.distributions.combined_plays.p25 | number | — | 25th percentile. |
↳p50 output.distributions.combined_plays.p50 | number | — | 50th percentile (median). |
↳p75 output.distributions.combined_plays.p75 | number | — | 75th percentile. |
↳p90 output.distributions.combined_plays.p90 | number | — | 90th percentile. |
↳p95 output.distributions.combined_plays.p95 | number | — | 95th percentile. |
↳vegas_line output.distributions.combined_plays.vegas_line | numbernullable | — | Reference Vegas prop or game line for vertical chart overlay (`null` when unpriced). |
↳p_over_vegas output.distributions.combined_plays.p_over_vegas | numbernullable | — | Simulated probability of exceeding `vegas_line` (`0.0..1.0`). |
↳bins output.distributions.combined_plays.bins | NFLHistogramBin[] | — | Histogram bins with empirical probability, CDF, Gaussian density, KDE density, and representative `sample_draw_idx`. |
↳x_min output.distributions.combined_plays.bins.x_min | number | — | Inclusive lower bound of the bin. |
↳x_max output.distributions.combined_plays.bins.x_max | number | — | Upper bound of the bin. |
↳x_mid output.distributions.combined_plays.bins.x_mid | number | — | Midpoint of the bin (`0.5 * (x_min + x_max)`). |
↳count output.distributions.combined_plays.bins.count | integer | — | Number of simulated draws falling into this bin. |
↳prob output.distributions.combined_plays.bins.prob | number | — | Empirical bin probability mass (`count / n_draws`). |
↳cum_prob output.distributions.combined_plays.bins.cum_prob | number | — | Cumulative distribution function `P(X <= x_max)` (`0.0..1.0`). |
↳gaussian_density output.distributions.combined_plays.bins.gaussian_density | number | — | Moment-matched Gaussian probability mass over this bin width for normal-curve comparison. |
↳kde_density output.distributions.combined_plays.bins.kde_density | number | — | Silverman-bandwidth Gaussian Kernel Density Estimate (KDE) probability mass over this bin width. |
↳sample_draw_idx output.distributions.combined_plays.bins.sample_draw_idx | integernullable | — | Representative `draw_idx` closest to `x_mid` inside this bin (pass in `include.pbp_draws` on `POST /api/v1/sim/nfl/run` to replay its play-by-play). |
↳home_pass_yd output.distributions.home_pass_yd | NFLSimBellCurve | — | Bell curve of home team gross passing yards. |
↳metric output.distributions.home_pass_yd.metric | string | — | Machine metric key (`total_points`, `home_points`, `pass_yd`, `rec_yd`, etc.). |
↳label output.distributions.home_pass_yd.label | string | — | Human-readable chart title. |
↳discrete output.distributions.home_pass_yd.discrete | boolean | — | True if the metric is integer-valued (`receptions`, `targets`, `carries`). |
↳n_draws output.distributions.home_pass_yd.n_draws | integer | — | Number of draws summarized in the distribution. |
↳mean output.distributions.home_pass_yd.mean | number | — | Empirical mean across all draws. |
↳sd output.distributions.home_pass_yd.sd | number | — | Empirical standard deviation. |
↳skew output.distributions.home_pass_yd.skew | number | — | Empirical third standardized moment (skewness). |
↳min output.distributions.home_pass_yd.min | number | — | Minimum observed value across all draws. |
↳max output.distributions.home_pass_yd.max | number | — | Maximum observed value across all draws. |
↳p05 output.distributions.home_pass_yd.p05 | number | — | 5th percentile. |
↳p10 output.distributions.home_pass_yd.p10 | number | — | 10th percentile. |
↳p25 output.distributions.home_pass_yd.p25 | number | — | 25th percentile. |
↳p50 output.distributions.home_pass_yd.p50 | number | — | 50th percentile (median). |
↳p75 output.distributions.home_pass_yd.p75 | number | — | 75th percentile. |
↳p90 output.distributions.home_pass_yd.p90 | number | — | 90th percentile. |
↳p95 output.distributions.home_pass_yd.p95 | number | — | 95th percentile. |
↳vegas_line output.distributions.home_pass_yd.vegas_line | numbernullable | — | Reference Vegas prop or game line for vertical chart overlay (`null` when unpriced). |
↳p_over_vegas output.distributions.home_pass_yd.p_over_vegas | numbernullable | — | Simulated probability of exceeding `vegas_line` (`0.0..1.0`). |
↳bins output.distributions.home_pass_yd.bins | NFLHistogramBin[] | — | Histogram bins with empirical probability, CDF, Gaussian density, KDE density, and representative `sample_draw_idx`. |
↳x_min output.distributions.home_pass_yd.bins.x_min | number | — | Inclusive lower bound of the bin. |
↳x_max output.distributions.home_pass_yd.bins.x_max | number | — | Upper bound of the bin. |
↳x_mid output.distributions.home_pass_yd.bins.x_mid | number | — | Midpoint of the bin (`0.5 * (x_min + x_max)`). |
↳count output.distributions.home_pass_yd.bins.count | integer | — | Number of simulated draws falling into this bin. |
↳prob output.distributions.home_pass_yd.bins.prob | number | — | Empirical bin probability mass (`count / n_draws`). |
↳cum_prob output.distributions.home_pass_yd.bins.cum_prob | number | — | Cumulative distribution function `P(X <= x_max)` (`0.0..1.0`). |
↳gaussian_density output.distributions.home_pass_yd.bins.gaussian_density | number | — | Moment-matched Gaussian probability mass over this bin width for normal-curve comparison. |
↳kde_density output.distributions.home_pass_yd.bins.kde_density | number | — | Silverman-bandwidth Gaussian Kernel Density Estimate (KDE) probability mass over this bin width. |
↳sample_draw_idx output.distributions.home_pass_yd.bins.sample_draw_idx | integernullable | — | Representative `draw_idx` closest to `x_mid` inside this bin (pass in `include.pbp_draws` on `POST /api/v1/sim/nfl/run` to replay its play-by-play). |
↳away_pass_yd output.distributions.away_pass_yd | NFLSimBellCurve | — | Bell curve of away team gross passing yards. |
↳metric output.distributions.away_pass_yd.metric | string | — | Machine metric key (`total_points`, `home_points`, `pass_yd`, `rec_yd`, etc.). |
↳label output.distributions.away_pass_yd.label | string | — | Human-readable chart title. |
↳discrete output.distributions.away_pass_yd.discrete | boolean | — | True if the metric is integer-valued (`receptions`, `targets`, `carries`). |
↳n_draws output.distributions.away_pass_yd.n_draws | integer | — | Number of draws summarized in the distribution. |
↳mean output.distributions.away_pass_yd.mean | number | — | Empirical mean across all draws. |
↳sd output.distributions.away_pass_yd.sd | number | — | Empirical standard deviation. |
↳skew output.distributions.away_pass_yd.skew | number | — | Empirical third standardized moment (skewness). |
↳min output.distributions.away_pass_yd.min | number | — | Minimum observed value across all draws. |
↳max output.distributions.away_pass_yd.max | number | — | Maximum observed value across all draws. |
↳p05 output.distributions.away_pass_yd.p05 | number | — | 5th percentile. |
↳p10 output.distributions.away_pass_yd.p10 | number | — | 10th percentile. |
↳p25 output.distributions.away_pass_yd.p25 | number | — | 25th percentile. |
↳p50 output.distributions.away_pass_yd.p50 | number | — | 50th percentile (median). |
↳p75 output.distributions.away_pass_yd.p75 | number | — | 75th percentile. |
↳p90 output.distributions.away_pass_yd.p90 | number | — | 90th percentile. |
↳p95 output.distributions.away_pass_yd.p95 | number | — | 95th percentile. |
↳vegas_line output.distributions.away_pass_yd.vegas_line | numbernullable | — | Reference Vegas prop or game line for vertical chart overlay (`null` when unpriced). |
↳p_over_vegas output.distributions.away_pass_yd.p_over_vegas | numbernullable | — | Simulated probability of exceeding `vegas_line` (`0.0..1.0`). |
↳bins output.distributions.away_pass_yd.bins | NFLHistogramBin[] | — | Histogram bins with empirical probability, CDF, Gaussian density, KDE density, and representative `sample_draw_idx`. |
↳x_min output.distributions.away_pass_yd.bins.x_min | number | — | Inclusive lower bound of the bin. |
↳x_max output.distributions.away_pass_yd.bins.x_max | number | — | Upper bound of the bin. |
↳x_mid output.distributions.away_pass_yd.bins.x_mid | number | — | Midpoint of the bin (`0.5 * (x_min + x_max)`). |
↳count output.distributions.away_pass_yd.bins.count | integer | — | Number of simulated draws falling into this bin. |
↳prob output.distributions.away_pass_yd.bins.prob | number | — | Empirical bin probability mass (`count / n_draws`). |
↳cum_prob output.distributions.away_pass_yd.bins.cum_prob | number | — | Cumulative distribution function `P(X <= x_max)` (`0.0..1.0`). |
↳gaussian_density output.distributions.away_pass_yd.bins.gaussian_density | number | — | Moment-matched Gaussian probability mass over this bin width for normal-curve comparison. |
↳kde_density output.distributions.away_pass_yd.bins.kde_density | number | — | Silverman-bandwidth Gaussian Kernel Density Estimate (KDE) probability mass over this bin width. |
↳sample_draw_idx output.distributions.away_pass_yd.bins.sample_draw_idx | integernullable | — | Representative `draw_idx` closest to `x_mid` inside this bin (pass in `include.pbp_draws` on `POST /api/v1/sim/nfl/run` to replay its play-by-play). |
↳home_rush_yd output.distributions.home_rush_yd | NFLSimBellCurve | — | Bell curve of home team rushing yards. |
↳metric output.distributions.home_rush_yd.metric | string | — | Machine metric key (`total_points`, `home_points`, `pass_yd`, `rec_yd`, etc.). |
↳label output.distributions.home_rush_yd.label | string | — | Human-readable chart title. |
↳discrete output.distributions.home_rush_yd.discrete | boolean | — | True if the metric is integer-valued (`receptions`, `targets`, `carries`). |
↳n_draws output.distributions.home_rush_yd.n_draws | integer | — | Number of draws summarized in the distribution. |
↳mean output.distributions.home_rush_yd.mean | number | — | Empirical mean across all draws. |
↳sd output.distributions.home_rush_yd.sd | number | — | Empirical standard deviation. |
↳skew output.distributions.home_rush_yd.skew | number | — | Empirical third standardized moment (skewness). |
↳min output.distributions.home_rush_yd.min | number | — | Minimum observed value across all draws. |
↳max output.distributions.home_rush_yd.max | number | — | Maximum observed value across all draws. |
↳p05 output.distributions.home_rush_yd.p05 | number | — | 5th percentile. |
↳p10 output.distributions.home_rush_yd.p10 | number | — | 10th percentile. |
↳p25 output.distributions.home_rush_yd.p25 | number | — | 25th percentile. |
↳p50 output.distributions.home_rush_yd.p50 | number | — | 50th percentile (median). |
↳p75 output.distributions.home_rush_yd.p75 | number | — | 75th percentile. |
↳p90 output.distributions.home_rush_yd.p90 | number | — | 90th percentile. |
↳p95 output.distributions.home_rush_yd.p95 | number | — | 95th percentile. |
↳vegas_line output.distributions.home_rush_yd.vegas_line | numbernullable | — | Reference Vegas prop or game line for vertical chart overlay (`null` when unpriced). |
↳p_over_vegas output.distributions.home_rush_yd.p_over_vegas | numbernullable | — | Simulated probability of exceeding `vegas_line` (`0.0..1.0`). |
↳bins output.distributions.home_rush_yd.bins | NFLHistogramBin[] | — | Histogram bins with empirical probability, CDF, Gaussian density, KDE density, and representative `sample_draw_idx`. |
↳x_min output.distributions.home_rush_yd.bins.x_min | number | — | Inclusive lower bound of the bin. |
↳x_max output.distributions.home_rush_yd.bins.x_max | number | — | Upper bound of the bin. |
↳x_mid output.distributions.home_rush_yd.bins.x_mid | number | — | Midpoint of the bin (`0.5 * (x_min + x_max)`). |
↳count output.distributions.home_rush_yd.bins.count | integer | — | Number of simulated draws falling into this bin. |
↳prob output.distributions.home_rush_yd.bins.prob | number | — | Empirical bin probability mass (`count / n_draws`). |
↳cum_prob output.distributions.home_rush_yd.bins.cum_prob | number | — | Cumulative distribution function `P(X <= x_max)` (`0.0..1.0`). |
↳gaussian_density output.distributions.home_rush_yd.bins.gaussian_density | number | — | Moment-matched Gaussian probability mass over this bin width for normal-curve comparison. |
↳kde_density output.distributions.home_rush_yd.bins.kde_density | number | — | Silverman-bandwidth Gaussian Kernel Density Estimate (KDE) probability mass over this bin width. |
↳sample_draw_idx output.distributions.home_rush_yd.bins.sample_draw_idx | integernullable | — | Representative `draw_idx` closest to `x_mid` inside this bin (pass in `include.pbp_draws` on `POST /api/v1/sim/nfl/run` to replay its play-by-play). |
↳away_rush_yd output.distributions.away_rush_yd | NFLSimBellCurve | — | Bell curve of away team rushing yards. |
↳metric output.distributions.away_rush_yd.metric | string | — | Machine metric key (`total_points`, `home_points`, `pass_yd`, `rec_yd`, etc.). |
↳label output.distributions.away_rush_yd.label | string | — | Human-readable chart title. |
↳discrete output.distributions.away_rush_yd.discrete | boolean | — | True if the metric is integer-valued (`receptions`, `targets`, `carries`). |
↳n_draws output.distributions.away_rush_yd.n_draws | integer | — | Number of draws summarized in the distribution. |
↳mean output.distributions.away_rush_yd.mean | number | — | Empirical mean across all draws. |
↳sd output.distributions.away_rush_yd.sd | number | — | Empirical standard deviation. |
↳skew output.distributions.away_rush_yd.skew | number | — | Empirical third standardized moment (skewness). |
↳min output.distributions.away_rush_yd.min | number | — | Minimum observed value across all draws. |
↳max output.distributions.away_rush_yd.max | number | — | Maximum observed value across all draws. |
↳p05 output.distributions.away_rush_yd.p05 | number | — | 5th percentile. |
↳p10 output.distributions.away_rush_yd.p10 | number | — | 10th percentile. |
↳p25 output.distributions.away_rush_yd.p25 | number | — | 25th percentile. |
↳p50 output.distributions.away_rush_yd.p50 | number | — | 50th percentile (median). |
↳p75 output.distributions.away_rush_yd.p75 | number | — | 75th percentile. |
↳p90 output.distributions.away_rush_yd.p90 | number | — | 90th percentile. |
↳p95 output.distributions.away_rush_yd.p95 | number | — | 95th percentile. |
↳vegas_line output.distributions.away_rush_yd.vegas_line | numbernullable | — | Reference Vegas prop or game line for vertical chart overlay (`null` when unpriced). |
↳p_over_vegas output.distributions.away_rush_yd.p_over_vegas | numbernullable | — | Simulated probability of exceeding `vegas_line` (`0.0..1.0`). |
↳bins output.distributions.away_rush_yd.bins | NFLHistogramBin[] | — | Histogram bins with empirical probability, CDF, Gaussian density, KDE density, and representative `sample_draw_idx`. |
↳x_min output.distributions.away_rush_yd.bins.x_min | number | — | Inclusive lower bound of the bin. |
↳x_max output.distributions.away_rush_yd.bins.x_max | number | — | Upper bound of the bin. |
↳x_mid output.distributions.away_rush_yd.bins.x_mid | number | — | Midpoint of the bin (`0.5 * (x_min + x_max)`). |
↳count output.distributions.away_rush_yd.bins.count | integer | — | Number of simulated draws falling into this bin. |
↳prob output.distributions.away_rush_yd.bins.prob | number | — | Empirical bin probability mass (`count / n_draws`). |
↳cum_prob output.distributions.away_rush_yd.bins.cum_prob | number | — | Cumulative distribution function `P(X <= x_max)` (`0.0..1.0`). |
↳gaussian_density output.distributions.away_rush_yd.bins.gaussian_density | number | — | Moment-matched Gaussian probability mass over this bin width for normal-curve comparison. |
↳kde_density output.distributions.away_rush_yd.bins.kde_density | number | — | Silverman-bandwidth Gaussian Kernel Density Estimate (KDE) probability mass over this bin width. |
↳sample_draw_idx output.distributions.away_rush_yd.bins.sample_draw_idx | integernullable | — | Representative `draw_idx` closest to `x_mid` inside this bin (pass in `include.pbp_draws` on `POST /api/v1/sim/nfl/run` to replay its play-by-play). |
↳players output.distributions.players | NFLPlayerBellCurves[] | — | Per-player bell curves across fantasy points and core stat categories. |
↳player_id output.distributions.players.player_id | integer | — | Canonical player ID. |
↳team_id output.distributions.players.team_id | integer | — | Canonical team ID. |
↳position output.distributions.players.position | string | — | Skill position (`QB`, `RB`, `WR`, `TE`, `K`, `DST`). |
↳depth_role output.distributions.players.depth_role | string | — | Depth chart role (`QB1`, `RB1`, `WR1`, `TE1`, etc.). |
↳pass_yd output.distributions.players.pass_yd | NFLSimBellCurvenullable | — | Passing yards bell curve (populated for QBs). |
↳metric output.distributions.players.pass_yd.metric | string | — | Machine metric key (`total_points`, `home_points`, `pass_yd`, `rec_yd`, etc.). |
↳label output.distributions.players.pass_yd.label | string | — | Human-readable chart title. |
↳discrete output.distributions.players.pass_yd.discrete | boolean | — | True if the metric is integer-valued (`receptions`, `targets`, `carries`). |
↳n_draws output.distributions.players.pass_yd.n_draws | integer | — | Number of draws summarized in the distribution. |
↳mean output.distributions.players.pass_yd.mean | number | — | Empirical mean across all draws. |
↳sd output.distributions.players.pass_yd.sd | number | — | Empirical standard deviation. |
↳skew output.distributions.players.pass_yd.skew | number | — | Empirical third standardized moment (skewness). |
↳min output.distributions.players.pass_yd.min | number | — | Minimum observed value across all draws. |
↳max output.distributions.players.pass_yd.max | number | — | Maximum observed value across all draws. |
↳p05 output.distributions.players.pass_yd.p05 | number | — | 5th percentile. |
↳p10 output.distributions.players.pass_yd.p10 | number | — | 10th percentile. |
↳p25 output.distributions.players.pass_yd.p25 | number | — | 25th percentile. |
↳p50 output.distributions.players.pass_yd.p50 | number | — | 50th percentile (median). |
↳p75 output.distributions.players.pass_yd.p75 | number | — | 75th percentile. |
↳p90 output.distributions.players.pass_yd.p90 | number | — | 90th percentile. |
↳p95 output.distributions.players.pass_yd.p95 | number | — | 95th percentile. |
↳vegas_line output.distributions.players.pass_yd.vegas_line | numbernullable | — | Reference Vegas prop or game line for vertical chart overlay (`null` when unpriced). |
↳p_over_vegas output.distributions.players.pass_yd.p_over_vegas | numbernullable | — | Simulated probability of exceeding `vegas_line` (`0.0..1.0`). |
↳bins output.distributions.players.pass_yd.bins | NFLHistogramBin[] | — | Histogram bins with empirical probability, CDF, Gaussian density, KDE density, and representative `sample_draw_idx`. |
↳x_min output.distributions.players.pass_yd.bins.x_min | number | — | Inclusive lower bound of the bin. |
↳x_max output.distributions.players.pass_yd.bins.x_max | number | — | Upper bound of the bin. |
↳x_mid output.distributions.players.pass_yd.bins.x_mid | number | — | Midpoint of the bin (`0.5 * (x_min + x_max)`). |
↳count output.distributions.players.pass_yd.bins.count | integer | — | Number of simulated draws falling into this bin. |
↳prob output.distributions.players.pass_yd.bins.prob | number | — | Empirical bin probability mass (`count / n_draws`). |
↳cum_prob output.distributions.players.pass_yd.bins.cum_prob | number | — | Cumulative distribution function `P(X <= x_max)` (`0.0..1.0`). |
↳gaussian_density output.distributions.players.pass_yd.bins.gaussian_density | number | — | Moment-matched Gaussian probability mass over this bin width for normal-curve comparison. |
↳kde_density output.distributions.players.pass_yd.bins.kde_density | number | — | Silverman-bandwidth Gaussian Kernel Density Estimate (KDE) probability mass over this bin width. |
↳sample_draw_idx output.distributions.players.pass_yd.bins.sample_draw_idx | integernullable | — | Representative `draw_idx` closest to `x_mid` inside this bin (pass in `include.pbp_draws` on `POST /api/v1/sim/nfl/run` to replay its play-by-play). |
↳rush_yd output.distributions.players.rush_yd | NFLSimBellCurvenullable | — | Rushing yards bell curve (populated for QBs, RBs, WRs). |
↳metric output.distributions.players.rush_yd.metric | string | — | Machine metric key (`total_points`, `home_points`, `pass_yd`, `rec_yd`, etc.). |
↳label output.distributions.players.rush_yd.label | string | — | Human-readable chart title. |
↳discrete output.distributions.players.rush_yd.discrete | boolean | — | True if the metric is integer-valued (`receptions`, `targets`, `carries`). |
↳n_draws output.distributions.players.rush_yd.n_draws | integer | — | Number of draws summarized in the distribution. |
↳mean output.distributions.players.rush_yd.mean | number | — | Empirical mean across all draws. |
↳sd output.distributions.players.rush_yd.sd | number | — | Empirical standard deviation. |
↳skew output.distributions.players.rush_yd.skew | number | — | Empirical third standardized moment (skewness). |
↳min output.distributions.players.rush_yd.min | number | — | Minimum observed value across all draws. |
↳max output.distributions.players.rush_yd.max | number | — | Maximum observed value across all draws. |
↳p05 output.distributions.players.rush_yd.p05 | number | — | 5th percentile. |
↳p10 output.distributions.players.rush_yd.p10 | number | — | 10th percentile. |
↳p25 output.distributions.players.rush_yd.p25 | number | — | 25th percentile. |
↳p50 output.distributions.players.rush_yd.p50 | number | — | 50th percentile (median). |
↳p75 output.distributions.players.rush_yd.p75 | number | — | 75th percentile. |
↳p90 output.distributions.players.rush_yd.p90 | number | — | 90th percentile. |
↳p95 output.distributions.players.rush_yd.p95 | number | — | 95th percentile. |
↳vegas_line output.distributions.players.rush_yd.vegas_line | numbernullable | — | Reference Vegas prop or game line for vertical chart overlay (`null` when unpriced). |
↳p_over_vegas output.distributions.players.rush_yd.p_over_vegas | numbernullable | — | Simulated probability of exceeding `vegas_line` (`0.0..1.0`). |
↳bins output.distributions.players.rush_yd.bins | NFLHistogramBin[] | — | Histogram bins with empirical probability, CDF, Gaussian density, KDE density, and representative `sample_draw_idx`. |
↳x_min output.distributions.players.rush_yd.bins.x_min | number | — | Inclusive lower bound of the bin. |
↳x_max output.distributions.players.rush_yd.bins.x_max | number | — | Upper bound of the bin. |
↳x_mid output.distributions.players.rush_yd.bins.x_mid | number | — | Midpoint of the bin (`0.5 * (x_min + x_max)`). |
↳count output.distributions.players.rush_yd.bins.count | integer | — | Number of simulated draws falling into this bin. |
↳prob output.distributions.players.rush_yd.bins.prob | number | — | Empirical bin probability mass (`count / n_draws`). |
↳cum_prob output.distributions.players.rush_yd.bins.cum_prob | number | — | Cumulative distribution function `P(X <= x_max)` (`0.0..1.0`). |
↳gaussian_density output.distributions.players.rush_yd.bins.gaussian_density | number | — | Moment-matched Gaussian probability mass over this bin width for normal-curve comparison. |
↳kde_density output.distributions.players.rush_yd.bins.kde_density | number | — | Silverman-bandwidth Gaussian Kernel Density Estimate (KDE) probability mass over this bin width. |
↳sample_draw_idx output.distributions.players.rush_yd.bins.sample_draw_idx | integernullable | — | Representative `draw_idx` closest to `x_mid` inside this bin (pass in `include.pbp_draws` on `POST /api/v1/sim/nfl/run` to replay its play-by-play). |
↳rec_yd output.distributions.players.rec_yd | NFLSimBellCurvenullable | — | Receiving yards bell curve (populated for RBs, WRs, TEs). |
↳metric output.distributions.players.rec_yd.metric | string | — | Machine metric key (`total_points`, `home_points`, `pass_yd`, `rec_yd`, etc.). |
↳label output.distributions.players.rec_yd.label | string | — | Human-readable chart title. |
↳discrete output.distributions.players.rec_yd.discrete | boolean | — | True if the metric is integer-valued (`receptions`, `targets`, `carries`). |
↳n_draws output.distributions.players.rec_yd.n_draws | integer | — | Number of draws summarized in the distribution. |
↳mean output.distributions.players.rec_yd.mean | number | — | Empirical mean across all draws. |
↳sd output.distributions.players.rec_yd.sd | number | — | Empirical standard deviation. |
↳skew output.distributions.players.rec_yd.skew | number | — | Empirical third standardized moment (skewness). |
↳min output.distributions.players.rec_yd.min | number | — | Minimum observed value across all draws. |
↳max output.distributions.players.rec_yd.max | number | — | Maximum observed value across all draws. |
↳p05 output.distributions.players.rec_yd.p05 | number | — | 5th percentile. |
↳p10 output.distributions.players.rec_yd.p10 | number | — | 10th percentile. |
↳p25 output.distributions.players.rec_yd.p25 | number | — | 25th percentile. |
↳p50 output.distributions.players.rec_yd.p50 | number | — | 50th percentile (median). |
↳p75 output.distributions.players.rec_yd.p75 | number | — | 75th percentile. |
↳p90 output.distributions.players.rec_yd.p90 | number | — | 90th percentile. |
↳p95 output.distributions.players.rec_yd.p95 | number | — | 95th percentile. |
↳vegas_line output.distributions.players.rec_yd.vegas_line | numbernullable | — | Reference Vegas prop or game line for vertical chart overlay (`null` when unpriced). |
↳p_over_vegas output.distributions.players.rec_yd.p_over_vegas | numbernullable | — | Simulated probability of exceeding `vegas_line` (`0.0..1.0`). |
↳bins output.distributions.players.rec_yd.bins | NFLHistogramBin[] | — | Histogram bins with empirical probability, CDF, Gaussian density, KDE density, and representative `sample_draw_idx`. |
↳x_min output.distributions.players.rec_yd.bins.x_min | number | — | Inclusive lower bound of the bin. |
↳x_max output.distributions.players.rec_yd.bins.x_max | number | — | Upper bound of the bin. |
↳x_mid output.distributions.players.rec_yd.bins.x_mid | number | — | Midpoint of the bin (`0.5 * (x_min + x_max)`). |
↳count output.distributions.players.rec_yd.bins.count | integer | — | Number of simulated draws falling into this bin. |
↳prob output.distributions.players.rec_yd.bins.prob | number | — | Empirical bin probability mass (`count / n_draws`). |
↳cum_prob output.distributions.players.rec_yd.bins.cum_prob | number | — | Cumulative distribution function `P(X <= x_max)` (`0.0..1.0`). |
↳gaussian_density output.distributions.players.rec_yd.bins.gaussian_density | number | — | Moment-matched Gaussian probability mass over this bin width for normal-curve comparison. |
↳kde_density output.distributions.players.rec_yd.bins.kde_density | number | — | Silverman-bandwidth Gaussian Kernel Density Estimate (KDE) probability mass over this bin width. |
↳sample_draw_idx output.distributions.players.rec_yd.bins.sample_draw_idx | integernullable | — | Representative `draw_idx` closest to `x_mid` inside this bin (pass in `include.pbp_draws` on `POST /api/v1/sim/nfl/run` to replay its play-by-play). |
↳receptions output.distributions.players.receptions | NFLSimBellCurvenullable | — | Discrete integer receptions bell curve. |
↳metric output.distributions.players.receptions.metric | string | — | Machine metric key (`total_points`, `home_points`, `pass_yd`, `rec_yd`, etc.). |
↳label output.distributions.players.receptions.label | string | — | Human-readable chart title. |
↳discrete output.distributions.players.receptions.discrete | boolean | — | True if the metric is integer-valued (`receptions`, `targets`, `carries`). |
↳n_draws output.distributions.players.receptions.n_draws | integer | — | Number of draws summarized in the distribution. |
↳mean output.distributions.players.receptions.mean | number | — | Empirical mean across all draws. |
↳sd output.distributions.players.receptions.sd | number | — | Empirical standard deviation. |
↳skew output.distributions.players.receptions.skew | number | — | Empirical third standardized moment (skewness). |
↳min output.distributions.players.receptions.min | number | — | Minimum observed value across all draws. |
↳max output.distributions.players.receptions.max | number | — | Maximum observed value across all draws. |
↳p05 output.distributions.players.receptions.p05 | number | — | 5th percentile. |
↳p10 output.distributions.players.receptions.p10 | number | — | 10th percentile. |
↳p25 output.distributions.players.receptions.p25 | number | — | 25th percentile. |
↳p50 output.distributions.players.receptions.p50 | number | — | 50th percentile (median). |
↳p75 output.distributions.players.receptions.p75 | number | — | 75th percentile. |
↳p90 output.distributions.players.receptions.p90 | number | — | 90th percentile. |
↳p95 output.distributions.players.receptions.p95 | number | — | 95th percentile. |
↳vegas_line output.distributions.players.receptions.vegas_line | numbernullable | — | Reference Vegas prop or game line for vertical chart overlay (`null` when unpriced). |
↳p_over_vegas output.distributions.players.receptions.p_over_vegas | numbernullable | — | Simulated probability of exceeding `vegas_line` (`0.0..1.0`). |
↳bins output.distributions.players.receptions.bins | NFLHistogramBin[] | — | Histogram bins with empirical probability, CDF, Gaussian density, KDE density, and representative `sample_draw_idx`. |
↳x_min output.distributions.players.receptions.bins.x_min | number | — | Inclusive lower bound of the bin. |
↳x_max output.distributions.players.receptions.bins.x_max | number | — | Upper bound of the bin. |
↳x_mid output.distributions.players.receptions.bins.x_mid | number | — | Midpoint of the bin (`0.5 * (x_min + x_max)`). |
↳count output.distributions.players.receptions.bins.count | integer | — | Number of simulated draws falling into this bin. |
↳prob output.distributions.players.receptions.bins.prob | number | — | Empirical bin probability mass (`count / n_draws`). |
↳cum_prob output.distributions.players.receptions.bins.cum_prob | number | — | Cumulative distribution function `P(X <= x_max)` (`0.0..1.0`). |
↳gaussian_density output.distributions.players.receptions.bins.gaussian_density | number | — | Moment-matched Gaussian probability mass over this bin width for normal-curve comparison. |
↳kde_density output.distributions.players.receptions.bins.kde_density | number | — | Silverman-bandwidth Gaussian Kernel Density Estimate (KDE) probability mass over this bin width. |
↳sample_draw_idx output.distributions.players.receptions.bins.sample_draw_idx | integernullable | — | Representative `draw_idx` closest to `x_mid` inside this bin (pass in `include.pbp_draws` on `POST /api/v1/sim/nfl/run` to replay its play-by-play). |
↳targets output.distributions.players.targets | NFLSimBellCurvenullable | — | Discrete integer targets bell curve. |
↳metric output.distributions.players.targets.metric | string | — | Machine metric key (`total_points`, `home_points`, `pass_yd`, `rec_yd`, etc.). |
↳label output.distributions.players.targets.label | string | — | Human-readable chart title. |
↳discrete output.distributions.players.targets.discrete | boolean | — | True if the metric is integer-valued (`receptions`, `targets`, `carries`). |
↳n_draws output.distributions.players.targets.n_draws | integer | — | Number of draws summarized in the distribution. |
↳mean output.distributions.players.targets.mean | number | — | Empirical mean across all draws. |
↳sd output.distributions.players.targets.sd | number | — | Empirical standard deviation. |
↳skew output.distributions.players.targets.skew | number | — | Empirical third standardized moment (skewness). |
↳min output.distributions.players.targets.min | number | — | Minimum observed value across all draws. |
↳max output.distributions.players.targets.max | number | — | Maximum observed value across all draws. |
↳p05 output.distributions.players.targets.p05 | number | — | 5th percentile. |
↳p10 output.distributions.players.targets.p10 | number | — | 10th percentile. |
↳p25 output.distributions.players.targets.p25 | number | — | 25th percentile. |
↳p50 output.distributions.players.targets.p50 | number | — | 50th percentile (median). |
↳p75 output.distributions.players.targets.p75 | number | — | 75th percentile. |
↳p90 output.distributions.players.targets.p90 | number | — | 90th percentile. |
↳p95 output.distributions.players.targets.p95 | number | — | 95th percentile. |
↳vegas_line output.distributions.players.targets.vegas_line | numbernullable | — | Reference Vegas prop or game line for vertical chart overlay (`null` when unpriced). |
↳p_over_vegas output.distributions.players.targets.p_over_vegas | numbernullable | — | Simulated probability of exceeding `vegas_line` (`0.0..1.0`). |
↳bins output.distributions.players.targets.bins | NFLHistogramBin[] | — | Histogram bins with empirical probability, CDF, Gaussian density, KDE density, and representative `sample_draw_idx`. |
↳x_min output.distributions.players.targets.bins.x_min | number | — | Inclusive lower bound of the bin. |
↳x_max output.distributions.players.targets.bins.x_max | number | — | Upper bound of the bin. |
↳x_mid output.distributions.players.targets.bins.x_mid | number | — | Midpoint of the bin (`0.5 * (x_min + x_max)`). |
↳count output.distributions.players.targets.bins.count | integer | — | Number of simulated draws falling into this bin. |
↳prob output.distributions.players.targets.bins.prob | number | — | Empirical bin probability mass (`count / n_draws`). |
↳cum_prob output.distributions.players.targets.bins.cum_prob | number | — | Cumulative distribution function `P(X <= x_max)` (`0.0..1.0`). |
↳gaussian_density output.distributions.players.targets.bins.gaussian_density | number | — | Moment-matched Gaussian probability mass over this bin width for normal-curve comparison. |
↳kde_density output.distributions.players.targets.bins.kde_density | number | — | Silverman-bandwidth Gaussian Kernel Density Estimate (KDE) probability mass over this bin width. |
↳sample_draw_idx output.distributions.players.targets.bins.sample_draw_idx | integernullable | — | Representative `draw_idx` closest to `x_mid` inside this bin (pass in `include.pbp_draws` on `POST /api/v1/sim/nfl/run` to replay its play-by-play). |
↳carries output.distributions.players.carries | NFLSimBellCurvenullable | — | Discrete integer rushing attempts bell curve. |
↳metric output.distributions.players.carries.metric | string | — | Machine metric key (`total_points`, `home_points`, `pass_yd`, `rec_yd`, etc.). |
↳label output.distributions.players.carries.label | string | — | Human-readable chart title. |
↳discrete output.distributions.players.carries.discrete | boolean | — | True if the metric is integer-valued (`receptions`, `targets`, `carries`). |
↳n_draws output.distributions.players.carries.n_draws | integer | — | Number of draws summarized in the distribution. |
↳mean output.distributions.players.carries.mean | number | — | Empirical mean across all draws. |
↳sd output.distributions.players.carries.sd | number | — | Empirical standard deviation. |
↳skew output.distributions.players.carries.skew | number | — | Empirical third standardized moment (skewness). |
↳min output.distributions.players.carries.min | number | — | Minimum observed value across all draws. |
↳max output.distributions.players.carries.max | number | — | Maximum observed value across all draws. |
↳p05 output.distributions.players.carries.p05 | number | — | 5th percentile. |
↳p10 output.distributions.players.carries.p10 | number | — | 10th percentile. |
↳p25 output.distributions.players.carries.p25 | number | — | 25th percentile. |
↳p50 output.distributions.players.carries.p50 | number | — | 50th percentile (median). |
↳p75 output.distributions.players.carries.p75 | number | — | 75th percentile. |
↳p90 output.distributions.players.carries.p90 | number | — | 90th percentile. |
↳p95 output.distributions.players.carries.p95 | number | — | 95th percentile. |
↳vegas_line output.distributions.players.carries.vegas_line | numbernullable | — | Reference Vegas prop or game line for vertical chart overlay (`null` when unpriced). |
↳p_over_vegas output.distributions.players.carries.p_over_vegas | numbernullable | — | Simulated probability of exceeding `vegas_line` (`0.0..1.0`). |
↳bins output.distributions.players.carries.bins | NFLHistogramBin[] | — | Histogram bins with empirical probability, CDF, Gaussian density, KDE density, and representative `sample_draw_idx`. |
↳x_min output.distributions.players.carries.bins.x_min | number | — | Inclusive lower bound of the bin. |
↳x_max output.distributions.players.carries.bins.x_max | number | — | Upper bound of the bin. |
↳x_mid output.distributions.players.carries.bins.x_mid | number | — | Midpoint of the bin (`0.5 * (x_min + x_max)`). |
↳count output.distributions.players.carries.bins.count | integer | — | Number of simulated draws falling into this bin. |
↳prob output.distributions.players.carries.bins.prob | number | — | Empirical bin probability mass (`count / n_draws`). |
↳cum_prob output.distributions.players.carries.bins.cum_prob | number | — | Cumulative distribution function `P(X <= x_max)` (`0.0..1.0`). |
↳gaussian_density output.distributions.players.carries.bins.gaussian_density | number | — | Moment-matched Gaussian probability mass over this bin width for normal-curve comparison. |
↳kde_density output.distributions.players.carries.bins.kde_density | number | — | Silverman-bandwidth Gaussian Kernel Density Estimate (KDE) probability mass over this bin width. |
↳sample_draw_idx output.distributions.players.carries.bins.sample_draw_idx | integernullable | — | Representative `draw_idx` closest to `x_mid` inside this bin (pass in `include.pbp_draws` on `POST /api/v1/sim/nfl/run` to replay its play-by-play). |
↳scorebox output.scorebox | NFLSimScoreboxSectionnullable | — | Populated when `include.scorebox = true`. |
↳archetypes output.scorebox.archetypes | NFLSimGameScoreboxDraw[] | — | 6 representative game draws: `median`, `shootout`, `defensive_slugfest`, `home_blowout`, `away_blowout`, and `overtime_thriller`. |
↳draw_idx output.scorebox.archetypes.draw_idx | integer | — | 0-based Monte Carlo draw index (`0 <= draw_idx < n_draws`). |
↳archetype output.scorebox.archetypes.archetype | stringnullable | — | Archetype slug (`median`, `shootout`, `defensive_slugfest`, `home_blowout`, `away_blowout`, `overtime_thriller`, or `null`). |
↳label output.scorebox.archetypes.label | string | — | Human-readable draw or archetype title. |
↳away_linescore output.scorebox.archetypes.away_linescore | integer[6] | — | Away team quarter linescore array `[Q1, Q2, Q3, Q4, OT, Total]`. |
↳home_linescore output.scorebox.archetypes.home_linescore | integer[6] | — | Home team quarter linescore array `[Q1, Q2, Q3, Q4, OT, Total]`. |
↳total_points output.scorebox.archetypes.total_points | integer | — | Combined final points (`home_team.points + away_team.points`). |
↳final_margin_home output.scorebox.archetypes.final_margin_home | integer | — | Final score margin from the home perspective (`home_team.points - away_team.points`). |
↳q4_margin_home output.scorebox.archetypes.q4_margin_home | integer | — | Score margin at the end of regulation (`0` whenever `overtime_played = true`). |
↳overtime_played output.scorebox.archetypes.overtime_played | boolean | — | True if regulation ended in a tie and overtime was played. |
↳away_team output.scorebox.archetypes.away_team | NFLTeamGameBoxScore | — | Away team full offensive, drive, situational, and DST box score. |
↳points output.scorebox.archetypes.away_team.points | integer | — | Final points scored by the team on this draw. |
↳q1_points output.scorebox.archetypes.away_team.q1_points | integer | — | 1st-quarter points. |
↳q2_points output.scorebox.archetypes.away_team.q2_points | integer | — | 2nd-quarter points. |
↳q3_points output.scorebox.archetypes.away_team.q3_points | integer | — | 3rd-quarter points. |
↳q4_points output.scorebox.archetypes.away_team.q4_points | integer | — | 4th-quarter points. |
↳ot_points output.scorebox.archetypes.away_team.ot_points | integer | — | Overtime points. |
↳plays output.scorebox.archetypes.away_team.plays | integer | — | Total offensive plays (`pass_att + rush_att + sacks_taken`). |
↳pass_att output.scorebox.archetypes.away_team.pass_att | integer | — | Team pass attempts. |
↳pass_cmp output.scorebox.archetypes.away_team.pass_cmp | integer | — | Team pass completions. |
↳pass_yd output.scorebox.archetypes.away_team.pass_yd | integer | — | Team gross passing yards. |
↳pass_td output.scorebox.archetypes.away_team.pass_td | integer | — | Team passing touchdowns. |
↳interceptions_thrown output.scorebox.archetypes.away_team.interceptions_thrown | integer | — | Interceptions thrown. |
↳sacks_taken output.scorebox.archetypes.away_team.sacks_taken | integer | — | Times the quarterback was sacked. |
↳sack_yd_lost output.scorebox.archetypes.away_team.sack_yd_lost | integer | — | Yards lost on sacks. |
↳rush_att output.scorebox.archetypes.away_team.rush_att | integer | — | Team rushing attempts. |
↳rush_yd output.scorebox.archetypes.away_team.rush_yd | integer | — | Team rushing yards. |
↳rush_td output.scorebox.archetypes.away_team.rush_td | integer | — | Team rushing touchdowns. |
↳first_downs output.scorebox.archetypes.away_team.first_downs | integer | — | Total offensive first downs earned. |
↳third_down_att output.scorebox.archetypes.away_team.third_down_att | integer | — | 3rd-down attempts. |
↳third_down_conv output.scorebox.archetypes.away_team.third_down_conv | integer | — | 3rd-down conversions. |
↳fourth_down_att output.scorebox.archetypes.away_team.fourth_down_att | integer | — | 4th-down go-for-it attempts. |
↳fourth_down_conv output.scorebox.archetypes.away_team.fourth_down_conv | integer | — | 4th-down conversions. |
↳drives output.scorebox.archetypes.away_team.drives | integer | — | Total offensive drives. |
↳drive_tds output.scorebox.archetypes.away_team.drive_tds | integer | — | Drives ending in an offensive touchdown. |
↳drive_fgs output.scorebox.archetypes.away_team.drive_fgs | integer | — | Drives ending in a made field goal. |
↳drive_missed_fgs output.scorebox.archetypes.away_team.drive_missed_fgs | integer | — | Drives ending in a missed field goal. |
↳drive_punts output.scorebox.archetypes.away_team.drive_punts | integer | — | Drives ending in a punt. |
↳drive_turnovers output.scorebox.archetypes.away_team.drive_turnovers | integer | — | Drives ending in an interception or fumble lost. |
↳drive_downs output.scorebox.archetypes.away_team.drive_downs | integer | — | Drives ending in a turnover on downs. |
↳drive_end_half output.scorebox.archetypes.away_team.drive_end_half | integer | — | Drives ending by clock expiration at halftime or game end. |
↳fg_att output.scorebox.archetypes.away_team.fg_att | integer | — | Field goals attempted. |
↳fg_made output.scorebox.archetypes.away_team.fg_made | integer | — | Field goals made. |
↳xp_att output.scorebox.archetypes.away_team.xp_att | integer | — | Extra points (PATs) attempted. |
↳xp_made output.scorebox.archetypes.away_team.xp_made | integer | — | Extra points (PATs) made. |
↳two_pt_att output.scorebox.archetypes.away_team.two_pt_att | integer | — | Two-point conversions attempted. |
↳two_pt_made output.scorebox.archetypes.away_team.two_pt_made | integer | — | Two-point conversions succeeded. |
↳penalties output.scorebox.archetypes.away_team.penalties | integer | — | Penalties committed. |
↳penalty_yds output.scorebox.archetypes.away_team.penalty_yds | integer | — | Penalty yards assessed. |
↳time_of_possession_sec output.scorebox.archetypes.away_team.time_of_possession_sec | integer | — | Offensive time of possession in seconds. |
↳throwaways output.scorebox.archetypes.away_team.throwaways | integer | — | Passes thrown away on purpose. |
↳spikes output.scorebox.archetypes.away_team.spikes | integer | — | Spikes to stop the clock. |
↳batted_passes output.scorebox.archetypes.away_team.batted_passes | integer | — | Passes batted down at the line of scrimmage. |
↳oob_untackled_plays output.scorebox.archetypes.away_team.oob_untackled_plays | integer | — | Plays that end out of bounds with no tackler (for example a quarterback who runs out of bounds behind the line, or a return that ends out of bounds). |
↳special_teams_returns output.scorebox.archetypes.away_team.special_teams_returns | integer | — | Kickoffs and punts that the team returned. |
↳kickoffs_total output.scorebox.archetypes.away_team.kickoffs_total | integer | — | Kickoffs that the team received. |
↳kickoff_returns output.scorebox.archetypes.away_team.kickoff_returns | integer | — | Received kickoffs that the team returned (the rest were touchbacks). |
↳kickoff_start_yardline_sum output.scorebox.archetypes.away_team.kickoff_start_yardline_sum | integer | — | Sum of the team's own yard lines at the start of the drives after received kickoffs. Divide by `kickoffs_total` for the mean. |
↳trailing_10plus_dropbacks output.scorebox.archetypes.away_team.trailing_10plus_dropbacks | integer | — | Dropbacks while the team trailed by 10 or more points. |
↳trailing_10plus_plays output.scorebox.archetypes.away_team.trailing_10plus_plays | integer | — | Offensive plays while the team trailed by 10 or more points. |
↳neutral_dropbacks output.scorebox.archetypes.away_team.neutral_dropbacks | integer | — | Dropbacks in the first three quarters while the score was within 6 points. |
↳neutral_plays output.scorebox.archetypes.away_team.neutral_plays | integer | — | Offensive plays in the first three quarters while the score was within 6 points. |
↳p11_snaps output.scorebox.archetypes.away_team.p11_snaps | integer | — | Offensive snaps aligned in 11 personnel (1 RB, 1 TE, 3 WR). |
↳p12_snaps output.scorebox.archetypes.away_team.p12_snaps | integer | — | Offensive snaps aligned in 12 personnel (1 RB, 2 TE, 2 WR). |
↳p21_snaps output.scorebox.archetypes.away_team.p21_snaps | integer | — | Offensive snaps aligned in 21 personnel (2 RB, 1 TE, 2 WR). |
↳no_huddle_snaps output.scorebox.archetypes.away_team.no_huddle_snaps | integer | — | Offensive snaps executed in no-huddle tempo. |
↳unassisted_team_sacks output.scorebox.archetypes.away_team.unassisted_team_sacks | integer | — | Sacks credited to the team defense with no named player (the quarterback ran out of bounds behind the line). |
↳dst_pressures output.scorebox.archetypes.away_team.dst_pressures | integer | — | Quarterback pressures by the defense. |
↳pick_sixes_scored output.scorebox.archetypes.away_team.pick_sixes_scored | integer | — | Interceptions that the defense returned for a touchdown. |
↳fumble_ret_tds_scored output.scorebox.archetypes.away_team.fumble_ret_tds_scored | integer | — | Fumbles that the defense or special teams returned for a touchdown. |
↳dst_sacks output.scorebox.archetypes.away_team.dst_sacks | integer | — | Defensive sacks recorded. |
↳dst_interceptions output.scorebox.archetypes.away_team.dst_interceptions | integer | — | Defensive interceptions recorded. |
↳dst_fumbles_recovered output.scorebox.archetypes.away_team.dst_fumbles_recovered | integer | — | Opponent fumbles recovered by the defense. |
↳dst_defensive_tds output.scorebox.archetypes.away_team.dst_defensive_tds | integer | — | Defensive or special-teams touchdowns scored. |
↳dst_safeties output.scorebox.archetypes.away_team.dst_safeties | integer | — | Safeties recorded by the defense. |
↳dst_points_allowed output.scorebox.archetypes.away_team.dst_points_allowed | integer | — | Points allowed by the defense. |
↳home_team output.scorebox.archetypes.home_team | NFLTeamGameBoxScore | — | Home team full offensive, drive, situational, and DST box score. |
↳points output.scorebox.archetypes.home_team.points | integer | — | Final points scored by the team on this draw. |
↳q1_points output.scorebox.archetypes.home_team.q1_points | integer | — | 1st-quarter points. |
↳q2_points output.scorebox.archetypes.home_team.q2_points | integer | — | 2nd-quarter points. |
↳q3_points output.scorebox.archetypes.home_team.q3_points | integer | — | 3rd-quarter points. |
↳q4_points output.scorebox.archetypes.home_team.q4_points | integer | — | 4th-quarter points. |
↳ot_points output.scorebox.archetypes.home_team.ot_points | integer | — | Overtime points. |
↳plays output.scorebox.archetypes.home_team.plays | integer | — | Total offensive plays (`pass_att + rush_att + sacks_taken`). |
↳pass_att output.scorebox.archetypes.home_team.pass_att | integer | — | Team pass attempts. |
↳pass_cmp output.scorebox.archetypes.home_team.pass_cmp | integer | — | Team pass completions. |
↳pass_yd output.scorebox.archetypes.home_team.pass_yd | integer | — | Team gross passing yards. |
↳pass_td output.scorebox.archetypes.home_team.pass_td | integer | — | Team passing touchdowns. |
↳interceptions_thrown output.scorebox.archetypes.home_team.interceptions_thrown | integer | — | Interceptions thrown. |
↳sacks_taken output.scorebox.archetypes.home_team.sacks_taken | integer | — | Times the quarterback was sacked. |
↳sack_yd_lost output.scorebox.archetypes.home_team.sack_yd_lost | integer | — | Yards lost on sacks. |
↳rush_att output.scorebox.archetypes.home_team.rush_att | integer | — | Team rushing attempts. |
↳rush_yd output.scorebox.archetypes.home_team.rush_yd | integer | — | Team rushing yards. |
↳rush_td output.scorebox.archetypes.home_team.rush_td | integer | — | Team rushing touchdowns. |
↳first_downs output.scorebox.archetypes.home_team.first_downs | integer | — | Total offensive first downs earned. |
↳third_down_att output.scorebox.archetypes.home_team.third_down_att | integer | — | 3rd-down attempts. |
↳third_down_conv output.scorebox.archetypes.home_team.third_down_conv | integer | — | 3rd-down conversions. |
↳fourth_down_att output.scorebox.archetypes.home_team.fourth_down_att | integer | — | 4th-down go-for-it attempts. |
↳fourth_down_conv output.scorebox.archetypes.home_team.fourth_down_conv | integer | — | 4th-down conversions. |
↳drives output.scorebox.archetypes.home_team.drives | integer | — | Total offensive drives. |
↳drive_tds output.scorebox.archetypes.home_team.drive_tds | integer | — | Drives ending in an offensive touchdown. |
↳drive_fgs output.scorebox.archetypes.home_team.drive_fgs | integer | — | Drives ending in a made field goal. |
↳drive_missed_fgs output.scorebox.archetypes.home_team.drive_missed_fgs | integer | — | Drives ending in a missed field goal. |
↳drive_punts output.scorebox.archetypes.home_team.drive_punts | integer | — | Drives ending in a punt. |
↳drive_turnovers output.scorebox.archetypes.home_team.drive_turnovers | integer | — | Drives ending in an interception or fumble lost. |
↳drive_downs output.scorebox.archetypes.home_team.drive_downs | integer | — | Drives ending in a turnover on downs. |
↳drive_end_half output.scorebox.archetypes.home_team.drive_end_half | integer | — | Drives ending by clock expiration at halftime or game end. |
↳fg_att output.scorebox.archetypes.home_team.fg_att | integer | — | Field goals attempted. |
↳fg_made output.scorebox.archetypes.home_team.fg_made | integer | — | Field goals made. |
↳xp_att output.scorebox.archetypes.home_team.xp_att | integer | — | Extra points (PATs) attempted. |
↳xp_made output.scorebox.archetypes.home_team.xp_made | integer | — | Extra points (PATs) made. |
↳two_pt_att output.scorebox.archetypes.home_team.two_pt_att | integer | — | Two-point conversions attempted. |
↳two_pt_made output.scorebox.archetypes.home_team.two_pt_made | integer | — | Two-point conversions succeeded. |
↳penalties output.scorebox.archetypes.home_team.penalties | integer | — | Penalties committed. |
↳penalty_yds output.scorebox.archetypes.home_team.penalty_yds | integer | — | Penalty yards assessed. |
↳time_of_possession_sec output.scorebox.archetypes.home_team.time_of_possession_sec | integer | — | Offensive time of possession in seconds. |
↳throwaways output.scorebox.archetypes.home_team.throwaways | integer | — | Passes thrown away on purpose. |
↳spikes output.scorebox.archetypes.home_team.spikes | integer | — | Spikes to stop the clock. |
↳batted_passes output.scorebox.archetypes.home_team.batted_passes | integer | — | Passes batted down at the line of scrimmage. |
↳oob_untackled_plays output.scorebox.archetypes.home_team.oob_untackled_plays | integer | — | Plays that end out of bounds with no tackler (for example a quarterback who runs out of bounds behind the line, or a return that ends out of bounds). |
↳special_teams_returns output.scorebox.archetypes.home_team.special_teams_returns | integer | — | Kickoffs and punts that the team returned. |
↳kickoffs_total output.scorebox.archetypes.home_team.kickoffs_total | integer | — | Kickoffs that the team received. |
↳kickoff_returns output.scorebox.archetypes.home_team.kickoff_returns | integer | — | Received kickoffs that the team returned (the rest were touchbacks). |
↳kickoff_start_yardline_sum output.scorebox.archetypes.home_team.kickoff_start_yardline_sum | integer | — | Sum of the team's own yard lines at the start of the drives after received kickoffs. Divide by `kickoffs_total` for the mean. |
↳trailing_10plus_dropbacks output.scorebox.archetypes.home_team.trailing_10plus_dropbacks | integer | — | Dropbacks while the team trailed by 10 or more points. |
↳trailing_10plus_plays output.scorebox.archetypes.home_team.trailing_10plus_plays | integer | — | Offensive plays while the team trailed by 10 or more points. |
↳neutral_dropbacks output.scorebox.archetypes.home_team.neutral_dropbacks | integer | — | Dropbacks in the first three quarters while the score was within 6 points. |
↳neutral_plays output.scorebox.archetypes.home_team.neutral_plays | integer | — | Offensive plays in the first three quarters while the score was within 6 points. |
↳p11_snaps output.scorebox.archetypes.home_team.p11_snaps | integer | — | Offensive snaps aligned in 11 personnel (1 RB, 1 TE, 3 WR). |
↳p12_snaps output.scorebox.archetypes.home_team.p12_snaps | integer | — | Offensive snaps aligned in 12 personnel (1 RB, 2 TE, 2 WR). |
↳p21_snaps output.scorebox.archetypes.home_team.p21_snaps | integer | — | Offensive snaps aligned in 21 personnel (2 RB, 1 TE, 2 WR). |
↳no_huddle_snaps output.scorebox.archetypes.home_team.no_huddle_snaps | integer | — | Offensive snaps executed in no-huddle tempo. |
↳unassisted_team_sacks output.scorebox.archetypes.home_team.unassisted_team_sacks | integer | — | Sacks credited to the team defense with no named player (the quarterback ran out of bounds behind the line). |
↳dst_pressures output.scorebox.archetypes.home_team.dst_pressures | integer | — | Quarterback pressures by the defense. |
↳pick_sixes_scored output.scorebox.archetypes.home_team.pick_sixes_scored | integer | — | Interceptions that the defense returned for a touchdown. |
↳fumble_ret_tds_scored output.scorebox.archetypes.home_team.fumble_ret_tds_scored | integer | — | Fumbles that the defense or special teams returned for a touchdown. |
↳dst_sacks output.scorebox.archetypes.home_team.dst_sacks | integer | — | Defensive sacks recorded. |
↳dst_interceptions output.scorebox.archetypes.home_team.dst_interceptions | integer | — | Defensive interceptions recorded. |
↳dst_fumbles_recovered output.scorebox.archetypes.home_team.dst_fumbles_recovered | integer | — | Opponent fumbles recovered by the defense. |
↳dst_defensive_tds output.scorebox.archetypes.home_team.dst_defensive_tds | integer | — | Defensive or special-teams touchdowns scored. |
↳dst_safeties output.scorebox.archetypes.home_team.dst_safeties | integer | — | Safeties recorded by the defense. |
↳dst_points_allowed output.scorebox.archetypes.home_team.dst_points_allowed | integer | — | Points allowed by the defense. |
↳players output.scorebox.archetypes.players | NFLPlayerDrawBoxSummary[] | — | Per-player single-draw box score rows for all players in the game. |
↳player_id output.scorebox.archetypes.players.player_id | integer | — | Canonical player ID. |
↳team_id output.scorebox.archetypes.players.team_id | integer | — | Canonical team ID. |
↳active output.scorebox.archetypes.players.active | boolean | — | True if the player was active on this draw. |
↳snaps output.scorebox.archetypes.players.snaps | integer | — | Offensive snaps played on this draw. |
↳routes output.scorebox.archetypes.players.routes | integer | — | Pass routes run on this draw. |
↳pass_cmp output.scorebox.archetypes.players.pass_cmp | integer | — | Pass completions. |
↳pass_att output.scorebox.archetypes.players.pass_att | integer | — | Pass attempts. |
↳pass_yd output.scorebox.archetypes.players.pass_yd | integer | — | Passing yards. |
↳pass_td output.scorebox.archetypes.players.pass_td | integer | — | Passing touchdowns. |
↳interception output.scorebox.archetypes.players.interception | integer | — | Interceptions thrown. |
↳sacks_taken output.scorebox.archetypes.players.sacks_taken | integer | — | Times sacked. |
↳carries output.scorebox.archetypes.players.carries | integer | — | Total rushing carries (`designed_rushes + scrambles + kneels`). |
↳designed_rushes output.scorebox.archetypes.players.designed_rushes | integer | — | Designed rushing carries. |
↳scrambles output.scorebox.archetypes.players.scrambles | integer | — | QB scramble carries. |
↳rush_yd output.scorebox.archetypes.players.rush_yd | integer | — | Rushing yards. |
↳rush_td output.scorebox.archetypes.players.rush_td | integer | — | Rushing touchdowns. |
↳targets output.scorebox.archetypes.players.targets | integer | — | Receiving targets. |
↳receptions output.scorebox.archetypes.players.receptions | integer | — | Receptions. |
↳rec_yd output.scorebox.archetypes.players.rec_yd | integer | — | Receiving yards. |
↳rec_td output.scorebox.archetypes.players.rec_td | integer | — | Receiving touchdowns. |
↳air_yd output.scorebox.archetypes.players.air_yd | integer | — | Total target air yards. |
↳yac_yd output.scorebox.archetypes.players.yac_yd | integer | — | Total yards after catch. |
↳fumbles_lost output.scorebox.archetypes.players.fumbles_lost | integer | — | Fumbles lost. |
↳two_pt_conv output.scorebox.archetypes.players.two_pt_conv | integer | — | Successful 2-point conversions. |
↳fg_made output.scorebox.archetypes.players.fg_made | integer | — | Field goals made. |
↳fg_att output.scorebox.archetypes.players.fg_att | integer | — | Field goals attempted. |
↳xp_made output.scorebox.archetypes.players.xp_made | integer | — | Extra points made. |
↳xp_att output.scorebox.archetypes.players.xp_att | integer | — | Extra points attempted. |
↳longest_pass output.scorebox.archetypes.players.longest_pass | integer | — | Longest completion in yards. |
↳longest_rush output.scorebox.archetypes.players.longest_rush | integer | — | Longest rush in yards. |
↳longest_rec output.scorebox.archetypes.players.longest_rec | integer | — | Longest reception in yards. |
↳draws output.scorebox.draws | NFLSimGameScoreboxDraw[] | — | First `scorebox_limit` individual game draw scoreboxes (`draw_idx = 0..scorebox_limit-1`). |
↳draw_idx output.scorebox.draws.draw_idx | integer | — | 0-based Monte Carlo draw index (`0 <= draw_idx < n_draws`). |
↳archetype output.scorebox.draws.archetype | stringnullable | — | Archetype slug (`median`, `shootout`, `defensive_slugfest`, `home_blowout`, `away_blowout`, `overtime_thriller`, or `null`). |
↳label output.scorebox.draws.label | string | — | Human-readable draw or archetype title. |
↳away_linescore output.scorebox.draws.away_linescore | integer[6] | — | Away team quarter linescore array `[Q1, Q2, Q3, Q4, OT, Total]`. |
↳home_linescore output.scorebox.draws.home_linescore | integer[6] | — | Home team quarter linescore array `[Q1, Q2, Q3, Q4, OT, Total]`. |
↳total_points output.scorebox.draws.total_points | integer | — | Combined final points (`home_team.points + away_team.points`). |
↳final_margin_home output.scorebox.draws.final_margin_home | integer | — | Final score margin from the home perspective (`home_team.points - away_team.points`). |
↳q4_margin_home output.scorebox.draws.q4_margin_home | integer | — | Score margin at the end of regulation (`0` whenever `overtime_played = true`). |
↳overtime_played output.scorebox.draws.overtime_played | boolean | — | True if regulation ended in a tie and overtime was played. |
↳away_team output.scorebox.draws.away_team | NFLTeamGameBoxScore | — | Away team full offensive, drive, situational, and DST box score. |
↳points output.scorebox.draws.away_team.points | integer | — | Final points scored by the team on this draw. |
↳q1_points output.scorebox.draws.away_team.q1_points | integer | — | 1st-quarter points. |
↳q2_points output.scorebox.draws.away_team.q2_points | integer | — | 2nd-quarter points. |
↳q3_points output.scorebox.draws.away_team.q3_points | integer | — | 3rd-quarter points. |
↳q4_points output.scorebox.draws.away_team.q4_points | integer | — | 4th-quarter points. |
↳ot_points output.scorebox.draws.away_team.ot_points | integer | — | Overtime points. |
↳plays output.scorebox.draws.away_team.plays | integer | — | Total offensive plays (`pass_att + rush_att + sacks_taken`). |
↳pass_att output.scorebox.draws.away_team.pass_att | integer | — | Team pass attempts. |
↳pass_cmp output.scorebox.draws.away_team.pass_cmp | integer | — | Team pass completions. |
↳pass_yd output.scorebox.draws.away_team.pass_yd | integer | — | Team gross passing yards. |
↳pass_td output.scorebox.draws.away_team.pass_td | integer | — | Team passing touchdowns. |
↳interceptions_thrown output.scorebox.draws.away_team.interceptions_thrown | integer | — | Interceptions thrown. |
↳sacks_taken output.scorebox.draws.away_team.sacks_taken | integer | — | Times the quarterback was sacked. |
↳sack_yd_lost output.scorebox.draws.away_team.sack_yd_lost | integer | — | Yards lost on sacks. |
↳rush_att output.scorebox.draws.away_team.rush_att | integer | — | Team rushing attempts. |
↳rush_yd output.scorebox.draws.away_team.rush_yd | integer | — | Team rushing yards. |
↳rush_td output.scorebox.draws.away_team.rush_td | integer | — | Team rushing touchdowns. |
↳first_downs output.scorebox.draws.away_team.first_downs | integer | — | Total offensive first downs earned. |
↳third_down_att output.scorebox.draws.away_team.third_down_att | integer | — | 3rd-down attempts. |
↳third_down_conv output.scorebox.draws.away_team.third_down_conv | integer | — | 3rd-down conversions. |
↳fourth_down_att output.scorebox.draws.away_team.fourth_down_att | integer | — | 4th-down go-for-it attempts. |
↳fourth_down_conv output.scorebox.draws.away_team.fourth_down_conv | integer | — | 4th-down conversions. |
↳drives output.scorebox.draws.away_team.drives | integer | — | Total offensive drives. |
↳drive_tds output.scorebox.draws.away_team.drive_tds | integer | — | Drives ending in an offensive touchdown. |
↳drive_fgs output.scorebox.draws.away_team.drive_fgs | integer | — | Drives ending in a made field goal. |
↳drive_missed_fgs output.scorebox.draws.away_team.drive_missed_fgs | integer | — | Drives ending in a missed field goal. |
↳drive_punts output.scorebox.draws.away_team.drive_punts | integer | — | Drives ending in a punt. |
↳drive_turnovers output.scorebox.draws.away_team.drive_turnovers | integer | — | Drives ending in an interception or fumble lost. |
↳drive_downs output.scorebox.draws.away_team.drive_downs | integer | — | Drives ending in a turnover on downs. |
↳drive_end_half output.scorebox.draws.away_team.drive_end_half | integer | — | Drives ending by clock expiration at halftime or game end. |
↳fg_att output.scorebox.draws.away_team.fg_att | integer | — | Field goals attempted. |
↳fg_made output.scorebox.draws.away_team.fg_made | integer | — | Field goals made. |
↳xp_att output.scorebox.draws.away_team.xp_att | integer | — | Extra points (PATs) attempted. |
↳xp_made output.scorebox.draws.away_team.xp_made | integer | — | Extra points (PATs) made. |
↳two_pt_att output.scorebox.draws.away_team.two_pt_att | integer | — | Two-point conversions attempted. |
↳two_pt_made output.scorebox.draws.away_team.two_pt_made | integer | — | Two-point conversions succeeded. |
↳penalties output.scorebox.draws.away_team.penalties | integer | — | Penalties committed. |
↳penalty_yds output.scorebox.draws.away_team.penalty_yds | integer | — | Penalty yards assessed. |
↳time_of_possession_sec output.scorebox.draws.away_team.time_of_possession_sec | integer | — | Offensive time of possession in seconds. |
↳throwaways output.scorebox.draws.away_team.throwaways | integer | — | Passes thrown away on purpose. |
↳spikes output.scorebox.draws.away_team.spikes | integer | — | Spikes to stop the clock. |
↳batted_passes output.scorebox.draws.away_team.batted_passes | integer | — | Passes batted down at the line of scrimmage. |
↳oob_untackled_plays output.scorebox.draws.away_team.oob_untackled_plays | integer | — | Plays that end out of bounds with no tackler (for example a quarterback who runs out of bounds behind the line, or a return that ends out of bounds). |
↳special_teams_returns output.scorebox.draws.away_team.special_teams_returns | integer | — | Kickoffs and punts that the team returned. |
↳kickoffs_total output.scorebox.draws.away_team.kickoffs_total | integer | — | Kickoffs that the team received. |
↳kickoff_returns output.scorebox.draws.away_team.kickoff_returns | integer | — | Received kickoffs that the team returned (the rest were touchbacks). |
↳kickoff_start_yardline_sum output.scorebox.draws.away_team.kickoff_start_yardline_sum | integer | — | Sum of the team's own yard lines at the start of the drives after received kickoffs. Divide by `kickoffs_total` for the mean. |
↳trailing_10plus_dropbacks output.scorebox.draws.away_team.trailing_10plus_dropbacks | integer | — | Dropbacks while the team trailed by 10 or more points. |
↳trailing_10plus_plays output.scorebox.draws.away_team.trailing_10plus_plays | integer | — | Offensive plays while the team trailed by 10 or more points. |
↳neutral_dropbacks output.scorebox.draws.away_team.neutral_dropbacks | integer | — | Dropbacks in the first three quarters while the score was within 6 points. |
↳neutral_plays output.scorebox.draws.away_team.neutral_plays | integer | — | Offensive plays in the first three quarters while the score was within 6 points. |
↳p11_snaps output.scorebox.draws.away_team.p11_snaps | integer | — | Offensive snaps aligned in 11 personnel (1 RB, 1 TE, 3 WR). |
↳p12_snaps output.scorebox.draws.away_team.p12_snaps | integer | — | Offensive snaps aligned in 12 personnel (1 RB, 2 TE, 2 WR). |
↳p21_snaps output.scorebox.draws.away_team.p21_snaps | integer | — | Offensive snaps aligned in 21 personnel (2 RB, 1 TE, 2 WR). |
↳no_huddle_snaps output.scorebox.draws.away_team.no_huddle_snaps | integer | — | Offensive snaps executed in no-huddle tempo. |
↳unassisted_team_sacks output.scorebox.draws.away_team.unassisted_team_sacks | integer | — | Sacks credited to the team defense with no named player (the quarterback ran out of bounds behind the line). |
↳dst_pressures output.scorebox.draws.away_team.dst_pressures | integer | — | Quarterback pressures by the defense. |
↳pick_sixes_scored output.scorebox.draws.away_team.pick_sixes_scored | integer | — | Interceptions that the defense returned for a touchdown. |
↳fumble_ret_tds_scored output.scorebox.draws.away_team.fumble_ret_tds_scored | integer | — | Fumbles that the defense or special teams returned for a touchdown. |
↳dst_sacks output.scorebox.draws.away_team.dst_sacks | integer | — | Defensive sacks recorded. |
↳dst_interceptions output.scorebox.draws.away_team.dst_interceptions | integer | — | Defensive interceptions recorded. |
↳dst_fumbles_recovered output.scorebox.draws.away_team.dst_fumbles_recovered | integer | — | Opponent fumbles recovered by the defense. |
↳dst_defensive_tds output.scorebox.draws.away_team.dst_defensive_tds | integer | — | Defensive or special-teams touchdowns scored. |
↳dst_safeties output.scorebox.draws.away_team.dst_safeties | integer | — | Safeties recorded by the defense. |
↳dst_points_allowed output.scorebox.draws.away_team.dst_points_allowed | integer | — | Points allowed by the defense. |
↳home_team output.scorebox.draws.home_team | NFLTeamGameBoxScore | — | Home team full offensive, drive, situational, and DST box score. |
↳points output.scorebox.draws.home_team.points | integer | — | Final points scored by the team on this draw. |
↳q1_points output.scorebox.draws.home_team.q1_points | integer | — | 1st-quarter points. |
↳q2_points output.scorebox.draws.home_team.q2_points | integer | — | 2nd-quarter points. |
↳q3_points output.scorebox.draws.home_team.q3_points | integer | — | 3rd-quarter points. |
↳q4_points output.scorebox.draws.home_team.q4_points | integer | — | 4th-quarter points. |
↳ot_points output.scorebox.draws.home_team.ot_points | integer | — | Overtime points. |
↳plays output.scorebox.draws.home_team.plays | integer | — | Total offensive plays (`pass_att + rush_att + sacks_taken`). |
↳pass_att output.scorebox.draws.home_team.pass_att | integer | — | Team pass attempts. |
↳pass_cmp output.scorebox.draws.home_team.pass_cmp | integer | — | Team pass completions. |
↳pass_yd output.scorebox.draws.home_team.pass_yd | integer | — | Team gross passing yards. |
↳pass_td output.scorebox.draws.home_team.pass_td | integer | — | Team passing touchdowns. |
↳interceptions_thrown output.scorebox.draws.home_team.interceptions_thrown | integer | — | Interceptions thrown. |
↳sacks_taken output.scorebox.draws.home_team.sacks_taken | integer | — | Times the quarterback was sacked. |
↳sack_yd_lost output.scorebox.draws.home_team.sack_yd_lost | integer | — | Yards lost on sacks. |
↳rush_att output.scorebox.draws.home_team.rush_att | integer | — | Team rushing attempts. |
↳rush_yd output.scorebox.draws.home_team.rush_yd | integer | — | Team rushing yards. |
↳rush_td output.scorebox.draws.home_team.rush_td | integer | — | Team rushing touchdowns. |
↳first_downs output.scorebox.draws.home_team.first_downs | integer | — | Total offensive first downs earned. |
↳third_down_att output.scorebox.draws.home_team.third_down_att | integer | — | 3rd-down attempts. |
↳third_down_conv output.scorebox.draws.home_team.third_down_conv | integer | — | 3rd-down conversions. |
↳fourth_down_att output.scorebox.draws.home_team.fourth_down_att | integer | — | 4th-down go-for-it attempts. |
↳fourth_down_conv output.scorebox.draws.home_team.fourth_down_conv | integer | — | 4th-down conversions. |
↳drives output.scorebox.draws.home_team.drives | integer | — | Total offensive drives. |
↳drive_tds output.scorebox.draws.home_team.drive_tds | integer | — | Drives ending in an offensive touchdown. |
↳drive_fgs output.scorebox.draws.home_team.drive_fgs | integer | — | Drives ending in a made field goal. |
↳drive_missed_fgs output.scorebox.draws.home_team.drive_missed_fgs | integer | — | Drives ending in a missed field goal. |
↳drive_punts output.scorebox.draws.home_team.drive_punts | integer | — | Drives ending in a punt. |
↳drive_turnovers output.scorebox.draws.home_team.drive_turnovers | integer | — | Drives ending in an interception or fumble lost. |
↳drive_downs output.scorebox.draws.home_team.drive_downs | integer | — | Drives ending in a turnover on downs. |
↳drive_end_half output.scorebox.draws.home_team.drive_end_half | integer | — | Drives ending by clock expiration at halftime or game end. |
↳fg_att output.scorebox.draws.home_team.fg_att | integer | — | Field goals attempted. |
↳fg_made output.scorebox.draws.home_team.fg_made | integer | — | Field goals made. |
↳xp_att output.scorebox.draws.home_team.xp_att | integer | — | Extra points (PATs) attempted. |
↳xp_made output.scorebox.draws.home_team.xp_made | integer | — | Extra points (PATs) made. |
↳two_pt_att output.scorebox.draws.home_team.two_pt_att | integer | — | Two-point conversions attempted. |
↳two_pt_made output.scorebox.draws.home_team.two_pt_made | integer | — | Two-point conversions succeeded. |
↳penalties output.scorebox.draws.home_team.penalties | integer | — | Penalties committed. |
↳penalty_yds output.scorebox.draws.home_team.penalty_yds | integer | — | Penalty yards assessed. |
↳time_of_possession_sec output.scorebox.draws.home_team.time_of_possession_sec | integer | — | Offensive time of possession in seconds. |
↳throwaways output.scorebox.draws.home_team.throwaways | integer | — | Passes thrown away on purpose. |
↳spikes output.scorebox.draws.home_team.spikes | integer | — | Spikes to stop the clock. |
↳batted_passes output.scorebox.draws.home_team.batted_passes | integer | — | Passes batted down at the line of scrimmage. |
↳oob_untackled_plays output.scorebox.draws.home_team.oob_untackled_plays | integer | — | Plays that end out of bounds with no tackler (for example a quarterback who runs out of bounds behind the line, or a return that ends out of bounds). |
↳special_teams_returns output.scorebox.draws.home_team.special_teams_returns | integer | — | Kickoffs and punts that the team returned. |
↳kickoffs_total output.scorebox.draws.home_team.kickoffs_total | integer | — | Kickoffs that the team received. |
↳kickoff_returns output.scorebox.draws.home_team.kickoff_returns | integer | — | Received kickoffs that the team returned (the rest were touchbacks). |
↳kickoff_start_yardline_sum output.scorebox.draws.home_team.kickoff_start_yardline_sum | integer | — | Sum of the team's own yard lines at the start of the drives after received kickoffs. Divide by `kickoffs_total` for the mean. |
↳trailing_10plus_dropbacks output.scorebox.draws.home_team.trailing_10plus_dropbacks | integer | — | Dropbacks while the team trailed by 10 or more points. |
↳trailing_10plus_plays output.scorebox.draws.home_team.trailing_10plus_plays | integer | — | Offensive plays while the team trailed by 10 or more points. |
↳neutral_dropbacks output.scorebox.draws.home_team.neutral_dropbacks | integer | — | Dropbacks in the first three quarters while the score was within 6 points. |
↳neutral_plays output.scorebox.draws.home_team.neutral_plays | integer | — | Offensive plays in the first three quarters while the score was within 6 points. |
↳p11_snaps output.scorebox.draws.home_team.p11_snaps | integer | — | Offensive snaps aligned in 11 personnel (1 RB, 1 TE, 3 WR). |
↳p12_snaps output.scorebox.draws.home_team.p12_snaps | integer | — | Offensive snaps aligned in 12 personnel (1 RB, 2 TE, 2 WR). |
↳p21_snaps output.scorebox.draws.home_team.p21_snaps | integer | — | Offensive snaps aligned in 21 personnel (2 RB, 1 TE, 2 WR). |
↳no_huddle_snaps output.scorebox.draws.home_team.no_huddle_snaps | integer | — | Offensive snaps executed in no-huddle tempo. |
↳unassisted_team_sacks output.scorebox.draws.home_team.unassisted_team_sacks | integer | — | Sacks credited to the team defense with no named player (the quarterback ran out of bounds behind the line). |
↳dst_pressures output.scorebox.draws.home_team.dst_pressures | integer | — | Quarterback pressures by the defense. |
↳pick_sixes_scored output.scorebox.draws.home_team.pick_sixes_scored | integer | — | Interceptions that the defense returned for a touchdown. |
↳fumble_ret_tds_scored output.scorebox.draws.home_team.fumble_ret_tds_scored | integer | — | Fumbles that the defense or special teams returned for a touchdown. |
↳dst_sacks output.scorebox.draws.home_team.dst_sacks | integer | — | Defensive sacks recorded. |
↳dst_interceptions output.scorebox.draws.home_team.dst_interceptions | integer | — | Defensive interceptions recorded. |
↳dst_fumbles_recovered output.scorebox.draws.home_team.dst_fumbles_recovered | integer | — | Opponent fumbles recovered by the defense. |
↳dst_defensive_tds output.scorebox.draws.home_team.dst_defensive_tds | integer | — | Defensive or special-teams touchdowns scored. |
↳dst_safeties output.scorebox.draws.home_team.dst_safeties | integer | — | Safeties recorded by the defense. |
↳dst_points_allowed output.scorebox.draws.home_team.dst_points_allowed | integer | — | Points allowed by the defense. |
↳players output.scorebox.draws.players | NFLPlayerDrawBoxSummary[] | — | Per-player single-draw box score rows for all players in the game. |
↳player_id output.scorebox.draws.players.player_id | integer | — | Canonical player ID. |
↳team_id output.scorebox.draws.players.team_id | integer | — | Canonical team ID. |
↳active output.scorebox.draws.players.active | boolean | — | True if the player was active on this draw. |
↳snaps output.scorebox.draws.players.snaps | integer | — | Offensive snaps played on this draw. |
↳routes output.scorebox.draws.players.routes | integer | — | Pass routes run on this draw. |
↳pass_cmp output.scorebox.draws.players.pass_cmp | integer | — | Pass completions. |
↳pass_att output.scorebox.draws.players.pass_att | integer | — | Pass attempts. |
↳pass_yd output.scorebox.draws.players.pass_yd | integer | — | Passing yards. |
↳pass_td output.scorebox.draws.players.pass_td | integer | — | Passing touchdowns. |
↳interception output.scorebox.draws.players.interception | integer | — | Interceptions thrown. |
↳sacks_taken output.scorebox.draws.players.sacks_taken | integer | — | Times sacked. |
↳carries output.scorebox.draws.players.carries | integer | — | Total rushing carries (`designed_rushes + scrambles + kneels`). |
↳designed_rushes output.scorebox.draws.players.designed_rushes | integer | — | Designed rushing carries. |
↳scrambles output.scorebox.draws.players.scrambles | integer | — | QB scramble carries. |
↳rush_yd output.scorebox.draws.players.rush_yd | integer | — | Rushing yards. |
↳rush_td output.scorebox.draws.players.rush_td | integer | — | Rushing touchdowns. |
↳targets output.scorebox.draws.players.targets | integer | — | Receiving targets. |
↳receptions output.scorebox.draws.players.receptions | integer | — | Receptions. |
↳rec_yd output.scorebox.draws.players.rec_yd | integer | — | Receiving yards. |
↳rec_td output.scorebox.draws.players.rec_td | integer | — | Receiving touchdowns. |
↳air_yd output.scorebox.draws.players.air_yd | integer | — | Total target air yards. |
↳yac_yd output.scorebox.draws.players.yac_yd | integer | — | Total yards after catch. |
↳fumbles_lost output.scorebox.draws.players.fumbles_lost | integer | — | Fumbles lost. |
↳two_pt_conv output.scorebox.draws.players.two_pt_conv | integer | — | Successful 2-point conversions. |
↳fg_made output.scorebox.draws.players.fg_made | integer | — | Field goals made. |
↳fg_att output.scorebox.draws.players.fg_att | integer | — | Field goals attempted. |
↳xp_made output.scorebox.draws.players.xp_made | integer | — | Extra points made. |
↳xp_att output.scorebox.draws.players.xp_att | integer | — | Extra points attempted. |
↳longest_pass output.scorebox.draws.players.longest_pass | integer | — | Longest completion in yards. |
↳longest_rush output.scorebox.draws.players.longest_rush | integer | — | Longest rush in yards. |
↳longest_rec output.scorebox.draws.players.longest_rec | integer | — | Longest reception in yards. |
↳pbp output.pbp | NFLSimTracedGame[]nullable | — | Populated when `include.pbp = true`. |
↳draw_idx output.pbp.draw_idx | integer | — | 0-based Monte Carlo draw index traced. |
↳archetype output.pbp.archetype | stringnullable | — | Archetype slug if this draw corresponds to one of the 6 archetypes. |
↳label output.pbp.label | string | — | Human-readable draw label. |
↳scorebox output.pbp.scorebox | NFLSimGameScoreboxDraw | — | Complete game Scorebox (linescore, team totals, and player box scores) for this draw. |
↳draw_idx output.pbp.scorebox.draw_idx | integer | — | 0-based Monte Carlo draw index (`0 <= draw_idx < n_draws`). |
↳archetype output.pbp.scorebox.archetype | stringnullable | — | Archetype slug (`median`, `shootout`, `defensive_slugfest`, `home_blowout`, `away_blowout`, `overtime_thriller`, or `null`). |
↳label output.pbp.scorebox.label | string | — | Human-readable draw or archetype title. |
↳away_linescore output.pbp.scorebox.away_linescore | integer[6] | — | Away team quarter linescore array `[Q1, Q2, Q3, Q4, OT, Total]`. |
↳home_linescore output.pbp.scorebox.home_linescore | integer[6] | — | Home team quarter linescore array `[Q1, Q2, Q3, Q4, OT, Total]`. |
↳total_points output.pbp.scorebox.total_points | integer | — | Combined final points (`home_team.points + away_team.points`). |
↳final_margin_home output.pbp.scorebox.final_margin_home | integer | — | Final score margin from the home perspective (`home_team.points - away_team.points`). |
↳q4_margin_home output.pbp.scorebox.q4_margin_home | integer | — | Score margin at the end of regulation (`0` whenever `overtime_played = true`). |
↳overtime_played output.pbp.scorebox.overtime_played | boolean | — | True if regulation ended in a tie and overtime was played. |
↳away_team output.pbp.scorebox.away_team | NFLTeamGameBoxScore | — | Away team full offensive, drive, situational, and DST box score. |
↳points output.pbp.scorebox.away_team.points | integer | — | Final points scored by the team on this draw. |
↳q1_points output.pbp.scorebox.away_team.q1_points | integer | — | 1st-quarter points. |
↳q2_points output.pbp.scorebox.away_team.q2_points | integer | — | 2nd-quarter points. |
↳q3_points output.pbp.scorebox.away_team.q3_points | integer | — | 3rd-quarter points. |
↳q4_points output.pbp.scorebox.away_team.q4_points | integer | — | 4th-quarter points. |
↳ot_points output.pbp.scorebox.away_team.ot_points | integer | — | Overtime points. |
↳plays output.pbp.scorebox.away_team.plays | integer | — | Total offensive plays (`pass_att + rush_att + sacks_taken`). |
↳pass_att output.pbp.scorebox.away_team.pass_att | integer | — | Team pass attempts. |
↳pass_cmp output.pbp.scorebox.away_team.pass_cmp | integer | — | Team pass completions. |
↳pass_yd output.pbp.scorebox.away_team.pass_yd | integer | — | Team gross passing yards. |
↳pass_td output.pbp.scorebox.away_team.pass_td | integer | — | Team passing touchdowns. |
↳interceptions_thrown output.pbp.scorebox.away_team.interceptions_thrown | integer | — | Interceptions thrown. |
↳sacks_taken output.pbp.scorebox.away_team.sacks_taken | integer | — | Times the quarterback was sacked. |
↳sack_yd_lost output.pbp.scorebox.away_team.sack_yd_lost | integer | — | Yards lost on sacks. |
↳rush_att output.pbp.scorebox.away_team.rush_att | integer | — | Team rushing attempts. |
↳rush_yd output.pbp.scorebox.away_team.rush_yd | integer | — | Team rushing yards. |
↳rush_td output.pbp.scorebox.away_team.rush_td | integer | — | Team rushing touchdowns. |
↳first_downs output.pbp.scorebox.away_team.first_downs | integer | — | Total offensive first downs earned. |
↳third_down_att output.pbp.scorebox.away_team.third_down_att | integer | — | 3rd-down attempts. |
↳third_down_conv output.pbp.scorebox.away_team.third_down_conv | integer | — | 3rd-down conversions. |
↳fourth_down_att output.pbp.scorebox.away_team.fourth_down_att | integer | — | 4th-down go-for-it attempts. |
↳fourth_down_conv output.pbp.scorebox.away_team.fourth_down_conv | integer | — | 4th-down conversions. |
↳drives output.pbp.scorebox.away_team.drives | integer | — | Total offensive drives. |
↳drive_tds output.pbp.scorebox.away_team.drive_tds | integer | — | Drives ending in an offensive touchdown. |
↳drive_fgs output.pbp.scorebox.away_team.drive_fgs | integer | — | Drives ending in a made field goal. |
↳drive_missed_fgs output.pbp.scorebox.away_team.drive_missed_fgs | integer | — | Drives ending in a missed field goal. |
↳drive_punts output.pbp.scorebox.away_team.drive_punts | integer | — | Drives ending in a punt. |
↳drive_turnovers output.pbp.scorebox.away_team.drive_turnovers | integer | — | Drives ending in an interception or fumble lost. |
↳drive_downs output.pbp.scorebox.away_team.drive_downs | integer | — | Drives ending in a turnover on downs. |
↳drive_end_half output.pbp.scorebox.away_team.drive_end_half | integer | — | Drives ending by clock expiration at halftime or game end. |
↳fg_att output.pbp.scorebox.away_team.fg_att | integer | — | Field goals attempted. |
↳fg_made output.pbp.scorebox.away_team.fg_made | integer | — | Field goals made. |
↳xp_att output.pbp.scorebox.away_team.xp_att | integer | — | Extra points (PATs) attempted. |
↳xp_made output.pbp.scorebox.away_team.xp_made | integer | — | Extra points (PATs) made. |
↳two_pt_att output.pbp.scorebox.away_team.two_pt_att | integer | — | Two-point conversions attempted. |
↳two_pt_made output.pbp.scorebox.away_team.two_pt_made | integer | — | Two-point conversions succeeded. |
↳penalties output.pbp.scorebox.away_team.penalties | integer | — | Penalties committed. |
↳penalty_yds output.pbp.scorebox.away_team.penalty_yds | integer | — | Penalty yards assessed. |
↳time_of_possession_sec output.pbp.scorebox.away_team.time_of_possession_sec | integer | — | Offensive time of possession in seconds. |
↳throwaways output.pbp.scorebox.away_team.throwaways | integer | — | Passes thrown away on purpose. |
↳spikes output.pbp.scorebox.away_team.spikes | integer | — | Spikes to stop the clock. |
↳batted_passes output.pbp.scorebox.away_team.batted_passes | integer | — | Passes batted down at the line of scrimmage. |
↳oob_untackled_plays output.pbp.scorebox.away_team.oob_untackled_plays | integer | — | Plays that end out of bounds with no tackler (for example a quarterback who runs out of bounds behind the line, or a return that ends out of bounds). |
↳special_teams_returns output.pbp.scorebox.away_team.special_teams_returns | integer | — | Kickoffs and punts that the team returned. |
↳kickoffs_total output.pbp.scorebox.away_team.kickoffs_total | integer | — | Kickoffs that the team received. |
↳kickoff_returns output.pbp.scorebox.away_team.kickoff_returns | integer | — | Received kickoffs that the team returned (the rest were touchbacks). |
↳kickoff_start_yardline_sum output.pbp.scorebox.away_team.kickoff_start_yardline_sum | integer | — | Sum of the team's own yard lines at the start of the drives after received kickoffs. Divide by `kickoffs_total` for the mean. |
↳trailing_10plus_dropbacks output.pbp.scorebox.away_team.trailing_10plus_dropbacks | integer | — | Dropbacks while the team trailed by 10 or more points. |
↳trailing_10plus_plays output.pbp.scorebox.away_team.trailing_10plus_plays | integer | — | Offensive plays while the team trailed by 10 or more points. |
↳neutral_dropbacks output.pbp.scorebox.away_team.neutral_dropbacks | integer | — | Dropbacks in the first three quarters while the score was within 6 points. |
↳neutral_plays output.pbp.scorebox.away_team.neutral_plays | integer | — | Offensive plays in the first three quarters while the score was within 6 points. |
↳p11_snaps output.pbp.scorebox.away_team.p11_snaps | integer | — | Offensive snaps aligned in 11 personnel (1 RB, 1 TE, 3 WR). |
↳p12_snaps output.pbp.scorebox.away_team.p12_snaps | integer | — | Offensive snaps aligned in 12 personnel (1 RB, 2 TE, 2 WR). |
↳p21_snaps output.pbp.scorebox.away_team.p21_snaps | integer | — | Offensive snaps aligned in 21 personnel (2 RB, 1 TE, 2 WR). |
↳no_huddle_snaps output.pbp.scorebox.away_team.no_huddle_snaps | integer | — | Offensive snaps executed in no-huddle tempo. |
↳unassisted_team_sacks output.pbp.scorebox.away_team.unassisted_team_sacks | integer | — | Sacks credited to the team defense with no named player (the quarterback ran out of bounds behind the line). |
↳dst_pressures output.pbp.scorebox.away_team.dst_pressures | integer | — | Quarterback pressures by the defense. |
↳pick_sixes_scored output.pbp.scorebox.away_team.pick_sixes_scored | integer | — | Interceptions that the defense returned for a touchdown. |
↳fumble_ret_tds_scored output.pbp.scorebox.away_team.fumble_ret_tds_scored | integer | — | Fumbles that the defense or special teams returned for a touchdown. |
↳dst_sacks output.pbp.scorebox.away_team.dst_sacks | integer | — | Defensive sacks recorded. |
↳dst_interceptions output.pbp.scorebox.away_team.dst_interceptions | integer | — | Defensive interceptions recorded. |
↳dst_fumbles_recovered output.pbp.scorebox.away_team.dst_fumbles_recovered | integer | — | Opponent fumbles recovered by the defense. |
↳dst_defensive_tds output.pbp.scorebox.away_team.dst_defensive_tds | integer | — | Defensive or special-teams touchdowns scored. |
↳dst_safeties output.pbp.scorebox.away_team.dst_safeties | integer | — | Safeties recorded by the defense. |
↳dst_points_allowed output.pbp.scorebox.away_team.dst_points_allowed | integer | — | Points allowed by the defense. |
↳home_team output.pbp.scorebox.home_team | NFLTeamGameBoxScore | — | Home team full offensive, drive, situational, and DST box score. |
↳points output.pbp.scorebox.home_team.points | integer | — | Final points scored by the team on this draw. |
↳q1_points output.pbp.scorebox.home_team.q1_points | integer | — | 1st-quarter points. |
↳q2_points output.pbp.scorebox.home_team.q2_points | integer | — | 2nd-quarter points. |
↳q3_points output.pbp.scorebox.home_team.q3_points | integer | — | 3rd-quarter points. |
↳q4_points output.pbp.scorebox.home_team.q4_points | integer | — | 4th-quarter points. |
↳ot_points output.pbp.scorebox.home_team.ot_points | integer | — | Overtime points. |
↳plays output.pbp.scorebox.home_team.plays | integer | — | Total offensive plays (`pass_att + rush_att + sacks_taken`). |
↳pass_att output.pbp.scorebox.home_team.pass_att | integer | — | Team pass attempts. |
↳pass_cmp output.pbp.scorebox.home_team.pass_cmp | integer | — | Team pass completions. |
↳pass_yd output.pbp.scorebox.home_team.pass_yd | integer | — | Team gross passing yards. |
↳pass_td output.pbp.scorebox.home_team.pass_td | integer | — | Team passing touchdowns. |
↳interceptions_thrown output.pbp.scorebox.home_team.interceptions_thrown | integer | — | Interceptions thrown. |
↳sacks_taken output.pbp.scorebox.home_team.sacks_taken | integer | — | Times the quarterback was sacked. |
↳sack_yd_lost output.pbp.scorebox.home_team.sack_yd_lost | integer | — | Yards lost on sacks. |
↳rush_att output.pbp.scorebox.home_team.rush_att | integer | — | Team rushing attempts. |
↳rush_yd output.pbp.scorebox.home_team.rush_yd | integer | — | Team rushing yards. |
↳rush_td output.pbp.scorebox.home_team.rush_td | integer | — | Team rushing touchdowns. |
↳first_downs output.pbp.scorebox.home_team.first_downs | integer | — | Total offensive first downs earned. |
↳third_down_att output.pbp.scorebox.home_team.third_down_att | integer | — | 3rd-down attempts. |
↳third_down_conv output.pbp.scorebox.home_team.third_down_conv | integer | — | 3rd-down conversions. |
↳fourth_down_att output.pbp.scorebox.home_team.fourth_down_att | integer | — | 4th-down go-for-it attempts. |
↳fourth_down_conv output.pbp.scorebox.home_team.fourth_down_conv | integer | — | 4th-down conversions. |
↳drives output.pbp.scorebox.home_team.drives | integer | — | Total offensive drives. |
↳drive_tds output.pbp.scorebox.home_team.drive_tds | integer | — | Drives ending in an offensive touchdown. |
↳drive_fgs output.pbp.scorebox.home_team.drive_fgs | integer | — | Drives ending in a made field goal. |
↳drive_missed_fgs output.pbp.scorebox.home_team.drive_missed_fgs | integer | — | Drives ending in a missed field goal. |
↳drive_punts output.pbp.scorebox.home_team.drive_punts | integer | — | Drives ending in a punt. |
↳drive_turnovers output.pbp.scorebox.home_team.drive_turnovers | integer | — | Drives ending in an interception or fumble lost. |
↳drive_downs output.pbp.scorebox.home_team.drive_downs | integer | — | Drives ending in a turnover on downs. |
↳drive_end_half output.pbp.scorebox.home_team.drive_end_half | integer | — | Drives ending by clock expiration at halftime or game end. |
↳fg_att output.pbp.scorebox.home_team.fg_att | integer | — | Field goals attempted. |
↳fg_made output.pbp.scorebox.home_team.fg_made | integer | — | Field goals made. |
↳xp_att output.pbp.scorebox.home_team.xp_att | integer | — | Extra points (PATs) attempted. |
↳xp_made output.pbp.scorebox.home_team.xp_made | integer | — | Extra points (PATs) made. |
↳two_pt_att output.pbp.scorebox.home_team.two_pt_att | integer | — | Two-point conversions attempted. |
↳two_pt_made output.pbp.scorebox.home_team.two_pt_made | integer | — | Two-point conversions succeeded. |
↳penalties output.pbp.scorebox.home_team.penalties | integer | — | Penalties committed. |
↳penalty_yds output.pbp.scorebox.home_team.penalty_yds | integer | — | Penalty yards assessed. |
↳time_of_possession_sec output.pbp.scorebox.home_team.time_of_possession_sec | integer | — | Offensive time of possession in seconds. |
↳throwaways output.pbp.scorebox.home_team.throwaways | integer | — | Passes thrown away on purpose. |
↳spikes output.pbp.scorebox.home_team.spikes | integer | — | Spikes to stop the clock. |
↳batted_passes output.pbp.scorebox.home_team.batted_passes | integer | — | Passes batted down at the line of scrimmage. |
↳oob_untackled_plays output.pbp.scorebox.home_team.oob_untackled_plays | integer | — | Plays that end out of bounds with no tackler (for example a quarterback who runs out of bounds behind the line, or a return that ends out of bounds). |
↳special_teams_returns output.pbp.scorebox.home_team.special_teams_returns | integer | — | Kickoffs and punts that the team returned. |
↳kickoffs_total output.pbp.scorebox.home_team.kickoffs_total | integer | — | Kickoffs that the team received. |
↳kickoff_returns output.pbp.scorebox.home_team.kickoff_returns | integer | — | Received kickoffs that the team returned (the rest were touchbacks). |
↳kickoff_start_yardline_sum output.pbp.scorebox.home_team.kickoff_start_yardline_sum | integer | — | Sum of the team's own yard lines at the start of the drives after received kickoffs. Divide by `kickoffs_total` for the mean. |
↳trailing_10plus_dropbacks output.pbp.scorebox.home_team.trailing_10plus_dropbacks | integer | — | Dropbacks while the team trailed by 10 or more points. |
↳trailing_10plus_plays output.pbp.scorebox.home_team.trailing_10plus_plays | integer | — | Offensive plays while the team trailed by 10 or more points. |
↳neutral_dropbacks output.pbp.scorebox.home_team.neutral_dropbacks | integer | — | Dropbacks in the first three quarters while the score was within 6 points. |
↳neutral_plays output.pbp.scorebox.home_team.neutral_plays | integer | — | Offensive plays in the first three quarters while the score was within 6 points. |
↳p11_snaps output.pbp.scorebox.home_team.p11_snaps | integer | — | Offensive snaps aligned in 11 personnel (1 RB, 1 TE, 3 WR). |
↳p12_snaps output.pbp.scorebox.home_team.p12_snaps | integer | — | Offensive snaps aligned in 12 personnel (1 RB, 2 TE, 2 WR). |
↳p21_snaps output.pbp.scorebox.home_team.p21_snaps | integer | — | Offensive snaps aligned in 21 personnel (2 RB, 1 TE, 2 WR). |
↳no_huddle_snaps output.pbp.scorebox.home_team.no_huddle_snaps | integer | — | Offensive snaps executed in no-huddle tempo. |
↳unassisted_team_sacks output.pbp.scorebox.home_team.unassisted_team_sacks | integer | — | Sacks credited to the team defense with no named player (the quarterback ran out of bounds behind the line). |
↳dst_pressures output.pbp.scorebox.home_team.dst_pressures | integer | — | Quarterback pressures by the defense. |
↳pick_sixes_scored output.pbp.scorebox.home_team.pick_sixes_scored | integer | — | Interceptions that the defense returned for a touchdown. |
↳fumble_ret_tds_scored output.pbp.scorebox.home_team.fumble_ret_tds_scored | integer | — | Fumbles that the defense or special teams returned for a touchdown. |
↳dst_sacks output.pbp.scorebox.home_team.dst_sacks | integer | — | Defensive sacks recorded. |
↳dst_interceptions output.pbp.scorebox.home_team.dst_interceptions | integer | — | Defensive interceptions recorded. |
↳dst_fumbles_recovered output.pbp.scorebox.home_team.dst_fumbles_recovered | integer | — | Opponent fumbles recovered by the defense. |
↳dst_defensive_tds output.pbp.scorebox.home_team.dst_defensive_tds | integer | — | Defensive or special-teams touchdowns scored. |
↳dst_safeties output.pbp.scorebox.home_team.dst_safeties | integer | — | Safeties recorded by the defense. |
↳dst_points_allowed output.pbp.scorebox.home_team.dst_points_allowed | integer | — | Points allowed by the defense. |
↳players output.pbp.scorebox.players | NFLPlayerDrawBoxSummary[] | — | Per-player single-draw box score rows for all players in the game. |
↳player_id output.pbp.scorebox.players.player_id | integer | — | Canonical player ID. |
↳team_id output.pbp.scorebox.players.team_id | integer | — | Canonical team ID. |
↳active output.pbp.scorebox.players.active | boolean | — | True if the player was active on this draw. |
↳snaps output.pbp.scorebox.players.snaps | integer | — | Offensive snaps played on this draw. |
↳routes output.pbp.scorebox.players.routes | integer | — | Pass routes run on this draw. |
↳pass_cmp output.pbp.scorebox.players.pass_cmp | integer | — | Pass completions. |
↳pass_att output.pbp.scorebox.players.pass_att | integer | — | Pass attempts. |
↳pass_yd output.pbp.scorebox.players.pass_yd | integer | — | Passing yards. |
↳pass_td output.pbp.scorebox.players.pass_td | integer | — | Passing touchdowns. |
↳interception output.pbp.scorebox.players.interception | integer | — | Interceptions thrown. |
↳sacks_taken output.pbp.scorebox.players.sacks_taken | integer | — | Times sacked. |
↳carries output.pbp.scorebox.players.carries | integer | — | Total rushing carries (`designed_rushes + scrambles + kneels`). |
↳designed_rushes output.pbp.scorebox.players.designed_rushes | integer | — | Designed rushing carries. |
↳scrambles output.pbp.scorebox.players.scrambles | integer | — | QB scramble carries. |
↳rush_yd output.pbp.scorebox.players.rush_yd | integer | — | Rushing yards. |
↳rush_td output.pbp.scorebox.players.rush_td | integer | — | Rushing touchdowns. |
↳targets output.pbp.scorebox.players.targets | integer | — | Receiving targets. |
↳receptions output.pbp.scorebox.players.receptions | integer | — | Receptions. |
↳rec_yd output.pbp.scorebox.players.rec_yd | integer | — | Receiving yards. |
↳rec_td output.pbp.scorebox.players.rec_td | integer | — | Receiving touchdowns. |
↳air_yd output.pbp.scorebox.players.air_yd | integer | — | Total target air yards. |
↳yac_yd output.pbp.scorebox.players.yac_yd | integer | — | Total yards after catch. |
↳fumbles_lost output.pbp.scorebox.players.fumbles_lost | integer | — | Fumbles lost. |
↳two_pt_conv output.pbp.scorebox.players.two_pt_conv | integer | — | Successful 2-point conversions. |
↳fg_made output.pbp.scorebox.players.fg_made | integer | — | Field goals made. |
↳fg_att output.pbp.scorebox.players.fg_att | integer | — | Field goals attempted. |
↳xp_made output.pbp.scorebox.players.xp_made | integer | — | Extra points made. |
↳xp_att output.pbp.scorebox.players.xp_att | integer | — | Extra points attempted. |
↳longest_pass output.pbp.scorebox.players.longest_pass | integer | — | Longest completion in yards. |
↳longest_rush output.pbp.scorebox.players.longest_rush | integer | — | Longest rush in yards. |
↳longest_rec output.pbp.scorebox.players.longest_rec | integer | — | Longest reception in yards. |
↳drives output.pbp.drives | NFLSimDriveSummary[] | — | Chronological Drive Chart summarizing every possession in the game. |
↳drive_number output.pbp.drives.drive_number | integer | — | 1-based sequential drive number in the game. |
↳posteam_is_home output.pbp.drives.posteam_is_home | boolean | — | True if the possessing offense is the home team. |
↳start_quarter output.pbp.drives.start_quarter | integer | — | Quarter in which the drive began (`1..5`). |
↳start_clock output.pbp.drives.start_clock | string | — | Game clock (`MM:SS`) when the drive started. |
↳start_yardline_100 output.pbp.drives.start_yardline_100 | integer | — | Starting distance from the opponent's end zone (`1..99`; `75` = own 25-yard line). |
↳end_yardline_100 output.pbp.drives.end_yardline_100 | integer | — | Ending distance from the opponent's end zone (`0` = touchdown). |
↳plays output.pbp.drives.plays | integer | — | Number of offensive plays run on the drive. |
↳net_yards output.pbp.drives.net_yards | integer | — | Net yards gained on the drive. |
↳first_downs output.pbp.drives.first_downs | integer | — | First downs earned on the drive. |
↳result output.pbp.drives.result | string | — | Drive outcome (`TOUCHDOWN`, `FIELD GOAL`, `MISSED FG`, `PUNT`, `INTERCEPTION`, `FUMBLE`, `DOWNS`, `END OF HALF`, `END OF GAME`). |
↳home_score_after output.pbp.drives.home_score_after | integer | — | Home team score at the conclusion of the drive. |
↳away_score_after output.pbp.drives.away_score_after | integer | — | Away team score at the conclusion of the drive. |
↳plays output.pbp.plays | NFLSimPlayRecord[] | — | Chronological snap-by-snap Play-by-Play tape with formatted NFL Gamebook descriptions. |
↳event output.pbp.plays.event | NFLSimPlayEvent | — | Structured machine `PlayEvent` (`NFLSimPlayEvent`) with down, distance, field position, player IDs, yards, and scoring flags. |
↳game_id output.pbp.plays.event.game_id | integer | — | Canonical NFL game ID. |
↳draw_idx output.pbp.plays.event.draw_idx | integer | — | 0-based Monte Carlo draw index. |
↳drive_number output.pbp.plays.event.drive_number | integer | — | 1-based drive number within the game. |
↳play_number output.pbp.plays.event.play_number | integer | — | 1-based sequential play number within the game. |
↳quarter output.pbp.plays.event.quarter | integer | — | Quarter number (`1..5`). |
↳half_seconds_remaining output.pbp.plays.event.half_seconds_remaining | integer | — | Seconds remaining in the current half (`0..1800`). |
↳game_seconds_remaining output.pbp.plays.event.game_seconds_remaining | integer | — | Seconds remaining in regulation (`0..3600`). |
↳posteam_is_home output.pbp.plays.event.posteam_is_home | boolean | — | True if the possessing offense is the home team. |
↳down output.pbp.plays.event.down | integer | — | Current down (`1..4`). |
↳ydstogo output.pbp.plays.event.ydstogo | integer | — | Yards needed for a first down or goal. |
↳yardline_100 output.pbp.plays.event.yardline_100 | integer | — | Yards from the opponent's end zone (`1..99`). |
↳score_diff output.pbp.plays.event.score_diff | integer | — | Possessing offense score minus defense score before the snap. |
↳home_score_before output.pbp.plays.event.home_score_before | integer | — | Home team score before the snap. |
↳away_score_before output.pbp.plays.event.away_score_before | integer | — | Away team score before the snap. |
↳home_score_after output.pbp.plays.event.home_score_after | integer | — | Home team score after the snap. |
↳away_score_after output.pbp.plays.event.away_score_after | integer | — | Away team score after the snap. |
↳play_type output.pbp.plays.event.play_type | string | — | Play type code (`PassComplete`, `PassIncomplete`, `Sack`, `Scramble`, `Throwaway`, `Rush`, `Kneel`, `Spike`, `FieldGoal`, `Punt`, `ExtraPoint`, `TwoPoint`). |
↳personnel output.pbp.plays.event.personnel | integer | — | Offensive personnel index (`0=11`, `1=12`, `2=21`, `3=13`, `4=22`, `5=Empty`, `6=GoalLine`). |
↳passer_id output.pbp.plays.event.passer_id | integer | — | Passer player ID (`0` on non-pass plays). |
↳rusher_id output.pbp.plays.event.rusher_id | integer | — | Ball-carrier player ID (`0` on non-rush plays). |
↳receiver_id output.pbp.plays.event.receiver_id | integer | — | Targeted receiver player ID (`0` on non-targeted plays). |
↳yards_gained output.pbp.plays.event.yards_gained | integer | — | Net yards gained on the play. |
↳air_yards output.pbp.plays.event.air_yards | integer | — | Pass air yards on targeted pass plays (`0` otherwise). |
↳yac_yards output.pbp.plays.event.yac_yards | integer | — | Yards after catch on completed passes (`0` otherwise). |
↳is_first_down output.pbp.plays.event.is_first_down | boolean | — | True if the play earned a first down. |
↳is_touchdown output.pbp.plays.event.is_touchdown | boolean | — | True if the play resulted in a touchdown. |
↳is_turnover output.pbp.plays.event.is_turnover | boolean | — | True if the play resulted in an interception or lost fumble. |
↳is_sack output.pbp.plays.event.is_sack | boolean | — | True if the quarterback was sacked. |
↳is_complete output.pbp.plays.event.is_complete | boolean | — | True if a pass was completed. |
↳is_fg_good output.pbp.plays.event.is_fg_good | boolean | — | True if a field goal attempt was made. |
↳is_two_pt_good output.pbp.plays.event.is_two_pt_good | boolean | — | True if a two-point conversion succeeded. |
↳clock_display output.pbp.plays.clock_display | string | — | Formatted quarter and clock string (e.g., `Q1 14:22`). |
↳down_distance_display output.pbp.plays.down_distance_display | string | — | Formatted down and distance string (e.g., `2nd & 6`). |
↳yardline_display output.pbp.plays.yardline_display | string | — | Formatted field position string (e.g., `KC 42`). |
↳personnel_display output.pbp.plays.personnel_display | string | — | Offensive personnel grouping code (`11`, `12`, `21`, `13`, `22`, `Empty`, `GoalLine`). |
↳description output.pbp.plays.description | string | — | NFL Gamebook play-by-play text (e.g., `(14:22) P.Mahomes pass short middle to T.Kelce to KC 48 for 11 yards.`). |
↳scenarios output.scenarios | NFLSimScenariosSectionnullable | — | Populated when `include.scenarios = true` or `mode = "scenarios"`. |
↳mode output.scenarios.mode | string | — | Output distribution mode (`scenarios`). |
↳n_monte_carlo_draws output.scenarios.n_monte_carlo_draws | integer | — | Number of Monte Carlo draws partitioned into the scenario clusters. |
↳scenarios_returned output.scenarios.scenarios_returned | integer | — | Number of representative full-game box score scenarios returned (`K`). |
↳probability_sum output.scenarios.probability_sum | number | — | Sum of `probability` across all returned scenarios (`1.0000`). |
↳teams output.scenarios.teams | map<string, NFLSimTeam> | — | Top-level lookup of team model inputs (`NFLTeamFootballInput`) keyed by canonical `team_id` string. |
↳players output.scenarios.players | map<string, NFLSimScenarioPlayerProfile> | — | Top-level lookup of player identity and model traits (`SimScenarioPlayerProfile`) keyed by canonical `player_id` string. |
↳scenarios output.scenarios.scenarios | NFLSimGameScenario[] | — | Representative full-game box score scenarios ordered with `scenario_id: 1` (highest-probability joint-median expected scenario) first. |
↳scenario_id output.scenarios.scenarios.scenario_id | integer | — | 1-based scenario index (`1..scenarios_returned`; `1` is the joint-median expected scenario). |
↳draw_idx output.scenarios.scenarios.draw_idx | integer | — | 0-based Monte Carlo medoid draw index (pass in `include.pbp_draws` on `POST /api/v1/sim/nfl/run` for full play-by-play). |
↳probability output.scenarios.scenarios.probability | number | — | Voronoi cluster probability mass (`cluster_draw_count / n_monte_carlo_draws`; highest on `scenario_id: 1`). |
↳cluster_draw_count output.scenarios.scenarios.cluster_draw_count | integer | — | Number of Monte Carlo draws assigned to this scenario's Voronoi cell. |
↳scoreboard output.scenarios.scenarios.scoreboard | NFLSimScenarioScoreboard | — | Quarter linescore, final score, total points, and home margin. |
↳quarters output.scenarios.scenarios.scoreboard.quarters | NFLSimScenarioQuarters | — | Quarter-by-quarter points scored by away and home. |
↳away output.scenarios.scenarios.scoreboard.quarters.away | integer[] | — | Away team points by quarter. |
↳home output.scenarios.scenarios.scoreboard.quarters.home | integer[] | — | Home team points by quarter. |
↳away_score output.scenarios.scenarios.scoreboard.away_score | integer | — | Final away team score. |
↳home_score output.scenarios.scenarios.scoreboard.home_score | integer | — | Final home team score. |
↳total_points output.scenarios.scenarios.scoreboard.total_points | integer | — | Combined final points (`away_score + home_score`). |
↳home_margin output.scenarios.scenarios.scoreboard.home_margin | integer | — | Final home score margin (`home_score - away_score`). |
↳overtime output.scenarios.scenarios.scoreboard.overtime | booleannullable | — | True when the game went to overtime (omitted when `false`). |
↳teams output.scenarios.scenarios.teams | map<string, NFLSimTeamBoxScoreStat> | — | Sparse non-zero team box score stats keyed by canonical `team_id` string. |
↳players output.scenarios.scenarios.players | map<string, NFLSimPlayerBoxScoreStat> | — | Sparse non-zero player football box score stats keyed by canonical `player_id` string (omits players with zero stats). |
↳player_correlations output.scenarios.scenarios.player_correlations | NFLSimPlayerCorrelations | — | Pairwise player correlation matrix for this scenario (`scenario_id: 1` is the baseline expected correlation; `scenario_id >= 2` is the regime-conditioned local correlation). |
↳player_ids output.scenarios.scenarios.player_correlations.player_ids | integer[] | — | Ordered canonical `player_id` values (and negative `-team_id` sentinels for away/home DST) corresponding to the rows and columns of `matrix`. |
↳matrix output.scenarios.scenarios.player_correlations.matrix | number[][] | — | Symmetric correlation matrix (`matrix[i][j]` is the correlation between `player_ids[i]` and `player_ids[j]`). |
↳pbp output.scenarios.scenarios.pbp | NFLSimGamePbpnullable | — | Optional nested Play-by-Play (`drives` and `plays` with `play_stats`) for this scenario's representative medoid draw (`draw_idx`) when `scenarios_pbp = true`. |
↳drives output.scenarios.scenarios.pbp.drives | NFLSimGameDrive[] | — | Chronological offensive drives in the simulated game. |
↳drive_number output.scenarios.scenarios.pbp.drives.drive_number | integer | — | 1-based drive sequence number in the game. |
↳possession_team_id output.scenarios.scenarios.pbp.drives.possession_team_id | integer | — | Canonical `team_id` of the team with possession. |
↳quarter_start output.scenarios.scenarios.pbp.drives.quarter_start | integer | — | Quarter when the drive started (`1..=5`). |
↳quarter_end output.scenarios.scenarios.pbp.drives.quarter_end | integer | — | Quarter when the drive ended (`1..=5`). |
↳clock_start output.scenarios.scenarios.pbp.drives.clock_start | string | — | Game clock at drive start (`MM:SS`). |
↳clock_end output.scenarios.scenarios.pbp.drives.clock_end | string | — | Game clock at drive end (`MM:SS`). |
↳time_of_possession output.scenarios.scenarios.pbp.drives.time_of_possession | string | — | Drive duration (`MM:SS`). |
↳start_yardline output.scenarios.scenarios.pbp.drives.start_yardline | string | — | Starting field position (e.g., `BUF 25`). |
↳end_yardline output.scenarios.scenarios.pbp.drives.end_yardline | string | — | Ending field position (e.g., `KC 12`). |
↳start_reason output.scenarios.scenarios.pbp.drives.start_reason | string | — | How possession was gained (`KICKOFF`, `PUNT`, `INTERCEPTION`, `FUMBLE`, `DOWNS`, `MISSED_FG`). |
↳result output.scenarios.scenarios.pbp.drives.result | string | — | Human-readable drive outcome (`Touchdown`, `Field goal`, `Missed field goal`, `Punt`, `Interception`, `Fumble`, `Safety`, `Turnover on downs`, `End of half`, `End of game`). |
↳play_count output.scenarios.scenarios.pbp.drives.play_count | integer | — | Number of scrimmage plays in the drive. |
↳net_yards output.scenarios.scenarios.pbp.drives.net_yards | integer | — | Total net yards gained on the drive. |
↳first_downs output.scenarios.scenarios.pbp.drives.first_downs | integer | — | First downs gained on the drive. |
↳inside_20 output.scenarios.scenarios.pbp.drives.inside_20 | boolean | — | True if the drive reached the opponent's red zone (`yardline_100 <= 20`). |
↳scoring_drive output.scenarios.scenarios.pbp.drives.scoring_drive | boolean | — | True if the drive resulted in offensive/kicking points (`Touchdown` or `Field goal`). |
↳first_play_id output.scenarios.scenarios.pbp.drives.first_play_id | integer | — | `play_id` of the first play in the drive. |
↳last_play_id output.scenarios.scenarios.pbp.drives.last_play_id | integer | — | `play_id` of the last play in the drive. |
↳plays output.scenarios.scenarios.pbp.plays | NFLSimPlayByPlay[] | — | Chronological snap-by-snap plays in the simulated game. |
↳play_id output.scenarios.scenarios.pbp.plays.play_id | integer | — | Sequential play identifier within the game (`1..=total_plays`). |
↳drive_number output.scenarios.scenarios.pbp.plays.drive_number | integer | — | 1-based drive number in the game. |
↳play_type output.scenarios.scenarios.pbp.plays.play_type | string | — | Play type (`kickoff`, `pass`, `run`, `punt`, `field_goal`, `extra_point`, `two_point_attempt`, `qb_kneel`, `qb_spike`). |
↳description output.scenarios.scenarios.pbp.plays.description | string | — | Formatted NFL Gamebook play description. |
↳start_situation output.scenarios.scenarios.pbp.plays.start_situation | NFLSimPlaySituation | — | Pre-snap field and clock situation. |
↳quarter output.scenarios.scenarios.pbp.plays.start_situation.quarter | integer | — | Quarter (`1..=4`, `5` = OT). |
↳clock output.scenarios.scenarios.pbp.plays.start_situation.clock | string | — | Quarter clock (`MM:SS`). |
↳quarter_seconds_remaining output.scenarios.scenarios.pbp.plays.start_situation.quarter_seconds_remaining | integer | — | Seconds remaining in the current quarter (`0..=900`). |
↳possession_team_id output.scenarios.scenarios.pbp.plays.start_situation.possession_team_id | integer | — | Canonical `team_id` with possession. |
↳defensive_team_id output.scenarios.scenarios.pbp.plays.start_situation.defensive_team_id | integer | — | Canonical `team_id` on defense. |
↳down output.scenarios.scenarios.pbp.plays.start_situation.down | integernullable | — | Down (`1..=4` on scrimmage plays; `null` on kickoffs and PAT/2-pt plays). |
↳ydstogo output.scenarios.scenarios.pbp.plays.start_situation.ydstogo | integer | — | Yards to first down or goal (`0` on kickoffs and PAT/2-pt plays). |
↳yardline_100 output.scenarios.scenarios.pbp.plays.start_situation.yardline_100 | integer | — | Distance in yards to opponent's end zone (`1..=99`). |
↳yardline output.scenarios.scenarios.pbp.plays.start_situation.yardline | string | — | Formatted yard line string (e.g., `BUF 25`, `KC 12`, `MID 50`). |
↳goal_to_go output.scenarios.scenarios.pbp.plays.start_situation.goal_to_go | boolean | — | True when `ydstogo >= yardline_100`. |
↳end_situation output.scenarios.scenarios.pbp.plays.end_situation | NFLSimPlaySituation | — | Post-snap field and clock situation. |
↳quarter output.scenarios.scenarios.pbp.plays.end_situation.quarter | integer | — | Quarter (`1..=4`, `5` = OT). |
↳clock output.scenarios.scenarios.pbp.plays.end_situation.clock | string | — | Quarter clock (`MM:SS`). |
↳quarter_seconds_remaining output.scenarios.scenarios.pbp.plays.end_situation.quarter_seconds_remaining | integer | — | Seconds remaining in the current quarter (`0..=900`). |
↳possession_team_id output.scenarios.scenarios.pbp.plays.end_situation.possession_team_id | integer | — | Canonical `team_id` with possession. |
↳defensive_team_id output.scenarios.scenarios.pbp.plays.end_situation.defensive_team_id | integer | — | Canonical `team_id` on defense. |
↳down output.scenarios.scenarios.pbp.plays.end_situation.down | integernullable | — | Down (`1..=4` on scrimmage plays; `null` on kickoffs and PAT/2-pt plays). |
↳ydstogo output.scenarios.scenarios.pbp.plays.end_situation.ydstogo | integer | — | Yards to first down or goal (`0` on kickoffs and PAT/2-pt plays). |
↳yardline_100 output.scenarios.scenarios.pbp.plays.end_situation.yardline_100 | integer | — | Distance in yards to opponent's end zone (`1..=99`). |
↳yardline output.scenarios.scenarios.pbp.plays.end_situation.yardline | string | — | Formatted yard line string (e.g., `BUF 25`, `KC 12`, `MID 50`). |
↳goal_to_go output.scenarios.scenarios.pbp.plays.end_situation.goal_to_go | boolean | — | True when `ydstogo >= yardline_100`. |
↳offense_personnel output.scenarios.scenarios.pbp.plays.offense_personnel | stringnullable | — | Offensive personnel package (`11`, `12`, `21`, `13`, `22`, `empty`, `goal_line`). |
↳defense_package output.scenarios.scenarios.pbp.plays.defense_package | stringnullable | — | Defensive sub-package (`base_4_3`, `nickel_4_2_5`, `dime_4_1_6`, `goal_line`). |
↳defenders_in_box output.scenarios.scenarios.pbp.plays.defenders_in_box | integernullable | — | Number of defenders aligned in the tackle box (`5..=8`). |
↳shotgun output.scenarios.scenarios.pbp.plays.shotgun | boolean | — | True when offense is in Shotgun formation. |
↳no_huddle output.scenarios.scenarios.pbp.plays.no_huddle | boolean | — | True when offense is in No-Huddle. |
↳qb_dropback output.scenarios.scenarios.pbp.plays.qb_dropback | boolean | — | True on QB dropbacks (`pass`, `sack`, `scramble`, `throwaway`). |
↳qb_scramble output.scenarios.scenarios.pbp.plays.qb_scramble | boolean | — | True on QB scrambles. |
↳was_pressure output.scenarios.scenarios.pbp.plays.was_pressure | boolean | — | True when the pass rush generated pressure on the QB. |
↳pass_length output.scenarios.scenarios.pbp.plays.pass_length | stringnullable | — | `short` (`air_yards < 16`) or `deep` (`air_yards >= 16`). |
↳pass_location output.scenarios.scenarios.pbp.plays.pass_location | stringnullable | — | `left`, `middle`, or `right`. |
↳air_yards output.scenarios.scenarios.pbp.plays.air_yards | integernullable | — | Air yards on pass attempts. |
↳yards_after_catch output.scenarios.scenarios.pbp.plays.yards_after_catch | integernullable | — | Yards after catch on completions. |
↳run_location output.scenarios.scenarios.pbp.plays.run_location | stringnullable | — | `left`, `middle`, or `right`. |
↳run_gap output.scenarios.scenarios.pbp.plays.run_gap | stringnullable | — | `end`, `guard`, or `tackle`. |
↳yards_gained output.scenarios.scenarios.pbp.plays.yards_gained | integer | — | Net yards gained on the play. |
↳drive_net_yards output.scenarios.scenarios.pbp.plays.drive_net_yards | integer | — | Cumulative net yards on the drive through this play. |
↳first_down output.scenarios.scenarios.pbp.plays.first_down | boolean | — | True when a first down was achieved. |
↳touchdown output.scenarios.scenarios.pbp.plays.touchdown | boolean | — | True when a touchdown was scored. |
↳turnover output.scenarios.scenarios.pbp.plays.turnover | boolean | — | True when possession turned over via interception or fumble lost. |
↳sack output.scenarios.scenarios.pbp.plays.sack | boolean | — | True when QB was sacked. |
↳qb_hit output.scenarios.scenarios.pbp.plays.qb_hit | boolean | — | True when QB was hit. |
↳tackled_for_loss output.scenarios.scenarios.pbp.plays.tackled_for_loss | boolean | — | True on a tackle for loss or sack. |
↳away_score_before output.scenarios.scenarios.pbp.plays.away_score_before | integer | — | Away score before the play. |
↳home_score_before output.scenarios.scenarios.pbp.plays.home_score_before | integer | — | Home score before the play. |
↳away_score_after output.scenarios.scenarios.pbp.plays.away_score_after | integer | — | Away score after the play. |
↳home_score_after output.scenarios.scenarios.pbp.plays.home_score_after | integer | — | Home score after the play. |
↳on_field_offense_ids output.scenarios.scenarios.pbp.plays.on_field_offense_ids | integer[] | — | Canonical `player_id`s of the active QB and offensive skill players (`RB`/`WR`/`TE`) on the field for this snap (omitted when empty). |
↳route_runner_ids output.scenarios.scenarios.pbp.plays.route_runner_ids | integer[] | — | Canonical `player_id`s of the offensive skill players who ran a pass route on this dropback (omitted when empty). |
↳play_stats output.scenarios.scenarios.pbp.plays.play_stats | NFLSimPlayStat[] | — | Ordered multi-player stat attributions across offense, defense/IDP, and special teams on this play. |
↳sequence output.scenarios.scenarios.pbp.plays.play_stats.sequence | integer | — | 1-based participant sequence within `play_stats` (`1..=k`). |
↳player_id output.scenarios.scenarios.pbp.plays.play_stats.player_id | integer | — | Canonical `player_id` (resolves via top-level `players` lookup). |
↳team_id output.scenarios.scenarios.pbp.plays.play_stats.team_id | integer | — | Canonical `team_id` of the player. |
↳category output.scenarios.scenarios.pbp.plays.play_stats.category | string | — | Stat category (`passing`, `rushing`, `receiving`, `defense`, `kicking`). |
↳role output.scenarios.scenarios.pbp.plays.play_stats.role | string | — | Player role on the play (`passer`, `receiver`, `rusher`, `kicker`, `coverage`, `pass_rusher`, `tackler`, `assist_tackler`, `interceptor`, `fumble_recovery`). |
↳pass_att output.scenarios.scenarios.pbp.plays.play_stats.pass_att | integernullable | — | Pass attempts on the play. |
↳pass_cmp output.scenarios.scenarios.pbp.plays.play_stats.pass_cmp | integernullable | — | Pass completions on the play. |
↳pass_yd output.scenarios.scenarios.pbp.plays.play_stats.pass_yd | integernullable | — | Passing yards on the play. |
↳air_yd output.scenarios.scenarios.pbp.plays.play_stats.air_yd | integernullable | — | Air yards on the play. |
↳pass_td output.scenarios.scenarios.pbp.plays.play_stats.pass_td | integernullable | — | Passing touchdowns on the play. |
↳int_thrown output.scenarios.scenarios.pbp.plays.play_stats.int_thrown | integernullable | — | Interceptions thrown on the play. |
↳sacks_taken output.scenarios.scenarios.pbp.plays.play_stats.sacks_taken | integernullable | — | Sacks taken on the play. |
↳sack_yd_lost output.scenarios.scenarios.pbp.plays.play_stats.sack_yd_lost | integernullable | — | Sack yards lost on the play. |
↳rush_att output.scenarios.scenarios.pbp.plays.play_stats.rush_att | integernullable | — | Rushing attempts on the play. |
↳rush_yd output.scenarios.scenarios.pbp.plays.play_stats.rush_yd | integernullable | — | Rushing yards on the play. |
↳rush_td output.scenarios.scenarios.pbp.plays.play_stats.rush_td | integernullable | — | Rushing touchdowns on the play. |
↳is_scramble output.scenarios.scenarios.pbp.plays.play_stats.is_scramble | booleannullable | — | True when the rush was a QB scramble. |
↳targets output.scenarios.scenarios.pbp.plays.play_stats.targets | integernullable | — | Receiving targets on the play. |
↳rec output.scenarios.scenarios.pbp.plays.play_stats.rec | integernullable | — | Receptions on the play. |
↳rec_yd output.scenarios.scenarios.pbp.plays.play_stats.rec_yd | integernullable | — | Receiving yards on the play. |
↳yac_yd output.scenarios.scenarios.pbp.plays.play_stats.yac_yd | integernullable | — | Yards after catch on the play. |
↳rec_td output.scenarios.scenarios.pbp.plays.play_stats.rec_td | integernullable | — | Receiving touchdowns on the play. |
↳fumbles output.scenarios.scenarios.pbp.plays.play_stats.fumbles | integernullable | — | Fumbles on the play. |
↳fumbles_lost output.scenarios.scenarios.pbp.plays.play_stats.fumbles_lost | integernullable | — | Fumbles lost on the play. |
↳two_pt_conv output.scenarios.scenarios.pbp.plays.play_stats.two_pt_conv | integernullable | — | Successful two-point conversions on the play. |
↳fg_att output.scenarios.scenarios.pbp.plays.play_stats.fg_att | integernullable | — | Field goal attempts on the play. |
↳fg_made output.scenarios.scenarios.pbp.plays.play_stats.fg_made | integernullable | — | Field goals made on the play. |
↳xp_att output.scenarios.scenarios.pbp.plays.play_stats.xp_att | integernullable | — | Extra point attempts on the play. |
↳xp_made output.scenarios.scenarios.pbp.plays.play_stats.xp_made | integernullable | — | Extra points made on the play. |
↳kick_distance output.scenarios.scenarios.pbp.plays.play_stats.kick_distance | integernullable | — | Kick distance in yards. |
↳solo_tackles output.scenarios.scenarios.pbp.plays.play_stats.solo_tackles | integernullable | — | Solo tackles on the play. |
↳ast_tackles output.scenarios.scenarios.pbp.plays.play_stats.ast_tackles | integernullable | — | Assisted tackles on the play. |
↳solo_sacks output.scenarios.scenarios.pbp.plays.play_stats.solo_sacks | integernullable | — | Solo sacks on the play. |
↳split_sacks output.scenarios.scenarios.pbp.plays.play_stats.split_sacks | integernullable | — | Split (`0.5`) sacks on the play. |
↳sack_yd output.scenarios.scenarios.pbp.plays.play_stats.sack_yd | integernullable | — | Defensive sack yards credited on the play. |
↳tfl output.scenarios.scenarios.pbp.plays.play_stats.tfl | integernullable | — | Tackles for loss on the play. |
↳qb_hits output.scenarios.scenarios.pbp.plays.play_stats.qb_hits | integernullable | — | Quarterback hits on the play. |
↳pressures output.scenarios.scenarios.pbp.plays.play_stats.pressures | integernullable | — | Quarterback pressures on the play. |
↳targets_coverage output.scenarios.scenarios.pbp.plays.play_stats.targets_coverage | integernullable | — | Pass targets into this defender's primary coverage on the play. |
↳receptions_allowed output.scenarios.scenarios.pbp.plays.play_stats.receptions_allowed | integernullable | — | Completions allowed in coverage on the play. |
↳rec_yd_allowed output.scenarios.scenarios.pbp.plays.play_stats.rec_yd_allowed | integernullable | — | Receiving yards allowed in coverage on the play. |
↳passes_defended output.scenarios.scenarios.pbp.plays.play_stats.passes_defended | integernullable | — | Passes defended on the play. |
↳def_int output.scenarios.scenarios.pbp.plays.play_stats.def_int | integernullable | — | Interceptions caught on the play. |
↳forced_fumbles output.scenarios.scenarios.pbp.plays.play_stats.forced_fumbles | integernullable | — | Forced fumbles on the play. |
↳fumble_rec output.scenarios.scenarios.pbp.plays.play_stats.fumble_rec | integernullable | — | Fumble recoveries on the play. |
↳def_td output.scenarios.scenarios.pbp.plays.play_stats.def_td | integernullable | — | Defensive touchdowns scored on the play. |
↳dk_pts output.scenarios.scenarios.pbp.plays.play_stats.dk_pts | numbernullable | — | Single-play DraftKings fantasy points earned on the play. |
↳fd_pts output.scenarios.scenarios.pbp.plays.play_stats.fd_pts | numbernullable | — | Single-play FanDuel fantasy points earned on the play. |
↳simulations output.simulations | NFLSimSimulationsSectionnullable | — | Populated when `include.simulations = true` or `simulations = true`. |
↳n_simulations output.simulations.n_simulations | integer | — | Number of simulated games returned in `games`. |
↳pbp_included output.simulations.pbp_included | boolean | — | True when nested `pbp` (`drives` and `plays`) is included on every simulated game. |
↳games output.simulations.games | NFLSimSimulatedGame[] | — | All simulated games (`sim_id: 1..=n_simulations`, `draw_idx: 0..n_simulations - 1`). |
↳sim_id output.simulations.games.sim_id | integer | — | 1-based simulated game number (`1..=n_simulations`). |
↳draw_idx output.simulations.games.draw_idx | integer | — | 0-based Monte Carlo draw index (`0..n_draws - 1`). |
↳scoreboard output.simulations.games.scoreboard | NFLSimScenarioScoreboard | — | Quarter linescore, final score, total points, home margin, and overtime flag. |
↳quarters output.simulations.games.scoreboard.quarters | NFLSimScenarioQuarters | — | Quarter-by-quarter points scored by away and home. |
↳away output.simulations.games.scoreboard.quarters.away | integer[] | — | Away team points by quarter. |
↳home output.simulations.games.scoreboard.quarters.home | integer[] | — | Home team points by quarter. |
↳away_score output.simulations.games.scoreboard.away_score | integer | — | Final away team score. |
↳home_score output.simulations.games.scoreboard.home_score | integer | — | Final home team score. |
↳total_points output.simulations.games.scoreboard.total_points | integer | — | Combined final points (`away_score + home_score`). |
↳home_margin output.simulations.games.scoreboard.home_margin | integer | — | Final home score margin (`home_score - away_score`). |
↳overtime output.simulations.games.scoreboard.overtime | booleannullable | — | True when the game went to overtime (omitted when `false`). |
↳teams output.simulations.games.teams | map<string, NFLSimTeamBoxScoreStat> | — | Sparse non-zero team box score stats keyed by canonical `team_id` string. |
↳players output.simulations.games.players | map<string, NFLSimPlayerBoxScoreStat> | — | Sparse non-zero player offensive, kicking, and IDP box score stats keyed by canonical `player_id` string. |
↳pbp output.simulations.games.pbp | NFLSimGamePbpnullable | — | Optional nested Play-by-Play (`drives` and `plays`) when `simulations_pbp = true`. |
↳drives output.simulations.games.pbp.drives | NFLSimGameDrive[] | — | Chronological offensive drives in the simulated game. |
↳drive_number output.simulations.games.pbp.drives.drive_number | integer | — | 1-based drive sequence number in the game. |
↳possession_team_id output.simulations.games.pbp.drives.possession_team_id | integer | — | Canonical `team_id` of the team with possession. |
↳quarter_start output.simulations.games.pbp.drives.quarter_start | integer | — | Quarter when the drive started (`1..=5`). |
↳quarter_end output.simulations.games.pbp.drives.quarter_end | integer | — | Quarter when the drive ended (`1..=5`). |
↳clock_start output.simulations.games.pbp.drives.clock_start | string | — | Game clock at drive start (`MM:SS`). |
↳clock_end output.simulations.games.pbp.drives.clock_end | string | — | Game clock at drive end (`MM:SS`). |
↳time_of_possession output.simulations.games.pbp.drives.time_of_possession | string | — | Drive duration (`MM:SS`). |
↳start_yardline output.simulations.games.pbp.drives.start_yardline | string | — | Starting field position (e.g., `BUF 25`). |
↳end_yardline output.simulations.games.pbp.drives.end_yardline | string | — | Ending field position (e.g., `KC 12`). |
↳start_reason output.simulations.games.pbp.drives.start_reason | string | — | How possession was gained (`KICKOFF`, `PUNT`, `INTERCEPTION`, `FUMBLE`, `DOWNS`, `MISSED_FG`). |
↳result output.simulations.games.pbp.drives.result | string | — | Human-readable drive outcome (`Touchdown`, `Field goal`, `Missed field goal`, `Punt`, `Interception`, `Fumble`, `Safety`, `Turnover on downs`, `End of half`, `End of game`). |
↳play_count output.simulations.games.pbp.drives.play_count | integer | — | Number of scrimmage plays in the drive. |
↳net_yards output.simulations.games.pbp.drives.net_yards | integer | — | Total net yards gained on the drive. |
↳first_downs output.simulations.games.pbp.drives.first_downs | integer | — | First downs gained on the drive. |
↳inside_20 output.simulations.games.pbp.drives.inside_20 | boolean | — | True if the drive reached the opponent's red zone (`yardline_100 <= 20`). |
↳scoring_drive output.simulations.games.pbp.drives.scoring_drive | boolean | — | True if the drive resulted in offensive/kicking points (`Touchdown` or `Field goal`). |
↳first_play_id output.simulations.games.pbp.drives.first_play_id | integer | — | `play_id` of the first play in the drive. |
↳last_play_id output.simulations.games.pbp.drives.last_play_id | integer | — | `play_id` of the last play in the drive. |
↳plays output.simulations.games.pbp.plays | NFLSimPlayByPlay[] | — | Chronological snap-by-snap plays in the simulated game. |
↳play_id output.simulations.games.pbp.plays.play_id | integer | — | Sequential play identifier within the game (`1..=total_plays`). |
↳drive_number output.simulations.games.pbp.plays.drive_number | integer | — | 1-based drive number in the game. |
↳play_type output.simulations.games.pbp.plays.play_type | string | — | Play type (`kickoff`, `pass`, `run`, `punt`, `field_goal`, `extra_point`, `two_point_attempt`, `qb_kneel`, `qb_spike`). |
↳description output.simulations.games.pbp.plays.description | string | — | Formatted NFL Gamebook play description. |
↳start_situation output.simulations.games.pbp.plays.start_situation | NFLSimPlaySituation | — | Pre-snap field and clock situation. |
↳quarter output.simulations.games.pbp.plays.start_situation.quarter | integer | — | Quarter (`1..=4`, `5` = OT). |
↳clock output.simulations.games.pbp.plays.start_situation.clock | string | — | Quarter clock (`MM:SS`). |
↳quarter_seconds_remaining output.simulations.games.pbp.plays.start_situation.quarter_seconds_remaining | integer | — | Seconds remaining in the current quarter (`0..=900`). |
↳possession_team_id output.simulations.games.pbp.plays.start_situation.possession_team_id | integer | — | Canonical `team_id` with possession. |
↳defensive_team_id output.simulations.games.pbp.plays.start_situation.defensive_team_id | integer | — | Canonical `team_id` on defense. |
↳down output.simulations.games.pbp.plays.start_situation.down | integernullable | — | Down (`1..=4` on scrimmage plays; `null` on kickoffs and PAT/2-pt plays). |
↳ydstogo output.simulations.games.pbp.plays.start_situation.ydstogo | integer | — | Yards to first down or goal (`0` on kickoffs and PAT/2-pt plays). |
↳yardline_100 output.simulations.games.pbp.plays.start_situation.yardline_100 | integer | — | Distance in yards to opponent's end zone (`1..=99`). |
↳yardline output.simulations.games.pbp.plays.start_situation.yardline | string | — | Formatted yard line string (e.g., `BUF 25`, `KC 12`, `MID 50`). |
↳goal_to_go output.simulations.games.pbp.plays.start_situation.goal_to_go | boolean | — | True when `ydstogo >= yardline_100`. |
↳end_situation output.simulations.games.pbp.plays.end_situation | NFLSimPlaySituation | — | Post-snap field and clock situation. |
↳quarter output.simulations.games.pbp.plays.end_situation.quarter | integer | — | Quarter (`1..=4`, `5` = OT). |
↳clock output.simulations.games.pbp.plays.end_situation.clock | string | — | Quarter clock (`MM:SS`). |
↳quarter_seconds_remaining output.simulations.games.pbp.plays.end_situation.quarter_seconds_remaining | integer | — | Seconds remaining in the current quarter (`0..=900`). |
↳possession_team_id output.simulations.games.pbp.plays.end_situation.possession_team_id | integer | — | Canonical `team_id` with possession. |
↳defensive_team_id output.simulations.games.pbp.plays.end_situation.defensive_team_id | integer | — | Canonical `team_id` on defense. |
↳down output.simulations.games.pbp.plays.end_situation.down | integernullable | — | Down (`1..=4` on scrimmage plays; `null` on kickoffs and PAT/2-pt plays). |
↳ydstogo output.simulations.games.pbp.plays.end_situation.ydstogo | integer | — | Yards to first down or goal (`0` on kickoffs and PAT/2-pt plays). |
↳yardline_100 output.simulations.games.pbp.plays.end_situation.yardline_100 | integer | — | Distance in yards to opponent's end zone (`1..=99`). |
↳yardline output.simulations.games.pbp.plays.end_situation.yardline | string | — | Formatted yard line string (e.g., `BUF 25`, `KC 12`, `MID 50`). |
↳goal_to_go output.simulations.games.pbp.plays.end_situation.goal_to_go | boolean | — | True when `ydstogo >= yardline_100`. |
↳offense_personnel output.simulations.games.pbp.plays.offense_personnel | stringnullable | — | Offensive personnel package (`11`, `12`, `21`, `13`, `22`, `empty`, `goal_line`). |
↳defense_package output.simulations.games.pbp.plays.defense_package | stringnullable | — | Defensive sub-package (`base_4_3`, `nickel_4_2_5`, `dime_4_1_6`, `goal_line`). |
↳defenders_in_box output.simulations.games.pbp.plays.defenders_in_box | integernullable | — | Number of defenders aligned in the tackle box (`5..=8`). |
↳shotgun output.simulations.games.pbp.plays.shotgun | boolean | — | True when offense is in Shotgun formation. |
↳no_huddle output.simulations.games.pbp.plays.no_huddle | boolean | — | True when offense is in No-Huddle. |
↳qb_dropback output.simulations.games.pbp.plays.qb_dropback | boolean | — | True on QB dropbacks (`pass`, `sack`, `scramble`, `throwaway`). |
↳qb_scramble output.simulations.games.pbp.plays.qb_scramble | boolean | — | True on QB scrambles. |
↳was_pressure output.simulations.games.pbp.plays.was_pressure | boolean | — | True when the pass rush generated pressure on the QB. |
↳pass_length output.simulations.games.pbp.plays.pass_length | stringnullable | — | `short` (`air_yards < 16`) or `deep` (`air_yards >= 16`). |
↳pass_location output.simulations.games.pbp.plays.pass_location | stringnullable | — | `left`, `middle`, or `right`. |
↳air_yards output.simulations.games.pbp.plays.air_yards | integernullable | — | Air yards on pass attempts. |
↳yards_after_catch output.simulations.games.pbp.plays.yards_after_catch | integernullable | — | Yards after catch on completions. |
↳run_location output.simulations.games.pbp.plays.run_location | stringnullable | — | `left`, `middle`, or `right`. |
↳run_gap output.simulations.games.pbp.plays.run_gap | stringnullable | — | `end`, `guard`, or `tackle`. |
↳yards_gained output.simulations.games.pbp.plays.yards_gained | integer | — | Net yards gained on the play. |
↳drive_net_yards output.simulations.games.pbp.plays.drive_net_yards | integer | — | Cumulative net yards on the drive through this play. |
↳first_down output.simulations.games.pbp.plays.first_down | boolean | — | True when a first down was achieved. |
↳touchdown output.simulations.games.pbp.plays.touchdown | boolean | — | True when a touchdown was scored. |
↳turnover output.simulations.games.pbp.plays.turnover | boolean | — | True when possession turned over via interception or fumble lost. |
↳sack output.simulations.games.pbp.plays.sack | boolean | — | True when QB was sacked. |
↳qb_hit output.simulations.games.pbp.plays.qb_hit | boolean | — | True when QB was hit. |
↳tackled_for_loss output.simulations.games.pbp.plays.tackled_for_loss | boolean | — | True on a tackle for loss or sack. |
↳away_score_before output.simulations.games.pbp.plays.away_score_before | integer | — | Away score before the play. |
↳home_score_before output.simulations.games.pbp.plays.home_score_before | integer | — | Home score before the play. |
↳away_score_after output.simulations.games.pbp.plays.away_score_after | integer | — | Away score after the play. |
↳home_score_after output.simulations.games.pbp.plays.home_score_after | integer | — | Home score after the play. |
↳on_field_offense_ids output.simulations.games.pbp.plays.on_field_offense_ids | integer[] | — | Canonical `player_id`s of the active QB and offensive skill players (`RB`/`WR`/`TE`) on the field for this snap (omitted when empty). |
↳route_runner_ids output.simulations.games.pbp.plays.route_runner_ids | integer[] | — | Canonical `player_id`s of the offensive skill players who ran a pass route on this dropback (omitted when empty). |
↳play_stats output.simulations.games.pbp.plays.play_stats | NFLSimPlayStat[] | — | Ordered multi-player stat attributions across offense, defense/IDP, and special teams on this play. |
↳sequence output.simulations.games.pbp.plays.play_stats.sequence | integer | — | 1-based participant sequence within `play_stats` (`1..=k`). |
↳player_id output.simulations.games.pbp.plays.play_stats.player_id | integer | — | Canonical `player_id` (resolves via top-level `players` lookup). |
↳team_id output.simulations.games.pbp.plays.play_stats.team_id | integer | — | Canonical `team_id` of the player. |
↳category output.simulations.games.pbp.plays.play_stats.category | string | — | Stat category (`passing`, `rushing`, `receiving`, `defense`, `kicking`). |
↳role output.simulations.games.pbp.plays.play_stats.role | string | — | Player role on the play (`passer`, `receiver`, `rusher`, `kicker`, `coverage`, `pass_rusher`, `tackler`, `assist_tackler`, `interceptor`, `fumble_recovery`). |
↳pass_att output.simulations.games.pbp.plays.play_stats.pass_att | integernullable | — | Pass attempts on the play. |
↳pass_cmp output.simulations.games.pbp.plays.play_stats.pass_cmp | integernullable | — | Pass completions on the play. |
↳pass_yd output.simulations.games.pbp.plays.play_stats.pass_yd | integernullable | — | Passing yards on the play. |
↳air_yd output.simulations.games.pbp.plays.play_stats.air_yd | integernullable | — | Air yards on the play. |
↳pass_td output.simulations.games.pbp.plays.play_stats.pass_td | integernullable | — | Passing touchdowns on the play. |
↳int_thrown output.simulations.games.pbp.plays.play_stats.int_thrown | integernullable | — | Interceptions thrown on the play. |
↳sacks_taken output.simulations.games.pbp.plays.play_stats.sacks_taken | integernullable | — | Sacks taken on the play. |
↳sack_yd_lost output.simulations.games.pbp.plays.play_stats.sack_yd_lost | integernullable | — | Sack yards lost on the play. |
↳rush_att output.simulations.games.pbp.plays.play_stats.rush_att | integernullable | — | Rushing attempts on the play. |
↳rush_yd output.simulations.games.pbp.plays.play_stats.rush_yd | integernullable | — | Rushing yards on the play. |
↳rush_td output.simulations.games.pbp.plays.play_stats.rush_td | integernullable | — | Rushing touchdowns on the play. |
↳is_scramble output.simulations.games.pbp.plays.play_stats.is_scramble | booleannullable | — | True when the rush was a QB scramble. |
↳targets output.simulations.games.pbp.plays.play_stats.targets | integernullable | — | Receiving targets on the play. |
↳rec output.simulations.games.pbp.plays.play_stats.rec | integernullable | — | Receptions on the play. |
↳rec_yd output.simulations.games.pbp.plays.play_stats.rec_yd | integernullable | — | Receiving yards on the play. |
↳yac_yd output.simulations.games.pbp.plays.play_stats.yac_yd | integernullable | — | Yards after catch on the play. |
↳rec_td output.simulations.games.pbp.plays.play_stats.rec_td | integernullable | — | Receiving touchdowns on the play. |
↳fumbles output.simulations.games.pbp.plays.play_stats.fumbles | integernullable | — | Fumbles on the play. |
↳fumbles_lost output.simulations.games.pbp.plays.play_stats.fumbles_lost | integernullable | — | Fumbles lost on the play. |
↳two_pt_conv output.simulations.games.pbp.plays.play_stats.two_pt_conv | integernullable | — | Successful two-point conversions on the play. |
↳fg_att output.simulations.games.pbp.plays.play_stats.fg_att | integernullable | — | Field goal attempts on the play. |
↳fg_made output.simulations.games.pbp.plays.play_stats.fg_made | integernullable | — | Field goals made on the play. |
↳xp_att output.simulations.games.pbp.plays.play_stats.xp_att | integernullable | — | Extra point attempts on the play. |
↳xp_made output.simulations.games.pbp.plays.play_stats.xp_made | integernullable | — | Extra points made on the play. |
↳kick_distance output.simulations.games.pbp.plays.play_stats.kick_distance | integernullable | — | Kick distance in yards. |
↳solo_tackles output.simulations.games.pbp.plays.play_stats.solo_tackles | integernullable | — | Solo tackles on the play. |
↳ast_tackles output.simulations.games.pbp.plays.play_stats.ast_tackles | integernullable | — | Assisted tackles on the play. |
↳solo_sacks output.simulations.games.pbp.plays.play_stats.solo_sacks | integernullable | — | Solo sacks on the play. |
↳split_sacks output.simulations.games.pbp.plays.play_stats.split_sacks | integernullable | — | Split (`0.5`) sacks on the play. |
↳sack_yd output.simulations.games.pbp.plays.play_stats.sack_yd | integernullable | — | Defensive sack yards credited on the play. |
↳tfl output.simulations.games.pbp.plays.play_stats.tfl | integernullable | — | Tackles for loss on the play. |
↳qb_hits output.simulations.games.pbp.plays.play_stats.qb_hits | integernullable | — | Quarterback hits on the play. |
↳pressures output.simulations.games.pbp.plays.play_stats.pressures | integernullable | — | Quarterback pressures on the play. |
↳targets_coverage output.simulations.games.pbp.plays.play_stats.targets_coverage | integernullable | — | Pass targets into this defender's primary coverage on the play. |
↳receptions_allowed output.simulations.games.pbp.plays.play_stats.receptions_allowed | integernullable | — | Completions allowed in coverage on the play. |
↳rec_yd_allowed output.simulations.games.pbp.plays.play_stats.rec_yd_allowed | integernullable | — | Receiving yards allowed in coverage on the play. |
↳passes_defended output.simulations.games.pbp.plays.play_stats.passes_defended | integernullable | — | Passes defended on the play. |
↳def_int output.simulations.games.pbp.plays.play_stats.def_int | integernullable | — | Interceptions caught on the play. |
↳forced_fumbles output.simulations.games.pbp.plays.play_stats.forced_fumbles | integernullable | — | Forced fumbles on the play. |
↳fumble_rec output.simulations.games.pbp.plays.play_stats.fumble_rec | integernullable | — | Fumble recoveries on the play. |
↳def_td output.simulations.games.pbp.plays.play_stats.def_td | integernullable | — | Defensive touchdowns scored on the play. |
↳dk_pts output.simulations.games.pbp.plays.play_stats.dk_pts | numbernullable | — | Single-play DraftKings fantasy points earned on the play. |
↳fd_pts output.simulations.games.pbp.plays.play_stats.fd_pts | numbernullable | — | Single-play FanDuel fantasy points earned on the play. |