📊 Overview

Our API provides enterprise-grade NBA statistics covering:

Category	Stat Count	Coverage
Match Stats	35+ metrics	Team-level performance
Player Stats	30+ metrics	Individual performance
Market Stats	25+ metrics	Betting-relevant data
Temporal Data	By quarter	Full game + quarter-by-quarter

🏟️ Sample Match Reference

All examples in this guide are from:

Atlanta Hawks 130-123 Cleveland Cavaliers
NBA | Regular Season
November 28, 2025 | State Farm Arena
Atlanta, GA, USA

📁 Match Statistics Endpoint

Fixture Metadata

Every match includes rich contextual data:

{
  "fixture": {
    "id": "202511290A239F45",
    "game_id": "19957-11464-2025-11-28",
    "start_date": "2025-11-29T00:30:00Z",
    "home_team_display": "Atlanta Hawks",
    "away_team_display": "Cleveland Cavaliers",
    "status": "completed",
    "season_type": "Regular Season",
    "season_year": "2025",
    "venue_name": "State Farm Arena",
    "venue_location": "Atlanta, GA, USA",
    "venue_neutral": false
  }
}

Score Data

Granular scoring breakdown by quarter:

{
  "scores": {
    "home": {
      "total": 130,
      "periods": {
        "period_1": 33,
        "period_2": 27,
        "period_3": 37,
        "period_4": 33
      }
    },
    "away": {
      "total": 123,
      "periods": {
        "period_1": 23,
        "period_2": 39,
        "period_3": 28,
        "period_4": 33
      }
    }
  }
}

📈 Team Statistics Categories

1. Scoring & Shooting

Statistic	Hawks	Cavaliers	Description
`points`	130	123	Total points scored
`field_goals_made`	48	44	Field goals made
`field_goals_attempted`	91	95	Field goals attempted
`three_point_field_goals_made`	16	17	Three-pointers made
`three_point_field_goals_attempted`	43	39	Three-pointers attempted
`two_point_field_goals_made`	32	27	Two-pointers made
`two_point_field_goals_attempted`	48	56	Two-pointers attempted
`free_throws_made`	18	18	Free throws made
`free_throws_attempted`	26	20	Free throws attempted

Scoring Breakdown:

{
  "points_in_paint": 64,
  "fast_break_points": 36,
  "second_chance_points": 12,
  "points_off_turnovers": 25
}

2. Rebounds & Boards

Statistic	Hawks	Cavaliers	Description
`total_rebounds`	38	48	Total rebounds
`defensive_rebounds`	32	34	Defensive rebounds
`offensive_rebounds`	6	14	Offensive rebounds
`team_total_rebounds`	11	7	Team rebounds

3. Playmaking & Ball Movement

Statistic	Hawks	Cavaliers	Description
`assists`	36	29	Total assists
`turnovers`	12	17	Turnovers committed
`team_turnovers`	2	0	Team turnovers

4. Defensive Statistics

Statistic	Hawks	Cavaliers	Description
`steals`	11	9	Steals
`blocks`	5	4	Blocks
`blocks_received`	4	5	Shots blocked against

5. Game Flow Metrics

Statistic	Hawks	Cavaliers	Description
`biggest_lead`	13	7	Largest lead in game
`lead_changes`	10	10	Number of lead changes
`max_points_in_a_row`	10	14	Longest scoring run
`timeouts`	5	7	Timeouts used

Real Example - Hawks:

{
  "biggest_lead": 13,
  "lead_changes": 10,
  "max_points_in_a_row": 10,
  "first_basket": 0,
  "timeouts": 5
}

6. Discipline & Fouls

Statistic	Hawks	Cavaliers	Description
`fouls`	14	17	Personal fouls
`flagrant_fouls`	0	0	Flagrant fouls
`player_technical_fouls`	1	0	Technical fouls
`team_technical_fouls`	0	0	Team technicals
`foulouts`	0	0	Players fouled out
`ejections`	0	0	Ejections

💰 Market Statistics (Betting Data)

Pre-calculated metrics for betting markets:

{
  "market_stats": {
    "home": {
      "team_total": 130,
      "1st_half_team_total": 60,
      "2nd_half_team_total": 70,
      "1st_quarter_team_total": 33,
      "2nd_quarter_team_total": 27,
      "3rd_quarter_team_total": 37,
      "4th_quarter_team_total": 33,
      "team_total_rebounds": 38,
      "team_total_assists": 36,
      "team_total_steals": 11,
      "team_total_blocks": 5,
      "team_total_made_threes": 16,
      "team_total_consecutive_points": 10
    }
  }
}

👤 Player Statistics Endpoint

Player Metadata

{
  "player": {
    "id": "B82A4A0D260A",
    "name": "Donovan Mitchell",
    "position": "SG",
    "number": 45,
    "numerical_id": 1224827,
    "base_id": 598615
  },
  "team": {
    "id": "D5348BDFEBCC",
    "name": "Cleveland Cavaliers"
  },
  "status": "completed",
  "is_starter": true
}

🌟 Featured Player Example: Donovan Mitchell

Match Performance: 42 Points, 7 Three-Pointers

Scoring Detail

{
  "points": 42,
  "field_goals_made": 15,
  "field_goals_attempted": 28,
  "three_point_field_goals_made": 7,
  "three_point_field_goals_attempted": 15,
  "two_point_field_goals_made": 8,
  "two_point_field_goals_attempted": 13,
  "free_throws_made": 5,
  "free_throws_attempted": 5,
  "points_off_turnovers": 6
}

Additional Stats

{
  "total_rebounds": 3,
  "defensive_rebounds": 3,
  "offensive_rebounds": 0,
  "assists": 3,
  "steals": 1,
  "blocks": 0,
  "turnovers": 4,
  "fouls": 3,
  "minutes": 35,
  "seconds": 2123,
  "plus_minus": 0,
  "blocks_received": 1,
  "first_basket_including_ft": 1
}

🎯 Player Categories Deep Dive

Scoring Statistics

Example: Donovan Mitchell (42 pts)

{
  "points": 42,
  "field_goals_made": 15,
  "field_goals_attempted": 28,
  "two_point_field_goals_made": 8,
  "two_point_field_goals_attempted": 13,
  "three_point_field_goals_made": 7,
  "three_point_field_goals_attempted": 15,
  "free_throws_made": 5,
  "free_throws_attempted": 5,
  "points_off_turnovers": 6,
  "first_basket": 0,
  "first_team_basket": 0,
  "first_basket_including_ft": 1
}

Rebounding Statistics

Example: Evan Mobley (14 reb)

{
  "total_rebounds": 14,
  "defensive_rebounds": 10,
  "offensive_rebounds": 4,
  "blocks_received": 2
}

Playmaking Statistics

Example: Jalen Johnson (12 ast)

{
  "assists": 12,
  "turnovers": 3,
  "points_off_turnovers": 4
}

Defensive Statistics

Example: Onyeka Okongwu

{
  "steals": 2,
  "blocks": 2,
  "defensive_rebounds": 7,
  "fouls": 5
}

Time & Impact Statistics

Example: Jalen Johnson (+20)

{
  "minutes": 39,
  "seconds": 2328,
  "plus_minus": 20,
  "fouls": 1,
  "flagrant_fouls": 0,
  "technical_fouls": 0
}

📊 Player Market Stats

Pre-calculated for betting markets:

{
  "player_points": 42,
  "player_rebounds": 3,
  "player_assists": 3,
  "player_steals": 1,
  "player_blocks": 0,
  "player_turnovers": 4,
  "player_fouls": 3,
  "player_made_threes": 7,
  "player_threes_attempted": 15,
  "player_field_goals_made": 15,
  "player_field_goals_attempted": 28,
  "player_free_throws_made": 5,
  "player_free_throws_attempted": 5,
  "player_made_two_pointers": 8,
  "player_two_pointers_attempted": 13,
  "player_defensive_rebounds": 3,
  "player_offensive_rebounds": 0,
  "player_steals_+_blocks": 1,
  "player_points_+_assists": 45,
  "player_points_+_rebounds": 45,
  "player_rebounds_+_assists": 6,
  "player_points_+_rebounds_+_assists": 48,
  "player_double_double": 1.42030301,
  "player_triple_double": 1.42030301
}

⏱️ Period-by-Period Breakdown

Statistics are available for:

all - Full game aggregates
period_1 - 1st Quarter
period_2 - 2nd Quarter
period_3 - 3rd Quarter
period_4 - 4th Quarter

Example: Donovan Mitchell by Quarter

Metric	Q1	Q2	Q3	Q4	Full Game
`points`	6	16	4	16	42
`field_goals_made`	1	6	2	6	15
`field_goals_attempted`	5	7	5	11	28
`three_point_field_goals_made`	0	3	0	4	7
`assists`	0	1	1	1	3
`turnovers`	1	0	2	1	4
`plus_minus`	-7	+16	-11	+2	0

🔑 Key Identifiers

Unique ID System

ID Type	Example	Use Case
`id` (string)	`"B82A4A0D260A"`	Primary API reference

📋 Complete Statistic Reference

Match-Level Stats (35+)

Scoring

points, field_goals_made, field_goals_attempted
two_point_field_goals_made, two_point_field_goals_attempted
three_point_field_goals_made, three_point_field_goals_attempted
free_throws_made, free_throws_attempted
points_in_paint, fast_break_points
second_chance_points, points_off_turnovers

Rebounds

total_rebounds, defensive_rebounds, offensive_rebounds
team_total_rebounds

Playmaking & Turnovers

assists, turnovers, team_turnovers

Defense

steals, blocks, blocks_received

Game Flow

biggest_lead, lead_changes, max_points_in_a_row
first_basket, timeouts

Discipline

fouls, flagrant_fouls, foulouts, ejections
player_technical_fouls, team_technical_fouls

Player-Level Stats (30+)

Scoring

points, field_goals_made, field_goals_attempted
two_point_field_goals_made, two_point_field_goals_attempted
three_point_field_goals_made, three_point_field_goals_attempted
free_throws_made, free_throws_attempted
points_off_turnovers

Rebounds

total_rebounds, defensive_rebounds, offensive_rebounds

Playmaking

assists, turnovers

Defense

steals, blocks, blocks_received

Time & Impact

minutes, seconds, plus_minus

Discipline

fouls, flagrant_fouls, technical_fouls

Game Firsts

first_basket, first_team_basket
first_basket_including_ft, first_team_basket_including_ft

🚀 Use Cases

Use Case	Relevant Stats
Fantasy Sports	Points, rebounds, assists, steals, blocks, threes
Betting Analytics	Market stats, quarter breakdowns, PRA combos
Player Grading	Plus/minus, shooting splits, efficiency
Scouting	Per-minute rates, shooting zones, defensive stats
Broadcasting	Real-time stat overlays, comparison widgets
DFS Projections	Minutes, usage, combo stats

🔗 Key API Advantages

Feature	Description
Granular Player Data	Complete per-quarter and full-game player statistics
Combo Market Stats	Pre-calculated PRA, double-double/triple-double indicators
Shooting Splits	2PT/3PT/FT breakdowns for team and player
Game Flow Metrics	Lead changes, biggest lead, scoring runs
Market-Ready Fields	All objects include market totals for prop betting
Complete Match Context	Fixture, venue, scoring periods, and more