STAT-API

SIM nfl API

nflsim.nflbeta
NFL 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/runbeta
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_idintegerrequired

Game 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:
FieldTypeReferencesDescription
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.