Coverage Board
Box Score Endpoints
Game package feeds for traditional, advanced, and specialty box scores
Box Score Endpoints
Ten endpoints make up the standard game package for a single NBA matchup.
One-route key: Every endpoint on this page starts from
game_id.Pair this board with Play-by-Play for event order and Other for rotations, officials, shot maps, and summary tables.
Quick route
| If you need... | Use | Why it is the fastest route |
|---|---|---|
| the main player and team line | BoxScoreTraditionalV3 | Baseline postgame totals for both sides and every player |
| ratings, pace, and possession-based efficiency | BoxScoreAdvancedV3 | Best single stop for offensive/defensive context |
| Dean Oliver four factors | BoxScoreFourFactorsV3 | Turns the game into shooting, turnover, rebounding, and free-throw share |
| scoring shape or shot-source mix | BoxScoreScoringV3 and BoxScoreMiscV3 | Separates how points were created from where they came from |
| touches, distance, and tracking detail | BoxScorePlayerTrackV3 | Adds Second Spectrum movement and touch volume |
| matchup tape support | BoxScoreDefensiveV2 and BoxScoreMatchupsV3 | Focuses on player-vs-player defensive assignments |
| hustle and effort stats | BoxScoreHustleV2 | Surface-level scrappy actions that do not read cleanly from the main line |
| possession share and finishing share | BoxScoreUsageV3 | Shows who consumed team possessions and scoring chances |
Core box packet
| Endpoint | Result sets | What it gives you | Route cue |
|---|---|---|---|
BoxScoreTraditionalV3 | PlayerStats, TeamStats | The primary box score: points, rebounds, assists, minutes, shooting totals, and team line | Start here when the question is simply “what happened?” |
BoxScoreAdvancedV3 | PlayerStats, TeamStats | Offensive/defensive rating, net rating, usage, pace, rebounding share, and PIE | Add immediately after the traditional line when efficiency matters |
BoxScoreFourFactorsV3 | PlayerStats, TeamStats | efg_pct, fta_rate, tm_tov_pct, oreb_pct | Use when you want the fastest explanation for why one side won |
BoxScoreMiscV3 | PlayerStats, TeamStats | pts_off_tov, pts_2nd_chance, pts_fb, pts_paint | Best for scoring-environment context that is not obvious from totals alone |
Shot mix, role, and tracking layers
| Endpoint | Result sets | Key columns / signals | Route cue |
|---|---|---|---|
BoxScoreScoringV3 | PlayerStats, TeamStats | pct_fga_2pt, pct_fga_3pt, pct_ast_2pm, pct_ast_3pm, pct_uast_2pm, pct_uast_3pm | Use when you need shot distribution and assisted-vs-unassisted scoring shape |
BoxScoreUsageV3 | PlayerStats, TeamStats | usg_pct, pct_fgm, pct_fga, pct_fg3m, pct_fg3a, pct_ftm, pct_fta | Best for role load: who finished possessions and who took the volume |
BoxScorePlayerTrackV3 | PlayerStats, TeamStats | speed, distance, touches, passes, contested_shots_2pt, contested_shots_3pt | Add when movement, touch count, or tracking-derived effort changes the read |
BoxScoreHustleV2 | PlayerStats, TeamStats | contested_shots, deflections, charges_drawn, loose_balls_recovered | Pull this when the game turned on chaos, pressure, or extra possessions |
Matchup-specific boards
| Endpoint | Result sets | Key columns / signals | Route cue |
|---|---|---|---|
BoxScoreDefensiveV2 | PlayerStats | matchup_min, partial_poss, player_pts, def_player_id | Use when you want defender-assignment context from the defensive side |
BoxScoreMatchupsV3 | PlayerStats | off_player_id, def_player_id, matchup_min, partial_poss, matchup_fgm, matchup_fga | Use when the question is explicitly one player against another |
Next steps from box scores
Rebuild the possession timeline
Move to Play-by-Play when the final line
is not enough and you need the ordered action log, event taxonomy, or win-probability
swing for the same game_id.
Add rotations, officials, and shot maps
Use Other to round out the same game with stint charts, officiating crews, shot-chart coordinates, and summary result sets that do not belong on the main box board.
Compare the game to season baselines
Jump to League Stats when you need to place one game's pace, ratings, or matchups against the wider season leaderboard and lineup context.
Keep moving
Stay in the same possession
Keep the mental model warm with adjacent pages, section hubs, and search-friendly routes into the same topic cluster.