Skip to main content
Version: main

NBA dataset loaders

flowchart LR
raw["scrape / raw"] --> enrich["enrich"] --> rel["release asset"] --> load["load_*()"]

Automation status

DatasetRelease tagPipeline
load_nba_pbpespn_nba_pbp
load_nba_player_boxscoreespn_nba_player_boxscores
load_nba_scheduleespn_nba_schedules
load_nba_team_boxscoreespn_nba_team_boxscores
load_nba_game_rostersespn_nba_game_rosters
load_nba_officialsespn_nba_officials
load_nba_shotsespn_nba_shots
load_nba_standingsespn_nba_standings
load_nba_player_season_statsespn_nba_player_season_stats
load_nba_team_season_statsespn_nba_team_season_stats
load_nba_draftespn_nba_draft
load_nba_rostersespn_nba_rosters
load_nba_stats_schedulesnba_stats_schedules
load_nba_stats_coachesnba_stats_coaches
load_nba_stats_game_rostersnba_stats_game_rosters
load_nba_stats_lineupsnba_stats_lineups
load_nba_stats_lineups_v3nba_stats_game_lineups
load_nba_stats_officialsnba_stats_officials
load_nba_stats_pbpnba_stats_pbp
load_nba_stats_possessionsnba_stats_possessions
load_nba_stats_game_lineupsnba_stats_game_lineups
load_nba_stats_pbp_v3nba_stats_pbp
load_nba_stats_player_boxscoresnba_stats_player_boxscores
load_nba_stats_player_game_logsnba_stats_player_game_logs
load_nba_stats_player_season_statsnba_stats_player_season_stats
load_nba_stats_possessions_v3nba_stats_possessions
load_nba_stats_rostersnba_stats_rosters
load_nba_stats_shotsnba_stats_shots
load_nba_stats_standingsnba_stats_standings
load_nba_stats_team_boxscoresnba_stats_team_boxscores
load_nba_stats_team_season_statsnba_stats_team_season_stats
load_nba_player_crosswalknba_crosswalk
load_nba_schedule_crosswalknba_crosswalk
load_nba_team_crosswalknba_crosswalk
load_nba_player_coreespn_nba_player_core
load_nba_player_impactnba_player_impact

load_nba_pbp

Release: espn_nba_pbp · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_pbp/play_by_play_{season}.parquet

Returns

col_nametypedescription
game_play_numberInt32Sequential play number within the game.
idFloat64Id.
sequence_numberInt32Sequence number representing a shot-possession (V3 PBP).
type_idInt32Type identifier (numeric).
type_textStringDisplay text for the type field.
textStringText description of the play / record.
away_scoreInt32Away team score at the time of the play.
home_scoreInt32Home team score at the time of the play.
period_numberInt32Numeric period (1-4 for quarters; 5+ for OT).
period_display_valueStringPeriod display label (e.g. '1st Quarter', 'OT').
clock_display_valueStringGame clock display string (e.g. '8:32').
scoring_playBooleanTRUE if the play resulted in points scored.
score_valueInt32Point value of the play (2 / 3 / 1).
team_idInt32Unique team identifier.
athlete_id_1Int32Primary athlete identifier (e.g. shooter).
athlete_id_2Int32Secondary athlete identifier (e.g. assister / fouler).
athlete_id_3Int32Athlete id 3.
wallclockStringWallclock.
shooting_playBooleanTRUE if the play was a shooting attempt.
coordinate_x_rawFloat64X coordinate as returned by the API before any adjustment.
coordinate_y_rawFloat64Y coordinate as returned by the API before any adjustment.
points_attemptedInt32Point value attempted on the shot (2 or 3; 1 for a free throw).
short_descriptionStringShort text description of the play from ESPN.
game_idInt32Unique game identifier.
seasonInt32Season year.
season_typeInt32Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
home_team_idInt32Unique identifier for the home team.
home_team_nameStringHome team name.
home_team_mascotStringHome team mascot.
home_team_abbrevStringHome team three-letter abbreviation.
home_team_name_altStringAlternate home team name.
away_team_idInt32Unique identifier for the away team.
away_team_nameStringAway team name.
away_team_mascotStringAway team mascot.
away_team_abbrevStringAway team three-letter abbreviation.
away_team_name_altStringAlternate away team name.
game_spreadFloat64Game spread (signed; positive = home favored).
home_favoriteBooleanTRUE if the home team is the betting favorite.
game_spread_availableBooleanTRUE if a point spread was available.
home_team_spreadFloat64Home team's point spread.
qtrInt32Quarter (1-4) or OT period (5+).
timeStringTime / clock value.
clock_minutesInt32Clock minutes split out for convenience.
clock_secondsFloat64Clock seconds split out for convenience.
home_timeout_calledBooleanWhether the play is a timeout called by the home team.
away_timeout_calledBooleanWhether the play is a timeout called by the away team.
halfInt32Half of the game (1 or 2).
game_halfInt32Half of the game (1 or 2).
lead_qtrInt32Quarter lead (the next-play's quarter).
lead_halfInt32A lead column on the half
start_quarter_seconds_remainingFloat64Seconds remaining in the period at the start of the play.
start_half_seconds_remainingFloat64Seconds remaining in the half at the start of the play.
start_game_seconds_remainingFloat64Seconds remaining in the game at the start of the play.
end_quarter_seconds_remainingFloat64Seconds remaining in the period at the end of the play.
end_half_seconds_remainingFloat64Seconds remaining in the half at the end of the play.
end_game_seconds_remainingFloat64Seconds remaining in the game at the end of the play.
periodInt32Period of the game (1-4 quarters; 5+ for OT).
lag_qtrInt32Quarter lag (the previous-play's quarter).
lag_halfInt32A lag column on the half
coordinate_xFloat64X coordinate on the court (half-court layout).
coordinate_yFloat64Y coordinate on the court (half-court layout).
game_dateDateGame date (YYYY-MM-DD).
game_date_timeDatetime(time_unit='us', time_zone='America/New_York')Game start date/time (ISO 8601).
athlete_name_1StringName of the primary athlete involved in the play (pairs with athlete_id_1).
athlete_name_2StringName of the secondary athlete involved in the play (e.g. the assister or fouled player).
athlete_name_3StringName of the tertiary athlete involved in the play.
type_abbreviationStringType abbreviation.
load_nba_pbp(seasons=2024)

load_nba_player_boxscore

Release: espn_nba_player_boxscores · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_player_boxscores/player_box_{season}.parquet

Returns

col_nametypedescription
game_idInt32Unique game identifier.
seasonInt32Season year.
season_typeInt32Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_dateDateGame date (YYYY-MM-DD).
game_date_timeDatetime(time_unit='us', time_zone='America/New_York')Game start date/time (ISO 8601).
athlete_idInt32Unique athlete identifier (ESPN).
athlete_display_nameStringAthlete display name (full).
team_idInt32Unique team identifier.
team_nameStringFull team display name (e.g. 'Las Vegas Aces').
team_locationStringTeam city or location string.
team_short_display_nameStringShort team display name (e.g. 'Aces').
minutesFloat64Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_madeInt32Field goals made (2-pt + 3-pt).
field_goals_attemptedInt32Field goal attempts (2-pt + 3-pt).
three_point_field_goals_madeInt32Three-point field goals made.
three_point_field_goals_attemptedInt32Three-point field goal attempts.
free_throws_madeInt32Free throws made.
free_throws_attemptedInt32Free throw attempts.
offensive_reboundsInt32Offensive rebounds.
defensive_reboundsInt32Defensive rebounds.
reboundsInt32Total rebounds.
assistsInt32Total assists.
stealsInt32Total steals.
blocksInt32Total blocks.
turnoversInt32Total turnovers.
foulsInt32Personal fouls.
plus_minusStringPlus/minus point differential while on court.
pointsInt32Points scored.
starterBooleanTRUE if the player was in the starting lineup; FALSE otherwise.
ejectedBooleanTRUE if the player was ejected from the game.
did_not_playBooleanTRUE if the player did not appear in the game.
reasonStringReason.
activeBooleanTRUE if the row represents an active record (player / team / season).
athlete_jerseyStringAthlete jersey number.
athlete_short_nameStringAthlete short display name.
athlete_headshot_hrefStringAthlete headshot image URL.
athlete_position_nameStringAthlete position ('Guard', 'Forward', 'Center').
athlete_position_abbreviationStringAthlete position abbreviation (G / F / C).
team_display_nameStringFull team display name.
team_uidStringESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slugStringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_logoStringTeam logo image URL.
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
team_colorStringTeam primary color (hex without leading '#').
team_alternate_colorStringTeam alternate color (hex without leading '#').
home_awayStringGame venue label ('home' or 'away').
team_winnerBooleanTRUE if the team won this game.
team_scoreInt32Team's score / final score.
opponent_team_idInt32Unique identifier for the opponent team.
opponent_team_nameStringOpponent team display name.
opponent_team_locationStringOpponent team city / location.
opponent_team_display_nameStringOpponent team full display name.
opponent_team_abbreviationStringOpponent team abbreviation.
opponent_team_logoStringOpponent team logo URL.
opponent_team_colorStringOpponent team primary color (hex).
opponent_team_alternate_colorStringOpponent team alternate color (hex).
opponent_team_scoreInt32Opponent team's score.
load_nba_player_boxscore(seasons=2024)

load_nba_schedule

Release: espn_nba_schedules · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_schedules/nba_schedule_{season}.parquet

Returns

col_nametypedescription
idInt32Id.
uidStringESPN UID string.
dateStringDate in YYYY-MM-DD format.
attendanceFloat64Reported attendance.
time_validBooleanTime valid.
neutral_siteBooleanNeutral site.
conference_competitionBooleanConference competition.
play_by_play_availableBooleanWhether play-by-play data is available.
recentBooleanRecent.
start_dateStringStart date (YYYY-MM-DD).
broadcastStringBroadcast information string.
highlightsStringGame highlight urls.
notes_typeStringNotes type.
notes_headlineStringNotes headline.
broadcast_marketStringBroadcast market label (e.g. 'national', 'home').
broadcast_nameStringBroadcast name.
type_idInt32Type identifier (numeric).
type_abbreviationStringType abbreviation.
venue_idInt32Unique venue identifier.
venue_full_nameStringVenue full name.
venue_address_cityStringVenue address city.
venue_indoorBooleanTRUE if the venue is indoors.
status_clockFloat64Status clock.
status_display_clockStringStatus display clock.
status_periodFloat64Status period.
status_type_idInt32Unique identifier for status type.
status_type_nameStringStatus type name.
status_type_stateStringStatus type state.
status_type_completedBooleanStatus type completed.
status_type_descriptionStringStatus type description.
status_type_detailStringStatus type detail.
status_type_short_detailStringStatus type short detail.
format_regulation_periodsFloat64Format regulation periods.
home_idInt32Unique identifier for home.
home_uidStringHome team's uid.
home_locationStringHome team's location.
home_nameStringHome name.
home_abbreviationStringHome team's abbreviation.
home_display_nameStringHome display name.
home_short_display_nameStringHome short display name.
home_colorStringColor code (hex) for home.
home_alternate_colorStringColor code (hex) for home alternate.
home_is_activeBooleanHome team's is active.
home_venue_idInt32Unique identifier for home venue.
home_logoStringHome team logo URL.
home_scoreInt32Home team score at the time of the play.
home_winnerBooleanHome team's winner.
home_linescoresStringPeriod-by-period points for the home team, stringified from ESPN's linescores array.
home_recordsStringHome team's records at game time (overall, home, away), stringified from ESPN.
away_idInt32Unique identifier for away.
away_uidStringAway team's uid.
away_locationStringAway team's location.
away_nameStringAway name.
away_abbreviationStringAway team's abbreviation.
away_display_nameStringAway display name.
away_short_display_nameStringAway short display name.
away_colorStringColor code (hex) for away.
away_alternate_colorStringColor code (hex) for away alternate.
away_is_activeBooleanAway team's is active.
away_venue_idInt32Unique identifier for away venue.
away_logoStringAway team logo URL.
away_scoreInt32Away team score at the time of the play.
away_winnerBooleanAway team's winner.
away_linescoresStringPeriod-by-period points for the away team, stringified from ESPN's linescores array.
away_recordsStringAway team's records at game time (overall, home, away), stringified from ESPN.
game_idInt32Unique game identifier.
seasonInt32Season year.
season_typeInt32Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
venue_address_stateStringVenue address state / region.
status_type_alt_detailStringStatus type alt detail.
game_jsonBooleanWhether processed game JSON is available.
game_json_urlStringURL to the processed game JSON.
game_date_timeDatetime(time_unit='us', time_zone='America/New_York')Game start date/time (ISO 8601).
game_dateDateGame date (YYYY-MM-DD).
PBPBooleanWhether play-by-play data is available.
team_boxBooleanTeam box.
player_boxBooleanPlayer box.
load_nba_schedule(seasons=2024)

load_nba_team_boxscore

Release: espn_nba_team_boxscores · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_team_boxscores/team_box_{season}.parquet

Returns

col_nametypedescription
game_idInt32Unique game identifier.
seasonInt32Season year.
season_typeInt32Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_dateDateGame date (YYYY-MM-DD).
game_date_timeDatetime(time_unit='us', time_zone='America/New_York')Game start date/time (ISO 8601).
team_idInt32Unique team identifier.
team_uidStringESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slugStringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_locationStringTeam city or location string.
team_nameStringFull team display name (e.g. 'Las Vegas Aces').
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
team_display_nameStringFull team display name.
team_short_display_nameStringShort team display name (e.g. 'Aces').
team_colorStringTeam primary color (hex without leading '#').
team_alternate_colorStringTeam alternate color (hex without leading '#').
team_logoStringTeam logo image URL.
team_home_awayStringTeam home away.
team_scoreInt32Team's score / final score.
team_winnerBooleanTRUE if the team won this game.
assistsInt32Total assists.
blocksInt32Total blocks.
defensive_reboundsInt32Defensive rebounds.
fast_break_pointsStringFast-break points scored.
field_goal_pctFloat64Field goal percentage (0-1).
field_goals_madeInt32Field goals made (2-pt + 3-pt).
field_goals_attemptedInt32Field goal attempts (2-pt + 3-pt).
flagrant_foulsInt32Total flagrant fouls.
foulsInt32Personal fouls.
free_throw_pctFloat64Free throw percentage (0-1).
free_throws_madeInt32Free throws made.
free_throws_attemptedInt32Free throw attempts.
largest_leadStringLargest lead during the game.
offensive_reboundsInt32Offensive rebounds.
points_in_paintStringPoints scored in the paint.
stealsInt32Total steals.
team_turnoversInt32Team turnovers (turnovers credited to the team rather than a player).
technical_foulsInt32Total technical fouls.
three_point_field_goal_pctFloat64Three-point field goal percentage (0-1).
three_point_field_goals_madeInt32Three-point field goals made.
three_point_field_goals_attemptedInt32Three-point field goal attempts.
total_reboundsInt32Total rebounds.
total_technical_foulsInt32Total technical fouls (player + team).
total_turnoversInt32Total turnovers (player + team).
turnover_pointsStringTurnover points.
turnoversInt32Total turnovers.
opponent_team_idInt32Unique identifier for the opponent team.
opponent_team_uidStringOpponent team uid.
opponent_team_slugStringOpponent team slug.
opponent_team_locationStringOpponent team city / location.
opponent_team_nameStringOpponent team display name.
opponent_team_abbreviationStringOpponent team abbreviation.
opponent_team_display_nameStringOpponent team full display name.
opponent_team_short_display_nameStringOpponent team short display name.
opponent_team_colorStringOpponent team primary color (hex).
opponent_team_alternate_colorStringOpponent team alternate color (hex).
opponent_team_logoStringOpponent team logo URL.
opponent_team_scoreInt32Opponent team's score.
lead_changesStringLead changes.
lead_percentageStringPercentage of the game the team held the lead, from ESPN's team box score stats.
load_nba_team_boxscore(seasons=2024)

load_nba_game_rosters

Release: espn_nba_game_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_game_rosters/game_rosters_{season}.parquet

Returns

col_nametypedescription
seasonInt32Season year.
game_idStringUnique game identifier.
team_idInt32Unique team identifier.
team_slugStringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
team_display_nameStringFull team display name.
home_awayStringGame venue label ('home' or 'away').
athlete_idInt32Unique athlete identifier (ESPN).
athlete_uidStringESPN athlete UID (universal identifier).
athlete_guidStringESPN athlete GUID.
athlete_display_nameStringAthlete display name (full).
athlete_short_nameStringAthlete short display name.
athlete_first_nameStringPlayer first name; athlete_detail = TRUE only.
athlete_last_nameStringAthlete last name.
athlete_jerseyStringAthlete jersey number.
athlete_positionStringAthlete position.
athlete_headshotStringURL of the player's headshot image.
starterBooleanTRUE if the player was in the starting lineup; FALSE otherwise.
did_not_playBooleanTRUE if the player did not appear in the game.
activeBooleanTRUE if the row represents an active record (player / team / season).
ejectedBooleanTRUE if the player was ejected from the game.
reasonStringReason.
load_nba_game_rosters(seasons=2002)

load_nba_officials

Release: espn_nba_officials · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_officials/officials_{season}.parquet

Returns

col_nametypedescription
seasonInt32Season year.
game_idInt32Unique game identifier.
official_full_nameStringFull name of an on-court game official as ESPN publishes it in the summary gameInfo.officials array; it is identical to official_display_name in every released NBA row.
official_display_nameStringESPN's display-form name for the official, falling back to the full name when ESPN omits it; it never diverges from official_full_name in the released NBA data.
official_positionStringESPN's label for the official's assignment slot; the NBA summary feed only ever ships Referee, so this reads the same on every released row.
official_position_idInt32ESPN's numeric identifier for the official's assignment slot, constant at 40 (Referee) across every released NBA season.
official_orderInt32The official's listing index within the game's crew as ESPN orders them, normally 1 through 3 for a three-person crew; a fourth entry appears in a small share of recent-season games and the sequence is not guaranteed to be gap-free.
load_nba_officials(seasons=2002)

load_nba_shots

Release: espn_nba_shots · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_shots/shots_{season}.parquet

Returns

col_nametypedescription
game_idInt32Unique game identifier.
seasonInt32Season year.
period_numberInt32Numeric period (1-4 for quarters; 5+ for OT).
clock_display_valueStringGame clock display string (e.g. '8:32').
team_idInt32Unique team identifier.
athlete_id_1Int32Primary athlete identifier (e.g. shooter).
athlete_id_2Int32Secondary athlete identifier (e.g. assister / fouler).
type_idInt32Type identifier (numeric).
type_textStringDisplay text for the type field.
scoring_playBooleanTRUE if the play resulted in points scored.
score_valueInt32Point value of the play (2 / 3 / 1).
coordinate_xFloat64X coordinate on the court (half-court layout).
coordinate_yFloat64Y coordinate on the court (half-court layout).
coordinate_x_rawFloat64X coordinate as returned by the API before any adjustment.
coordinate_y_rawFloat64Y coordinate as returned by the API before any adjustment.
athlete_name_1StringName of the shooter on the attempt.
athlete_name_2StringName of the secondary athlete on the attempt (e.g. the assister).
team_nameStringFull team display name (e.g. 'Las Vegas Aces').
team_mascotStringMascot (nickname) portion of the shooting team's name.
team_abbrevStringAbbreviation for team.
load_nba_shots(seasons=2002)

load_nba_standings

Release: espn_nba_standings · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_standings/standings_{season}.parquet

Returns

col_nametypedescription
seasonInt32Season year.
group_idStringESPN group id.
group_nameStringGroup name (conference / division).
group_abbreviationStringGroup abbreviation.
group_short_nameStringESPN's short name for the standings grouping the team sits in, read from the group node's shortName; the NBA standings payload supplies only the group name and abbreviation, so this is null throughout.
team_idInt32Unique team identifier.
team_uidStringESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slugStringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_locationStringTeam city or location string.
team_nameStringFull team display name (e.g. 'Las Vegas Aces').
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
team_display_nameStringFull team display name.
team_short_display_nameStringShort team display name (e.g. 'Aces').
team_colorStringTeam primary color (hex without leading '#').
team_alternate_colorStringTeam alternate color (hex without leading '#').
team_logoStringTeam logo image URL.
stat_nameStringStat key.
stat_display_nameStringStat display name.
stat_short_display_nameStringShort human-readable stat name.
stat_descriptionStringESPN's prose gloss for the standings statistic on this row; for the clincher stat it is not a fixed label but the team's actual status text, such as Clinched Playoff Berth or Eliminated From Playoff.
stat_abbreviationStringESPN's short code for the standings statistic, such as PCT, GB or OPP PPG; it is null for the four record-style splits (Home, Road, vs. Conf., vs. Div.), which ship no abbreviation.
stat_typeStringStat type code (e.g. "win", "loss").
display_valueStringDisplay-formatted value.
valueFloat64Numeric or string value field.
load_nba_standings(seasons=2002)

load_nba_player_season_stats

Release: espn_nba_player_season_stats · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_player_season_stats/player_season_stats_{season}.parquet

Returns

col_nametypedescription
seasonInt32Season year.
athlete_idInt32Unique athlete identifier (ESPN).
athlete_display_nameStringAthlete display name (full).
athlete_position_abbreviationStringAthlete position abbreviation (G / F / C).
athlete_jerseyStringAthlete jersey number.
team_idInt32Unique team identifier.
team_slugStringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_display_nameStringFull team display name.
categoryStringCategory label.
stat_labelStringHuman-readable label of the statistic (e.g. 'At bats').
stat_nameStringStat key.
stat_display_nameStringStat display name.
stat_descriptionStringESPN's prose definition of the statistic on this row, for example the ratio of field goals made to field goals attempted; for the paired Made-Attempted stats it is the two definitions joined with a hyphen.
display_valueStringDisplay-formatted value.
valueFloat64Numeric or string value field.
load_nba_player_season_stats(seasons=2025)

load_nba_team_season_stats

Release: espn_nba_team_season_stats · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_team_season_stats/team_season_stats_{season}.parquet

Returns

col_nametypedescription
seasonInt32Season year.
team_idInt32Unique team identifier.
team_slugStringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
team_display_nameStringFull team display name.
team_short_display_nameStringShort team display name (e.g. 'Aces').
team_colorStringTeam primary color (hex without leading '#').
team_alternate_colorStringTeam alternate color (hex without leading '#').
team_logoStringTeam logo image URL.
categoryStringCategory label.
stat_labelStringHuman-readable label of the statistic (e.g. 'At bats').
stat_nameStringStat key.
stat_display_nameStringStat display name.
stat_descriptionStringESPN's prose definition of the team statistic on this row, for example the average number of assists a team records per turnover.
display_valueStringDisplay-formatted value.
valueFloat64Numeric or string value field.
load_nba_team_season_stats(seasons=2025)

load_nba_draft

Release: espn_nba_draft · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_draft/draft_{season}.parquet

Returns

col_nametypedescription
seasonInt32Season year.
roundInt32Tournament / playoff round.
round_display_nameStringESPN's display label for the draft round a pick belongs to, read from the round object's displayName; the NBA payload supplies no round metadata, so this is null for every released season 2003 through 2025.
pickInt32Pick number within the round.
overall_pickInt32Overall pick.
pick_tradedStringESPN's traded flag for the pick, carried through as a string rather than a boolean; every released NBA row reads FALSE, so it does not currently identify traded picks.
pick_notesStringFree-text note ESPN can attach to a pick, read from the pick's notes or note field; the NBA draft payload never populates it, so it is null across all released seasons.
athlete_idInt32Unique athlete identifier (ESPN).
athlete_uidStringESPN athlete UID (universal identifier).
athlete_guidStringESPN athlete GUID.
athlete_first_nameStringPlayer first name; athlete_detail = TRUE only.
athlete_last_nameStringAthlete last name.
athlete_full_nameStringDrafted player full name.
athlete_display_nameStringAthlete display name (full).
athlete_short_nameStringAthlete short display name.
athlete_heightStringAthlete height.
athlete_weightStringAthlete weight.
athlete_position_abbreviationStringAthlete position abbreviation (G / F / C).
athlete_position_nameStringAthlete position ('Guard', 'Forward', 'Center').
athlete_headshot_hrefStringAthlete headshot image URL.
college_idInt32Unique identifier for college.
college_nameStringCollege / pre-draft team.
college_short_nameStringCollege short name.
college_abbreviationStringAbbreviation of the drafted player's college taken from the pick's nested college block; the ESPN NBA draft feed omits that block entirely, so this and the other college columns are null throughout.
team_idInt32Unique team identifier.
team_uidStringESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slugStringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_locationStringTeam city or location string.
team_nameStringFull team display name (e.g. 'Las Vegas Aces').
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
team_display_nameStringFull team display name.
team_short_display_nameStringShort team display name (e.g. 'Aces').
team_colorStringTeam primary color (hex without leading '#').
team_alternate_colorStringTeam alternate color (hex without leading '#').
team_logoStringTeam logo image URL.
load_nba_draft(seasons=2025)

load_nba_rosters

Release: espn_nba_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_rosters/rosters_{season}.parquet

Returns

col_nametypedescription
seasonInt32Season year.
team_idInt32Unique team identifier.
team_slugStringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
team_display_nameStringFull team display name.
team_short_display_nameStringShort team display name (e.g. 'Aces').
team_colorStringTeam primary color (hex without leading '#').
team_alternate_colorStringTeam alternate color (hex without leading '#').
team_logoStringTeam logo image URL.
athlete_idStringUnique athlete identifier (ESPN).
uidStringESPN UID string.
guidStringStable cross-league team GUID.
full_nameStringPlayer's full name.
display_nameStringDisplay name.
short_nameStringShort display name.
first_nameStringPlayer's first name.
last_nameStringPlayer's last name.
jerseyStringJersey number worn by the player.
position_abbreviationStringPosition abbreviation ('G' / 'F' / 'C').
position_nameStringListed roster position ('Guard', 'Forward', 'Center').
position_idStringUnique position identifier.
heightStringPlayer height (string e.g. '6-2' or inches).
weightStringPlayer weight in pounds.
ageStringPlayer age (in years).
date_of_birthStringDate of birth (YYYY-MM-DD).
birth_place_cityStringBirth place city.
birth_place_stateStringBirth place state.
birth_place_countryStringBirth place country.
experience_yearsStringExperience years.
experience_display_valueStringExperience display value.
headshot_hrefStringHeadshot image URL.
headshot_altStringAlternative-text label for the headshot.
link_webStringWeb link / URL.
status_idStringStatus identifier.
status_nameStringStatus label.
status_typeStringStatus type.
load_nba_rosters(seasons=2025)

load_nba_stats_schedules

Release: nba_stats_schedules · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_schedules/nba_schedule_{season + 1}.parquet

Returns

col_nametypedescription
game_idStringUnique game identifier.
seasonInt64Season year.
season_typeStringSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_dateStringGame date (YYYY-MM-DD).
matchupStringMatchup.
home_team_idInt64Unique identifier for the home team.
home_team_abbreviationStringHome team abbreviation; team_detail = TRUE only.
home_team_nameStringHome team name.
home_ptsInt64Final points scored by the home team.
home_wlStringHome team's result for the game (W or L).
away_team_idInt64Unique identifier for the away team.
away_team_abbreviationStringAway team abbreviation; team_detail = TRUE only.
away_team_nameStringAway team name.
away_ptsInt64Final points scored by the away team.
away_wlStringAway team's result for the game (W or L).
load_nba_stats_schedules(seasons=2025)

load_nba_stats_coaches

Release: nba_stats_coaches · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_coaches/coaches_{season + 1}.parquet

Returns

col_nametypedescription
team_idInt64Unique team identifier.
seasonInt32Season year.
coach_idInt64ESPN coach id.
first_nameStringPlayer's first name.
last_nameStringPlayer's last name.
coach_nameStringCoach's full name.
is_assistantInt64Numeric flag from the NBA Stats API distinguishing assistants from head coaches.
coach_typeStringCoach role description (e.g. "Head Coach", "Assistant Coach").
sort_sequenceInt64Sort order of the coach within the team's staff listing.
sub_sort_sequenceInt64Secondary sort order within the coach type.
season_typeStringSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
load_nba_stats_coaches(seasons=2025)

load_nba_stats_game_rosters

Release: nba_stats_game_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_game_rosters/game_rosters_{season + 1}.parquet

Returns

col_nametypedescription
player_idInt64Unique player identifier.
first_nameStringPlayer's first name.
last_nameStringPlayer's last name.
jersey_numStringJersey number worn by the player.
team_idInt64Unique team identifier.
team_cityStringTeam city or region (e.g. 'Las Vegas').
team_nameStringFull team display name (e.g. 'Las Vegas Aces').
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
seasonInt32Season year.
game_idStringUnique game identifier.
load_nba_stats_game_rosters(seasons=2025)

load_nba_stats_lineups

Release: nba_stats_lineups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_lineups/lineups_{season + 1}.parquet

Returns

col_nametypedescription
group_setStringLineup grouping label from the NBA Stats API (e.g. "Lineups").
group_idStringESPN group id.
group_nameStringGroup name (conference / division).
team_idInt64Unique team identifier.
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
gpInt64Games played.
wInt64Wins.
lInt64Losses.
w_pctFloat64Wins percentage (0-1 decimal).
minFloat64Minutes played.
e_off_ratingFloat64Estimated offensive rating (NBA Stats estimated-metrics family) over the split.
off_ratingFloat64Offensive rating (points scored per 100 possessions) over the split.
e_def_ratingFloat64Estimated defensive rating (NBA Stats estimated-metrics family) over the split.
def_ratingFloat64Defensive rating (points allowed per 100 possessions) over the split.
e_net_ratingFloat64Estimated net rating (NBA Stats estimated-metrics family) over the split.
net_ratingFloat64Net rating (off rating - def rating).
ast_pctFloat64Assist percentage.
ast_toFloat64Assist-to-turnover ratio over the split.
ast_ratioFloat64Assist ratio (assists per 100 possessions used) over the split.
oreb_pctFloat64Offensive rebound percentage over the split, as a decimal.
dreb_pctFloat64Defensive rebound percentage over the split, as a decimal.
reb_pctFloat64Total rebound percentage over the split, as a decimal.
tm_tov_pctFloat64Team turnover percentage (turnovers per 100 possessions) over the split, as a decimal.
efg_pctFloat64Effective field goal percentage over the split, as a decimal.
ts_pctFloat64True shooting percentage (0-1).
e_paceFloat64Estimated pace (NBA Stats estimated-metrics family) over the split.
paceFloat64Possessions per 48 minutes.
pace_per40Float64Pace per40.
possInt64Poss.
pieFloat64Player Impact Estimate (0-1).
gp_rankInt64League rank of the row's games played for the season and split.
w_rankInt64League rank of the row's wins for the season and split.
l_rankInt64League rank of the row's losses for the season and split.
w_pct_rankInt64League rank of the row's win percentage for the season and split.
min_rankInt64League rank of the row's minutes played for the season and split.
off_rating_rankInt64League rank of the row's offensive rating (points scored per 100 possessions) for the season and split.
def_rating_rankInt64League rank of the row's defensive rating (points allowed per 100 possessions) for the season and split.
net_rating_rankInt64League rank of the row's net rating (offensive minus defensive rating) for the season and split.
ast_pct_rankInt64League rank of the row's assist percentage (share of teammate field goals assisted while on the floor) for the season and split.
ast_to_rankInt64League rank of the row's assist-to-turnover ratio for the season and split.
ast_ratio_rankInt64League rank of the row's assist ratio (assists per 100 possessions used) for the season and split.
oreb_pct_rankInt64League rank of the row's offensive rebound percentage for the season and split.
dreb_pct_rankInt64League rank of the row's defensive rebound percentage for the season and split.
reb_pct_rankInt64League rank of the row's total rebound percentage for the season and split.
tm_tov_pct_rankInt64League rank of the row's team turnover percentage (turnovers per 100 possessions) for the season and split.
efg_pct_rankInt64League rank of the row's effective field goal percentage for the season and split.
ts_pct_rankInt64League rank of the row's true shooting percentage for the season and split.
pace_rankInt64League rank of the row's pace (possessions per 48 minutes) for the season and split.
pie_rankInt64League rank of the row's Player Impact Estimate (PIE, the NBA Stats catch-all impact metric) for the season and split.
sum_time_playedInt64Total time the five-man lineup was on the floor across the split.
seasonInt32Season year.
season_typeStringSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
measure_typeStringNBA Stats measure type the row was pulled from (e.g. Base, Advanced, Misc, Scoring, Opponent, Usage, Defense).
per_modeStringNBA Stats per-mode of the row values (e.g. Totals, PerGame, Per100Possessions).
fgmFloat64Field goals made.
fgaFloat64Field goal attempts.
fg_pctFloat64Field goal percentage (0-1).
fg3mFloat64Three-point field goals made.
fg3aFloat64Three-point field goal attempts.
fg3_pctFloat64Three-point field goal percentage (0-1).
ftmFloat64Free throws made.
ftaFloat64Free throw attempts.
ft_pctFloat64Free throw percentage (0-1).
orebFloat64Offensive rebounds.
drebFloat64Defensive rebounds.
rebFloat64Rebounds per game.
astFloat64Assists.
tovFloat64Turnovers.
stlFloat64Steals.
blkFloat64Blocks.
blkaFloat64Shot attempts blocked by opponents (blocks against).
pfFloat64Personal fouls.
pfdFloat64Personal fouls drawn.
ptsFloat64Points scored.
plus_minusFloat64Plus/minus point differential while on court.
fgm_rankInt64League rank of the row's field goals made for the season and split.
fga_rankInt64League rank of the row's field goals attempted for the season and split.
fg_pct_rankInt64League rank of the row's field goal percentage for the season and split.
fg3m_rankInt64League rank of the row's three-point field goals made for the season and split.
fg3a_rankInt64League rank of the row's three-point field goals attempted for the season and split.
fg3_pct_rankInt64League rank of the row's three-point field goal percentage for the season and split.
ftm_rankInt64League rank of the row's free throws made for the season and split.
fta_rankInt64League rank of the row's free throws attempted for the season and split.
ft_pct_rankInt64League rank of the row's free throw percentage for the season and split.
oreb_rankInt64League rank of the row's offensive rebounds for the season and split.
dreb_rankInt64League rank of the row's defensive rebounds for the season and split.
reb_rankInt64League rank of the row's total rebounds for the season and split.
ast_rankInt64League rank of the row's assists for the season and split.
tov_rankInt64League rank of the row's turnovers for the season and split.
stl_rankInt64League rank of the row's steals for the season and split.
blk_rankInt64League rank of the row's blocked shots for the season and split.
blka_rankInt64League rank of the row's shot attempts blocked by opponents (blocks against) for the season and split.
pf_rankInt64League rank of the row's personal fouls committed for the season and split.
pfd_rankInt64League rank of the row's personal fouls drawn for the season and split.
pts_rankInt64League rank of the row's points scored for the season and split.
plus_minus_rankInt64League rank of the row's plus-minus point differential while on the floor for the season and split.
pts_off_tovFloat64Points scored off opponent turnovers over the split.
pts_2nd_chanceFloat64Second-chance points over the split.
pts_fbFloat64Fast-break points over the split.
pts_paintFloat64Points in the paint over the split.
opp_pts_off_tovFloat64Opponent points scored off opponent turnovers allowed over the split.
opp_pts_2nd_chanceFloat64Opponent second-chance points allowed over the split.
opp_pts_fbFloat64Opponent fast-break points allowed over the split.
opp_pts_paintFloat64Opponent points in the paint allowed over the split.
pts_off_tov_rankInt64League rank of the row's points scored off opponent turnovers for the season and split.
pts_2nd_chance_rankInt64League rank of the row's second-chance points for the season and split.
pts_fb_rankInt64League rank of the row's fast-break points for the season and split.
pts_paint_rankInt64League rank of the row's points in the paint for the season and split.
opp_pts_off_tov_rankInt64League rank of the row's opponent points scored off opponent turnovers for the season and split.
opp_pts_2nd_chance_rankInt64League rank of the row's opponent second-chance points for the season and split.
opp_pts_fb_rankInt64League rank of the row's opponent fast-break points for the season and split.
opp_pts_paint_rankInt64League rank of the row's opponent points in the paint for the season and split.
opp_fgmFloat64Opponent field goals made allowed over the split.
opp_fgaFloat64Opponent field goals attempted allowed over the split.
opp_fg_pctFloat64Opponent field goal percentage allowed over the split.
opp_fg3mFloat64Opponent three-point field goals made allowed over the split.
opp_fg3aFloat64Opponent three-point field goals attempted allowed over the split.
opp_fg3_pctFloat64Opponent three-point field goal percentage allowed over the split.
opp_ftmFloat64Opponent free throws made allowed over the split.
opp_ftaFloat64Opponent free throws attempted allowed over the split.
opp_ft_pctFloat64Opponent free throw percentage allowed over the split.
opp_orebFloat64Opponent offensive rebounds allowed over the split.
opp_drebFloat64Opponent defensive rebounds allowed over the split.
opp_rebFloat64Opponent total rebounds allowed over the split.
opp_astFloat64Opponent assists allowed over the split.
opp_tovFloat64Opponent turnovers allowed over the split.
opp_stlFloat64Opponent steals allowed over the split.
opp_blkFloat64Opponent blocked shots allowed over the split.
opp_blkaFloat64Opponent shot attempts blocked by opponents (blocks against) allowed over the split.
opp_pfFloat64Opponent personal fouls committed allowed over the split.
opp_pfdFloat64Opponent personal fouls drawn allowed over the split.
opp_ptsFloat64Opponent points.
opp_fgm_rankInt64League rank of the row's opponent field goals made for the season and split.
opp_fga_rankInt64League rank of the row's opponent field goals attempted for the season and split.
opp_fg_pct_rankInt64League rank of the row's opponent field goal percentage for the season and split.
opp_fg3m_rankInt64League rank of the row's opponent three-point field goals made for the season and split.
opp_fg3a_rankInt64League rank of the row's opponent three-point field goals attempted for the season and split.
opp_fg3_pct_rankInt64League rank of the row's opponent three-point field goal percentage for the season and split.
opp_ftm_rankInt64League rank of the row's opponent free throws made for the season and split.
opp_fta_rankInt64League rank of the row's opponent free throws attempted for the season and split.
opp_ft_pct_rankInt64League rank of the row's opponent free throw percentage for the season and split.
opp_oreb_rankInt64League rank of the row's opponent offensive rebounds for the season and split.
opp_dreb_rankInt64League rank of the row's opponent defensive rebounds for the season and split.
opp_reb_rankInt64League rank of the row's opponent total rebounds for the season and split.
opp_ast_rankInt64League rank of the row's opponent assists for the season and split.
opp_tov_rankInt64League rank of the row's opponent turnovers for the season and split.
opp_stl_rankInt64League rank of the row's opponent steals for the season and split.
opp_blk_rankInt64League rank of the row's opponent blocked shots for the season and split.
opp_blka_rankInt64League rank of the row's opponent shot attempts blocked by opponents (blocks against) for the season and split.
opp_pf_rankInt64League rank of the row's opponent personal fouls committed for the season and split.
opp_pfd_rankInt64League rank of the row's opponent personal fouls drawn for the season and split.
opp_pts_rankInt64League rank of the row's opponent points scored for the season and split.
pct_fga_2ptFloat64Share of field goal attempts taken as two-pointers, as a decimal.
pct_fga_3ptFloat64Share of field goal attempts taken as three-pointers, as a decimal.
pct_pts_2ptFloat64Share of points scored on two-point field goals, as a decimal.
pct_pts_2pt_mrFloat64Share of points scored on mid-range two-pointers, as a decimal.
pct_pts_3ptFloat64Share of points scored on three-pointers, as a decimal.
pct_pts_fbFloat64Share of points scored on fast breaks, as a decimal.
pct_pts_ftFloat64Share of points scored at the free throw line, as a decimal.
pct_pts_off_tovFloat64Share of points scored off opponent turnovers, as a decimal.
pct_pts_paintFloat64Share of points scored in the paint, as a decimal.
pct_ast_2pmFloat64Percentage of made two-pointers that were assisted, as a decimal.
pct_uast_2pmFloat64Percentage of made two-pointers that were unassisted, as a decimal.
pct_ast_3pmFloat64Percentage of made three-pointers that were assisted, as a decimal.
pct_uast_3pmFloat64Percentage of made three-pointers that were unassisted, as a decimal.
pct_ast_fgmFloat64Percentage of made field goals that were assisted, as a decimal.
pct_uast_fgmFloat64Percentage of made field goals that were unassisted, as a decimal.
pct_fga_2pt_rankInt64League rank of the row's share of field goal attempts taken as two-pointers for the season and split.
pct_fga_3pt_rankInt64League rank of the row's share of field goal attempts taken as three-pointers for the season and split.
pct_pts_2pt_rankInt64League rank of the row's share of points scored on two-point field goals for the season and split.
pct_pts_2pt_mr_rankInt64League rank of the row's share of points scored on mid-range two-pointers for the season and split.
pct_pts_3pt_rankInt64League rank of the row's share of points scored on three-pointers for the season and split.
pct_pts_fb_rankInt64League rank of the row's share of points scored on fast breaks for the season and split.
pct_pts_ft_rankInt64League rank of the row's share of points scored at the free throw line for the season and split.
pct_pts_off_tov_rankInt64League rank of the row's share of points scored off opponent turnovers for the season and split.
pct_pts_paint_rankInt64League rank of the row's share of points scored in the paint for the season and split.
pct_ast_2pm_rankInt64League rank of the row's percentage of made two-pointers that were assisted for the season and split.
pct_uast_2pm_rankInt64League rank of the row's percentage of made two-pointers that were unassisted for the season and split.
pct_ast_3pm_rankInt64League rank of the row's percentage of made three-pointers that were assisted for the season and split.
pct_uast_3pm_rankInt64League rank of the row's percentage of made three-pointers that were unassisted for the season and split.
pct_ast_fgm_rankInt64League rank of the row's percentage of made field goals that were assisted for the season and split.
pct_uast_fgm_rankInt64League rank of the row's percentage of made field goals that were unassisted for the season and split.
load_nba_stats_lineups(seasons=2025)

load_nba_stats_lineups_v3

Release: nba_stats_game_lineups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_game_lineups/nba_lineups_{season + 1}.parquet

Returns

col_nametypedescription
game_idStringUnique game identifier.
action_numberInt64Sequential action number within a game (V3 PBP).
periodInt64Period of the game (1-4 quarters; 5+ for OT).
home_player_1Int64NBA Stats player id of the home on-court player 1 of 5 for the row.
home_player_2Int64NBA Stats player id of the home on-court player 2 of 5 for the row.
home_player_3Int64NBA Stats player id of the home on-court player 3 of 5 for the row.
home_player_4Int64NBA Stats player id of the home on-court player 4 of 5 for the row.
home_player_5Int64NBA Stats player id of the home on-court player 5 of 5 for the row.
away_player_1Int64NBA Stats player id of the away on-court player 1 of 5 for the row.
away_player_2Int64NBA Stats player id of the away on-court player 2 of 5 for the row.
away_player_3Int64NBA Stats player id of the away on-court player 3 of 5 for the row.
away_player_4Int64NBA Stats player id of the away on-court player 4 of 5 for the row.
away_player_5Int64NBA Stats player id of the away on-court player 5 of 5 for the row.
seasonInt64Season year.
load_nba_stats_lineups_v3(seasons=2025)

load_nba_stats_officials

Release: nba_stats_officials · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_officials/officials_{season + 1}.parquet

Returns

col_nametypedescription
official_idInt64Unique official / referee identifier.
first_nameStringPlayer's first name.
last_nameStringPlayer's last name.
jersey_numStringJersey number worn by the player.
seasonInt32Season year.
game_idStringUnique game identifier.
load_nba_stats_officials(seasons=2025)

load_nba_stats_pbp

Release: nba_stats_pbp · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_pbp/nba_play_by_play_{season + 1}.parquet

Returns

col_nametypedescription
order_indexInt64Stable within-game ordering index for events after pbpstats-style reordering of the raw feed.
action_numberInt64Sequential action number within a game (V3 PBP).
clockStringGame clock value.
periodInt64Period of the game (1-4 quarters; 5+ for OT).
team_idInt64Unique team identifier.
team_tricodeStringThree-letter team code (e.g. 'LAS' / 'NYL').
person_idInt64Unique player identifier (V3 endpoints).
player_nameStringPlayer name.
player_name_iStringPlayer name i.
x_legacyInt64V2-format X coordinate (preserved for V3-to-V2 compatibility).
y_legacyInt64V2-format Y coordinate (preserved for V3-to-V2 compatibility).
shot_distanceInt64Shot distance from the basket, in feet.
shot_resultStringShot result ('Made' / 'Missed').
is_field_goalInt641 if the action was a field goal; 0 otherwise.
score_homeStringScore home.
score_awayStringScore away.
points_totalInt64Running total of points scored.
locationStringLocation.
descriptionStringLong-form description text.
action_typeStringAction type label (e.g. 'Made Shot', 'Substitution').
sub_typeStringAction sub-type label.
video_availableInt64Video available.
shot_valueInt64Point value of the shot (2 or 3).
action_idInt64Unique action identifier within a game (V3 PBP).
game_idStringUnique game identifier.
seconds_remainingFloat64Seconds remaining in the period.
event_typeStringEvent / play type code (V2 PBP).
is_made_shotBooleanWhether the event is a made field goal.
is_missed_shotBooleanWhether the event is a missed field goal.
is_free_throwBooleanWhether the event is a free throw attempt.
is_reboundBooleanWhether the event is a rebound.
is_turnoverBooleanTRUE if the play was a turnover.
is_foulBooleanWhether the event is a foul.
is_substitutionBooleanWhether the event is a substitution.
is_jump_ballBooleanWhether the event is a jump ball.
is_timeoutBooleanWhether the event is a timeout.
is_periodBooleanWhether the event is a period start or end marker.
possession_numberInt64Possession number.
off_player_1Int64NBA Stats player id of offensive on-court player 1 of 5 during the event.
off_player_2Int64NBA Stats player id of offensive on-court player 2 of 5 during the event.
off_player_3Int64NBA Stats player id of offensive on-court player 3 of 5 during the event.
off_player_4Int64NBA Stats player id of offensive on-court player 4 of 5 during the event.
off_player_5Int64NBA Stats player id of offensive on-court player 5 of 5 during the event.
def_player_1Int64NBA Stats player id of defensive on-court player 1 of 5 during the event.
def_player_2Int64NBA Stats player id of defensive on-court player 2 of 5 during the event.
def_player_3Int64NBA Stats player id of defensive on-court player 3 of 5 during the event.
def_player_4Int64NBA Stats player id of defensive on-court player 4 of 5 during the event.
def_player_5Int64NBA Stats player id of defensive on-court player 5 of 5 during the event.
seasonInt64Season year.
load_nba_stats_pbp(seasons=2025)

load_nba_stats_possessions

Release: nba_stats_possessions · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_possessions/nba_possessions_{season + 1}.parquet

Returns

col_nametypedescription
game_idStringUnique game identifier.
periodInt64Period of the game (1-4 quarters; 5+ for OT).
possession_numberInt64Possession number.
offense_team_idInt64Unique identifier for offense team.
defense_team_idInt64NBA Stats team id of the defending team for the possession.
start_order_indexInt64order_index of the play-by-play event that starts the possession.
end_order_indexInt64order_index of the play-by-play event that ends the possession.
start_seconds_remainingFloat64Seconds remaining in the period when the possession started.
end_seconds_remainingFloat64Seconds remaining in the period when the possession ended.
pointsInt64Points scored.
is_second_chanceBooleanWhether the row is a second-chance continuation following an offensive rebound.
number_in_periodInt64Sequential possession number for the offense within the period.
possession_start_typeStringHow the possession began (e.g. off a made shot, defensive rebound, turnover, or period start).
count_as_possessionBooleanWhether the row counts as a true possession for per-possession rate stats.
fg2aInt64Two-point field goal attempts during the possession.
fg2mInt64Two-point field goals made during the possession.
fg3aInt64Three-point field goal attempts.
fg3mInt64Three-point field goals made.
ftaInt64Free throw attempts.
ftmInt64Free throws made.
orebInt64Offensive rebounds.
drebInt64Defensive rebounds.
tovInt64Turnovers.
off_player_1Int64NBA Stats player id of offensive on-court player 1 of 5 for the possession.
off_player_2Int64NBA Stats player id of offensive on-court player 2 of 5 for the possession.
off_player_3Int64NBA Stats player id of offensive on-court player 3 of 5 for the possession.
off_player_4Int64NBA Stats player id of offensive on-court player 4 of 5 for the possession.
off_player_5Int64NBA Stats player id of offensive on-court player 5 of 5 for the possession.
def_player_1Int64NBA Stats player id of defensive on-court player 1 of 5 for the possession.
def_player_2Int64NBA Stats player id of defensive on-court player 2 of 5 for the possession.
def_player_3Int64NBA Stats player id of defensive on-court player 3 of 5 for the possession.
def_player_4Int64NBA Stats player id of defensive on-court player 4 of 5 for the possession.
def_player_5Int64NBA Stats player id of defensive on-court player 5 of 5 for the possession.
lineup_sourceStringProvenance of the on-court lineup identification for the row (how the five-man units were resolved).
seasonInt64Season year.
load_nba_stats_possessions(seasons=2025)

load_nba_stats_game_lineups

Release: nba_stats_game_lineups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_game_lineups/nba_lineups_{season + 1}.parquet

Returns

col_nametypedescription
game_idStringUnique game identifier.
action_numberInt64Sequential action number within a game (V3 PBP).
periodInt64Period of the game (1-4 quarters; 5+ for OT).
home_player_1Int64NBA Stats player id of the home on-court player 1 of 5 for the row.
home_player_2Int64NBA Stats player id of the home on-court player 2 of 5 for the row.
home_player_3Int64NBA Stats player id of the home on-court player 3 of 5 for the row.
home_player_4Int64NBA Stats player id of the home on-court player 4 of 5 for the row.
home_player_5Int64NBA Stats player id of the home on-court player 5 of 5 for the row.
away_player_1Int64NBA Stats player id of the away on-court player 1 of 5 for the row.
away_player_2Int64NBA Stats player id of the away on-court player 2 of 5 for the row.
away_player_3Int64NBA Stats player id of the away on-court player 3 of 5 for the row.
away_player_4Int64NBA Stats player id of the away on-court player 4 of 5 for the row.
away_player_5Int64NBA Stats player id of the away on-court player 5 of 5 for the row.
seasonInt64Season year.
load_nba_stats_game_lineups(seasons=2025)

load_nba_stats_pbp_v3

Release: nba_stats_pbp · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_pbp/nba_play_by_play_{season + 1}.parquet

Returns

col_nametypedescription
order_indexInt64Stable within-game ordering index for events after pbpstats-style reordering of the raw feed.
action_numberInt64Sequential action number within a game (V3 PBP).
clockStringGame clock value.
periodInt64Period of the game (1-4 quarters; 5+ for OT).
team_idInt64Unique team identifier.
team_tricodeStringThree-letter team code (e.g. 'LAS' / 'NYL').
person_idInt64Unique player identifier (V3 endpoints).
player_nameStringPlayer name.
player_name_iStringPlayer name i.
x_legacyInt64V2-format X coordinate (preserved for V3-to-V2 compatibility).
y_legacyInt64V2-format Y coordinate (preserved for V3-to-V2 compatibility).
shot_distanceInt64Shot distance from the basket, in feet.
shot_resultStringShot result ('Made' / 'Missed').
is_field_goalInt641 if the action was a field goal; 0 otherwise.
score_homeStringScore home.
score_awayStringScore away.
points_totalInt64Running total of points scored.
locationStringLocation.
descriptionStringLong-form description text.
action_typeStringAction type label (e.g. 'Made Shot', 'Substitution').
sub_typeStringAction sub-type label.
video_availableInt64Video available.
shot_valueInt64Point value of the shot (2 or 3).
action_idInt64Unique action identifier within a game (V3 PBP).
game_idStringUnique game identifier.
seconds_remainingFloat64Seconds remaining in the period.
event_typeStringEvent / play type code (V2 PBP).
is_made_shotBooleanWhether the event is a made field goal.
is_missed_shotBooleanWhether the event is a missed field goal.
is_free_throwBooleanWhether the event is a free throw attempt.
is_reboundBooleanWhether the event is a rebound.
is_turnoverBooleanTRUE if the play was a turnover.
is_foulBooleanWhether the event is a foul.
is_substitutionBooleanWhether the event is a substitution.
is_jump_ballBooleanWhether the event is a jump ball.
is_timeoutBooleanWhether the event is a timeout.
is_periodBooleanWhether the event is a period start or end marker.
possession_numberInt64Possession number.
off_player_1Int64NBA Stats player id of offensive on-court player 1 of 5 during the event.
off_player_2Int64NBA Stats player id of offensive on-court player 2 of 5 during the event.
off_player_3Int64NBA Stats player id of offensive on-court player 3 of 5 during the event.
off_player_4Int64NBA Stats player id of offensive on-court player 4 of 5 during the event.
off_player_5Int64NBA Stats player id of offensive on-court player 5 of 5 during the event.
def_player_1Int64NBA Stats player id of defensive on-court player 1 of 5 during the event.
def_player_2Int64NBA Stats player id of defensive on-court player 2 of 5 during the event.
def_player_3Int64NBA Stats player id of defensive on-court player 3 of 5 during the event.
def_player_4Int64NBA Stats player id of defensive on-court player 4 of 5 during the event.
def_player_5Int64NBA Stats player id of defensive on-court player 5 of 5 during the event.
seasonInt64Season year.
load_nba_stats_pbp_v3(seasons=2025)

load_nba_stats_player_boxscores

Release: nba_stats_player_boxscores · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_player_boxscores/player_boxscores_{season + 1}.parquet

Returns

col_nametypedescription
team_idInt64Unique team identifier.
team_nameStringFull team display name (e.g. 'Las Vegas Aces').
team_tricodeStringThree-letter team code (e.g. 'LAS' / 'NYL').
sideStringSide label (e.g. 'home', 'away', or 'overUnder').
person_idInt64Unique player identifier (V3 endpoints).
first_nameStringPlayer's first name.
family_nameStringPlayer's family / last name.
name_iStringInitialed name (e.g. 'A. Wilson').
player_slugStringURL-safe player identifier.
positionStringListed roster position (G, F, C, etc.).
commentStringPlayer status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_numStringJersey number worn by the player.
minutesStringMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_madeInt64Field goals made (2-pt + 3-pt).
field_goals_attemptedInt64Field goal attempts (2-pt + 3-pt).
field_goals_percentageFloat64Field goal percentage (0-1 decimal).
three_pointers_madeInt64Three-point field goals made.
three_pointers_attemptedInt64Three-point field goal attempts.
three_pointers_percentageFloat64Three-point field goal percentage (0-1 decimal).
free_throws_madeInt64Free throws made.
free_throws_attemptedInt64Free throw attempts.
free_throws_percentageFloat64Free throw percentage (0-1 decimal).
rebounds_offensiveInt64Offensive rebounds.
rebounds_defensiveInt64Defensive rebounds.
rebounds_totalInt64Total rebounds.
assistsInt64Total assists.
stealsInt64Total steals.
blocksInt64Total blocks.
turnoversInt64Total turnovers.
fouls_personalInt64Personal fouls.
pointsInt64Points scored.
plus_minus_pointsFloat64Plus/minus point differential while on court.
game_idStringUnique game identifier.
seasonInt32Season year.
load_nba_stats_player_boxscores(seasons=2025)

load_nba_stats_player_game_logs

Release: nba_stats_player_game_logs · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_player_game_logs/player_game_logs_{season + 1}.parquet

Returns

col_nametypedescription
season_idStringUnique season identifier.
team_idInt64Unique team identifier.
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
team_nameStringFull team display name (e.g. 'Las Vegas Aces').
game_idStringUnique game identifier.
game_dateStringGame date (YYYY-MM-DD).
matchupStringMatchup.
wlStringWl.
minInt64Minutes played.
fgmInt64Field goals made.
fgaInt64Field goal attempts.
fg_pctFloat64Field goal percentage (0-1).
fg3mInt64Three-point field goals made.
fg3aInt64Three-point field goal attempts.
fg3_pctFloat64Three-point field goal percentage (0-1).
ftmInt64Free throws made.
ftaInt64Free throw attempts.
ft_pctFloat64Free throw percentage (0-1).
orebInt64Offensive rebounds.
drebInt64Defensive rebounds.
rebInt64Rebounds per game.
astInt64Assists.
stlInt64Steals.
blkInt64Blocks.
tovInt64Turnovers.
pfInt64Personal fouls.
ptsInt64Points scored.
plus_minusInt64Plus/minus point differential while on court.
video_availableInt64Video available.
seasonInt32Season year.
season_typeStringSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
load_nba_stats_player_game_logs(seasons=2025)

load_nba_stats_player_season_stats

Release: nba_stats_player_season_stats · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_player_season_stats/player_season_stats_{season + 1}.parquet

Returns

col_nametypedescription
player_idInt64Unique player identifier.
player_nameStringPlayer name.
nicknameStringTeam or athlete nickname.
team_idInt64Unique team identifier.
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
ageFloat64Player age (in years).
gpInt64Games played.
wInt64Wins.
lInt64Losses.
w_pctFloat64Wins percentage (0-1 decimal).
minFloat64Minutes played.
e_off_ratingFloat64Estimated offensive rating (NBA Stats estimated-metrics family) over the split.
off_ratingFloat64Offensive rating (points scored per 100 possessions) over the split.
sp_work_off_ratingFloat64Offensive rating carried in the stats API's SP_WORK column set (mirrors off_rating) over the split.
e_def_ratingFloat64Estimated defensive rating (NBA Stats estimated-metrics family) over the split.
def_ratingFloat64Defensive rating (points allowed per 100 possessions) over the split.
sp_work_def_ratingFloat64Defensive rating carried in the stats API's SP_WORK column set (mirrors def_rating) over the split.
e_net_ratingFloat64Estimated net rating (NBA Stats estimated-metrics family) over the split.
net_ratingFloat64Net rating (off rating - def rating).
sp_work_net_ratingFloat64Net rating carried in the stats API's SP_WORK column set (mirrors net_rating) over the split.
ast_pctFloat64Assist percentage.
ast_toFloat64Assist-to-turnover ratio over the split.
ast_ratioFloat64Assist ratio (assists per 100 possessions used) over the split.
oreb_pctFloat64Offensive rebound percentage over the split, as a decimal.
dreb_pctFloat64Defensive rebound percentage over the split, as a decimal.
reb_pctFloat64Total rebound percentage over the split, as a decimal.
tm_tov_pctFloat64Team turnover percentage (turnovers per 100 possessions) over the split, as a decimal.
e_tov_pctFloat64Estimated turnover percentage (NBA Stats estimated-metrics family) over the split, as a decimal.
efg_pctFloat64Effective field goal percentage over the split, as a decimal.
ts_pctFloat64True shooting percentage (0-1).
usg_pctFloat64Usage percentage (share of team plays used while on the floor) over the split, as a decimal.
e_usg_pctFloat64Estimated usage percentage (NBA Stats estimated-metrics family) over the split, as a decimal.
e_paceFloat64Estimated pace (NBA Stats estimated-metrics family) over the split.
paceFloat64Possessions per 48 minutes.
pace_per40Float64Pace per40.
sp_work_paceFloat64Pace carried in the stats API's SP_WORK column set (mirrors pace) over the split.
pieFloat64Player Impact Estimate (0-1).
possInt64Poss.
fgmFloat64Field goals made.
fgaFloat64Field goal attempts.
fgm_pgFloat64Field goals made per game over the split.
fga_pgFloat64Field goals attempted per game over the split.
fg_pctFloat64Field goal percentage (0-1).
gp_rankInt64League rank of the row's games played for the season and split.
w_rankInt64League rank of the row's wins for the season and split.
l_rankInt64League rank of the row's losses for the season and split.
w_pct_rankInt64League rank of the row's win percentage for the season and split.
min_rankInt64League rank of the row's minutes played for the season and split.
e_off_rating_rankInt64League rank of the row's estimated offensive rating (NBA Stats estimated-metrics family) for the season and split.
off_rating_rankInt64League rank of the row's offensive rating (points scored per 100 possessions) for the season and split.
sp_work_off_rating_rankInt64League rank of the row's offensive rating carried in the stats API's SP_WORK column set (mirrors off_rating) for the season and split.
e_def_rating_rankInt64League rank of the row's estimated defensive rating (NBA Stats estimated-metrics family) for the season and split.
def_rating_rankInt64League rank of the row's defensive rating (points allowed per 100 possessions) for the season and split.
sp_work_def_rating_rankInt64League rank of the row's defensive rating carried in the stats API's SP_WORK column set (mirrors def_rating) for the season and split.
e_net_rating_rankInt64League rank of the row's estimated net rating (NBA Stats estimated-metrics family) for the season and split.
net_rating_rankInt64League rank of the row's net rating (offensive minus defensive rating) for the season and split.
sp_work_net_rating_rankInt64League rank of the row's net rating carried in the stats API's SP_WORK column set (mirrors net_rating) for the season and split.
ast_pct_rankInt64League rank of the row's assist percentage (share of teammate field goals assisted while on the floor) for the season and split.
ast_to_rankInt64League rank of the row's assist-to-turnover ratio for the season and split.
ast_ratio_rankInt64League rank of the row's assist ratio (assists per 100 possessions used) for the season and split.
oreb_pct_rankInt64League rank of the row's offensive rebound percentage for the season and split.
dreb_pct_rankInt64League rank of the row's defensive rebound percentage for the season and split.
reb_pct_rankInt64League rank of the row's total rebound percentage for the season and split.
tm_tov_pct_rankInt64League rank of the row's team turnover percentage (turnovers per 100 possessions) for the season and split.
e_tov_pct_rankInt64League rank of the row's estimated turnover percentage (NBA Stats estimated-metrics family) for the season and split.
efg_pct_rankInt64League rank of the row's effective field goal percentage for the season and split.
ts_pct_rankInt64League rank of the row's true shooting percentage for the season and split.
usg_pct_rankInt64League rank of the row's usage percentage (share of team plays used while on the floor) for the season and split.
e_usg_pct_rankInt64League rank of the row's estimated usage percentage (NBA Stats estimated-metrics family) for the season and split.
e_pace_rankInt64League rank of the row's estimated pace (NBA Stats estimated-metrics family) for the season and split.
pace_rankInt64League rank of the row's pace (possessions per 48 minutes) for the season and split.
sp_work_pace_rankInt64League rank of the row's pace carried in the stats API's SP_WORK column set (mirrors pace) for the season and split.
pie_rankInt64League rank of the row's Player Impact Estimate (PIE, the NBA Stats catch-all impact metric) for the season and split.
fgm_rankInt64League rank of the row's field goals made for the season and split.
fga_rankInt64League rank of the row's field goals attempted for the season and split.
fgm_pg_rankInt64League rank of the row's field goals made per game for the season and split.
fga_pg_rankInt64League rank of the row's field goals attempted per game for the season and split.
fg_pct_rankInt64League rank of the row's field goal percentage for the season and split.
team_countInt64Number of distinct teams aggregated into the split row.
seasonInt32Season year.
season_typeStringSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
measure_typeStringNBA Stats measure type the row was pulled from (e.g. Base, Advanced, Misc, Scoring, Opponent, Usage, Defense).
per_modeStringNBA Stats per-mode of the row values (e.g. Totals, PerGame, Per100Possessions).
fg3mFloat64Three-point field goals made.
fg3aFloat64Three-point field goal attempts.
fg3_pctFloat64Three-point field goal percentage (0-1).
ftmFloat64Free throws made.
ftaFloat64Free throw attempts.
ft_pctFloat64Free throw percentage (0-1).
orebFloat64Offensive rebounds.
drebFloat64Defensive rebounds.
rebFloat64Rebounds per game.
astFloat64Assists.
tovFloat64Turnovers.
stlFloat64Steals.
blkFloat64Blocks.
blkaFloat64Shot attempts blocked by opponents (blocks against).
pfFloat64Personal fouls.
pfdFloat64Personal fouls drawn.
ptsFloat64Points scored.
plus_minusFloat64Plus/minus point differential while on court.
nba_fantasy_ptsFloat64Fantasy points under the NBA's fantasy scoring formula.
dd2Int64Double-doubles recorded over the split.
td3Int64Triple-doubles recorded over the split.
wnba_fantasy_ptsFloat64Fantasy points under the WNBA's fantasy scoring formula.
fg3m_rankInt64League rank of the row's three-point field goals made for the season and split.
fg3a_rankInt64League rank of the row's three-point field goals attempted for the season and split.
fg3_pct_rankInt64League rank of the row's three-point field goal percentage for the season and split.
ftm_rankInt64League rank of the row's free throws made for the season and split.
fta_rankInt64League rank of the row's free throws attempted for the season and split.
ft_pct_rankInt64League rank of the row's free throw percentage for the season and split.
oreb_rankInt64League rank of the row's offensive rebounds for the season and split.
dreb_rankInt64League rank of the row's defensive rebounds for the season and split.
reb_rankInt64League rank of the row's total rebounds for the season and split.
ast_rankInt64League rank of the row's assists for the season and split.
tov_rankInt64League rank of the row's turnovers for the season and split.
stl_rankInt64League rank of the row's steals for the season and split.
blk_rankInt64League rank of the row's blocked shots for the season and split.
blka_rankInt64League rank of the row's shot attempts blocked by opponents (blocks against) for the season and split.
pf_rankInt64League rank of the row's personal fouls committed for the season and split.
pfd_rankInt64League rank of the row's personal fouls drawn for the season and split.
pts_rankInt64League rank of the row's points scored for the season and split.
plus_minus_rankInt64League rank of the row's plus-minus point differential while on the floor for the season and split.
nba_fantasy_pts_rankInt64League rank of the row's NBA fantasy points (league scoring formula) for the season and split.
dd2_rankInt64League rank of the row's double-doubles for the season and split.
td3_rankInt64League rank of the row's triple-doubles for the season and split.
wnba_fantasy_pts_rankInt64League rank of the row's WNBA fantasy points (league scoring formula) for the season and split.
pct_drebFloat64Share of the team's defensive rebounds accounted for by the player while on the floor, as a decimal.
pct_stlFloat64Share of the team's steals accounted for by the player while on the floor, as a decimal.
pct_blkFloat64Share of the team's blocked shots accounted for by the player while on the floor, as a decimal.
opp_pts_off_tovFloat64Opponent points scored off opponent turnovers allowed over the split.
opp_pts_2nd_chanceFloat64Opponent second-chance points allowed over the split.
opp_pts_fbFloat64Opponent fast-break points allowed over the split.
opp_pts_paintFloat64Opponent points in the paint allowed over the split.
def_wsFloat64Defensive win shares credited to the player (NBA Stats defense dashboard metric).
def_ws_rawFloat64Unscaled (raw) defensive win shares value carried alongside def_ws by the NBA Stats API.
pct_dreb_rankInt64League rank of the row's share of the team's defensive rebounds accounted for by the player while on the floor for the season and split.
pct_stl_rankInt64League rank of the row's share of the team's steals accounted for by the player while on the floor for the season and split.
pct_blk_rankInt64League rank of the row's share of the team's blocked shots accounted for by the player while on the floor for the season and split.
opp_pts_off_tov_rankInt64League rank of the row's opponent points scored off opponent turnovers for the season and split.
opp_pts_2nd_chance_rankInt64League rank of the row's opponent second-chance points for the season and split.
opp_pts_fb_rankInt64League rank of the row's opponent fast-break points for the season and split.
opp_pts_paint_rankInt64League rank of the row's opponent points in the paint for the season and split.
def_ws_rankInt64League rank of the row's defensive win shares (NBA Stats defense dashboard metric) for the season and split.
pts_off_tovFloat64Points scored off opponent turnovers over the split.
pts_2nd_chanceFloat64Second-chance points over the split.
pts_fbFloat64Fast-break points over the split.
pts_paintFloat64Points in the paint over the split.
pts_off_tov_rankInt64League rank of the row's points scored off opponent turnovers for the season and split.
pts_2nd_chance_rankInt64League rank of the row's second-chance points for the season and split.
pts_fb_rankInt64League rank of the row's fast-break points for the season and split.
pts_paint_rankInt64League rank of the row's points in the paint for the season and split.
pct_fga_2ptFloat64Share of field goal attempts taken as two-pointers, as a decimal.
pct_fga_3ptFloat64Share of field goal attempts taken as three-pointers, as a decimal.
pct_pts_2ptFloat64Share of points scored on two-point field goals, as a decimal.
pct_pts_2pt_mrFloat64Share of points scored on mid-range two-pointers, as a decimal.
pct_pts_3ptFloat64Share of points scored on three-pointers, as a decimal.
pct_pts_fbFloat64Share of points scored on fast breaks, as a decimal.
pct_pts_ftFloat64Share of points scored at the free throw line, as a decimal.
pct_pts_off_tovFloat64Share of points scored off opponent turnovers, as a decimal.
pct_pts_paintFloat64Share of points scored in the paint, as a decimal.
pct_ast_2pmFloat64Percentage of made two-pointers that were assisted, as a decimal.
pct_uast_2pmFloat64Percentage of made two-pointers that were unassisted, as a decimal.
pct_ast_3pmFloat64Percentage of made three-pointers that were assisted, as a decimal.
pct_uast_3pmFloat64Percentage of made three-pointers that were unassisted, as a decimal.
pct_ast_fgmFloat64Percentage of made field goals that were assisted, as a decimal.
pct_uast_fgmFloat64Percentage of made field goals that were unassisted, as a decimal.
pct_fga_2pt_rankInt64League rank of the row's share of field goal attempts taken as two-pointers for the season and split.
pct_fga_3pt_rankInt64League rank of the row's share of field goal attempts taken as three-pointers for the season and split.
pct_pts_2pt_rankInt64League rank of the row's share of points scored on two-point field goals for the season and split.
pct_pts_2pt_mr_rankInt64League rank of the row's share of points scored on mid-range two-pointers for the season and split.
pct_pts_3pt_rankInt64League rank of the row's share of points scored on three-pointers for the season and split.
pct_pts_fb_rankInt64League rank of the row's share of points scored on fast breaks for the season and split.
pct_pts_ft_rankInt64League rank of the row's share of points scored at the free throw line for the season and split.
pct_pts_off_tov_rankInt64League rank of the row's share of points scored off opponent turnovers for the season and split.
pct_pts_paint_rankInt64League rank of the row's share of points scored in the paint for the season and split.
pct_ast_2pm_rankInt64League rank of the row's percentage of made two-pointers that were assisted for the season and split.
pct_uast_2pm_rankInt64League rank of the row's percentage of made two-pointers that were unassisted for the season and split.
pct_ast_3pm_rankInt64League rank of the row's percentage of made three-pointers that were assisted for the season and split.
pct_uast_3pm_rankInt64League rank of the row's percentage of made three-pointers that were unassisted for the season and split.
pct_ast_fgm_rankInt64League rank of the row's percentage of made field goals that were assisted for the season and split.
pct_uast_fgm_rankInt64League rank of the row's percentage of made field goals that were unassisted for the season and split.
pct_fgmFloat64Share of the team's field goals made accounted for by the player while on the floor, as a decimal.
pct_fgaFloat64Share of the team's field goals attempted accounted for by the player while on the floor, as a decimal.
pct_fg3mFloat64Share of the team's three-point field goals made accounted for by the player while on the floor, as a decimal.
pct_fg3aFloat64Share of the team's three-point field goals attempted accounted for by the player while on the floor, as a decimal.
pct_ftmFloat64Share of the team's free throws made accounted for by the player while on the floor, as a decimal.
pct_ftaFloat64Share of the team's free throws attempted accounted for by the player while on the floor, as a decimal.
pct_orebFloat64Share of the team's offensive rebounds accounted for by the player while on the floor, as a decimal.
pct_rebFloat64Share of the team's total rebounds accounted for by the player while on the floor, as a decimal.
pct_astFloat64Share of the team's assists accounted for by the player while on the floor, as a decimal.
pct_tovFloat64Share of the team's turnovers accounted for by the player while on the floor, as a decimal.
pct_blkaFloat64Share of the team's shot attempts blocked by opponents (blocks against) accounted for by the player while on the floor, as a decimal.
pct_pfFloat64Share of the team's personal fouls committed accounted for by the player while on the floor, as a decimal.
pct_pfdFloat64Share of the team's personal fouls drawn accounted for by the player while on the floor, as a decimal.
pct_ptsFloat64Share of the team's points scored accounted for by the player while on the floor, as a decimal.
pct_fgm_rankInt64League rank of the row's share of the team's field goals made accounted for by the player while on the floor for the season and split.
pct_fga_rankInt64League rank of the row's share of the team's field goals attempted accounted for by the player while on the floor for the season and split.
pct_fg3m_rankInt64League rank of the row's share of the team's three-point field goals made accounted for by the player while on the floor for the season and split.
pct_fg3a_rankInt64League rank of the row's share of the team's three-point field goals attempted accounted for by the player while on the floor for the season and split.
pct_ftm_rankInt64League rank of the row's share of the team's free throws made accounted for by the player while on the floor for the season and split.
pct_fta_rankInt64League rank of the row's share of the team's free throws attempted accounted for by the player while on the floor for the season and split.
pct_oreb_rankInt64League rank of the row's share of the team's offensive rebounds accounted for by the player while on the floor for the season and split.
pct_reb_rankInt64League rank of the row's share of the team's total rebounds accounted for by the player while on the floor for the season and split.
pct_ast_rankInt64League rank of the row's share of the team's assists accounted for by the player while on the floor for the season and split.
pct_tov_rankInt64League rank of the row's share of the team's turnovers accounted for by the player while on the floor for the season and split.
pct_blka_rankInt64League rank of the row's share of the team's shot attempts blocked by opponents (blocks against) accounted for by the player while on the floor for the season and split.
pct_pf_rankInt64League rank of the row's share of the team's personal fouls committed accounted for by the player while on the floor for the season and split.
pct_pfd_rankInt64League rank of the row's share of the team's personal fouls drawn accounted for by the player while on the floor for the season and split.
pct_pts_rankInt64League rank of the row's share of the team's points scored accounted for by the player while on the floor for the season and split.
load_nba_stats_player_season_stats(seasons=2025)

load_nba_stats_possessions_v3

Release: nba_stats_possessions · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_possessions/nba_possessions_{season + 1}.parquet

Returns

col_nametypedescription
game_idStringUnique game identifier.
periodInt64Period of the game (1-4 quarters; 5+ for OT).
possession_numberInt64Possession number.
offense_team_idInt64Unique identifier for offense team.
defense_team_idInt64NBA Stats team id of the defending team for the possession.
start_order_indexInt64order_index of the play-by-play event that starts the possession.
end_order_indexInt64order_index of the play-by-play event that ends the possession.
start_seconds_remainingFloat64Seconds remaining in the period when the possession started.
end_seconds_remainingFloat64Seconds remaining in the period when the possession ended.
pointsInt64Points scored.
is_second_chanceBooleanWhether the row is a second-chance continuation following an offensive rebound.
number_in_periodInt64Sequential possession number for the offense within the period.
possession_start_typeStringHow the possession began (e.g. off a made shot, defensive rebound, turnover, or period start).
count_as_possessionBooleanWhether the row counts as a true possession for per-possession rate stats.
fg2aInt64Two-point field goal attempts during the possession.
fg2mInt64Two-point field goals made during the possession.
fg3aInt64Three-point field goal attempts.
fg3mInt64Three-point field goals made.
ftaInt64Free throw attempts.
ftmInt64Free throws made.
orebInt64Offensive rebounds.
drebInt64Defensive rebounds.
tovInt64Turnovers.
off_player_1Int64NBA Stats player id of offensive on-court player 1 of 5 for the possession.
off_player_2Int64NBA Stats player id of offensive on-court player 2 of 5 for the possession.
off_player_3Int64NBA Stats player id of offensive on-court player 3 of 5 for the possession.
off_player_4Int64NBA Stats player id of offensive on-court player 4 of 5 for the possession.
off_player_5Int64NBA Stats player id of offensive on-court player 5 of 5 for the possession.
def_player_1Int64NBA Stats player id of defensive on-court player 1 of 5 for the possession.
def_player_2Int64NBA Stats player id of defensive on-court player 2 of 5 for the possession.
def_player_3Int64NBA Stats player id of defensive on-court player 3 of 5 for the possession.
def_player_4Int64NBA Stats player id of defensive on-court player 4 of 5 for the possession.
def_player_5Int64NBA Stats player id of defensive on-court player 5 of 5 for the possession.
lineup_sourceStringProvenance of the on-court lineup identification for the row (how the five-man units were resolved).
seasonInt64Season year.
load_nba_stats_possessions_v3(seasons=2025)

load_nba_stats_rosters

Release: nba_stats_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_rosters/rosters_{season + 1}.parquet

Returns

col_nametypedescription
team_idInt64Unique team identifier.
seasonInt32Season year.
league_idStringLeague identifier ('10' = WNBA).
playerStringPlayer name.
nicknameStringTeam or athlete nickname.
player_slugStringURL-safe player identifier.
numStringJersey number worn by the player.
positionStringListed roster position (G, F, C, etc.).
heightStringPlayer height (string e.g. '6-2' or inches).
weightStringPlayer weight in pounds.
birth_dateStringDate of birth (YYYY-MM-DD).
ageFloat64Player age (in years).
expStringYears of NBA playing experience entering the season ('R' = rookie).
schoolStringPlayer school / pre-draft team.
player_idInt64Unique player identifier.
how_acquiredStringHow the team acquired the player (e.g. draft, trade, free agency).
season_typeStringSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
load_nba_stats_rosters(seasons=2025)

load_nba_stats_shots

Release: nba_stats_shots · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_shots/shots_{season + 1}.parquet

Returns

col_nametypedescription
game_idStringUnique game identifier.
seasonInt32Season year.
periodInt64Period of the game (1-4 quarters; 5+ for OT).
clockStringGame clock value.
team_idInt64Unique team identifier.
team_tricodeStringThree-letter team code (e.g. 'LAS' / 'NYL').
person_idInt64Unique player identifier (V3 endpoints).
player_nameStringPlayer name.
action_typeStringAction type label (e.g. 'Made Shot', 'Substitution').
sub_typeStringAction sub-type label.
shot_resultStringShot result ('Made' / 'Missed').
shot_valueInt64Point value of the shot (2 or 3).
shot_distanceInt64Shot distance from the basket, in feet.
x_legacyInt64V2-format X coordinate (preserved for V3-to-V2 compatibility).
y_legacyInt64V2-format Y coordinate (preserved for V3-to-V2 compatibility).
descriptionStringLong-form description text.
score_homeStringScore home.
score_awayStringScore away.
load_nba_stats_shots(seasons=2025)

load_nba_stats_standings

Release: nba_stats_standings · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_standings/standings_{season + 1}.parquet

Returns

col_nametypedescription
league_idStringLeague identifier ('10' = WNBA).
season_idStringUnique season identifier.
team_idInt64Unique team identifier.
team_cityStringTeam city or region (e.g. 'Las Vegas').
team_nameStringFull team display name (e.g. 'Las Vegas Aces').
team_slugStringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
conferenceStringConference name.
conference_recordStringConference win-loss record.
playoff_rankInt64League/season rank for playoff.
clinch_indicatorStringPlayoff clinch indicator (e.g. 'x' clinched playoff, 'e' eliminated).
divisionStringTeam division.
division_recordStringWin-loss record against division opponents.
division_rankInt64Team's rank within its division.
winsInt64Total wins.
lossesInt64Total losses.
win_pctFloat64Win percentage (0-1 decimal).
league_rankInt64Team's rank in the overall league standings.
recordStringOverall win-loss record.
homeStringHome.
roadStringRoad.
l10StringLast-ten record.
last10_homeStringWin-loss record over the team's last 10 home games.
last10_roadStringWin-loss record over the team's last 10 road games.
otStringOt.
three_pts_or_lessStringWin-loss record in games decided by three points or fewer.
ten_pts_or_moreStringWin-loss record in games decided by ten points or more.
long_home_streakInt64Longest home streak of the season (positive counts wins, negative losses).
str_long_home_streakStringLongest home streak of the season as display text (e.g. "W 5").
long_road_streakInt64Longest road streak of the season (positive counts wins, negative losses).
str_long_road_streakStringLongest road streak of the season as display text (e.g. "W 5").
long_win_streakInt64Longest winning streak of the season, in games.
long_loss_streakInt64Longest losing streak of the season, in games.
current_home_streakInt64Current home streak (positive counts wins, negative losses).
str_current_home_streakStringCurrent home streak as display text (e.g. "L 2").
current_road_streakInt64Current road streak (positive counts wins, negative losses).
str_current_road_streakStringCurrent road streak as display text (e.g. "W 3").
current_streakInt64Current overall streak (positive counts wins, negative losses).
str_current_streakStringCurrent overall streak as display text (e.g. "W 4").
conference_games_backFloat64Games behind the conference leader.
division_games_backFloat64Games behind the division leader.
clinched_conference_titleInt64Flag (1/0) for whether the team has clinched the conference title.
clinched_division_titleInt64Flag (1/0) for whether the team has clinched its division.
clinched_playoff_birthInt64Flag (1/0) for whether the team has clinched a playoff berth.
clinched_play_inInt64Flag (1/0) for whether the team has clinched a play-in tournament spot.
eliminated_conferenceInt64Flag (1/0) for whether the team is eliminated from conference contention.
eliminated_divisionInt64Flag (1/0) for whether the team is eliminated from division contention.
ahead_at_halfStringWin-loss record when leading at halftime.
behind_at_halfStringWin-loss record when trailing at halftime.
tied_at_halfStringWin-loss record when tied at halftime.
ahead_at_thirdStringWin-loss record when leading after three quarters.
behind_at_thirdStringWin-loss record when trailing after three quarters.
tied_at_thirdStringWin-loss record when tied after three quarters.
score100_ptsStringWin-loss record when scoring 100 or more points.
opp_score100_ptsStringWin-loss record when the opponent scores 100 or more points.
opp_over500StringWin-loss record against teams with winning (over .500) records.
lead_in_fgpctStringWin-loss record when posting the higher field goal percentage.
lead_in_rebStringWin-loss record when out-rebounding the opponent.
fewer_turnoversStringWin-loss record when committing fewer turnovers than the opponent.
points_pgFloat64Points pg.
opp_points_pgFloat64Opponent points pg.
diff_points_pgFloat64Diff points pg.
vs_eastStringWin-loss record against Eastern Conference opponents.
vs_atlanticStringWin-loss record against Atlantic Division opponents.
vs_centralStringWin-loss record against Central Division opponents.
vs_southeastStringWin-loss record against Southeast Division opponents.
vs_westStringWin-loss record against Western Conference opponents.
vs_northwestStringWin-loss record against Northwest Division opponents.
vs_pacificStringWin-loss record against Pacific Division opponents.
vs_southwestStringWin-loss record against Southwest Division opponents.
janStringWin-loss record in games played in January.
febStringWin-loss record in games played in February.
marStringWin-loss record in games played in March.
aprStringWin-loss record in games played in April.
mayNullWin-loss record in games played in May.
junNullWin-loss record in games played in June.
julNullWin-loss record in games played in July.
augNullWin-loss record in games played in August.
sepNullWin-loss record in games played in September.
octStringWin-loss record in games played in October.
novStringWin-loss record in games played in November.
decStringWin-loss record in games played in December.
score_80_plusStringWin-loss record when scoring 80 or more points.
opp_score_80_plusStringWin-loss record when the opponent scores 80 or more points.
score_below_80StringWin-loss record when scoring fewer than 80 points.
opp_score_below_80StringWin-loss record when holding the opponent below 80 points.
total_pointsInt64Total points scored by the team over the season to date.
opp_total_pointsInt64Total points allowed by the team over the season to date.
diff_total_pointsInt64Season point differential (points scored minus points allowed).
league_games_backFloat64Games behind the overall league leader.
playoff_seedingInt64Team's current playoff seed.
clinched_post_seasonInt64Flag (1/0) for whether the team has clinched any postseason berth.
neutralStringNeutral.
seasonInt32Season year.
season_typeStringSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
load_nba_stats_standings(seasons=2025)

load_nba_stats_team_boxscores

Release: nba_stats_team_boxscores · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_team_boxscores/team_boxscores_{season + 1}.parquet

Returns

col_nametypedescription
team_idInt64Unique team identifier.
team_nameStringFull team display name (e.g. 'Las Vegas Aces').
team_tricodeStringThree-letter team code (e.g. 'LAS' / 'NYL').
sideStringSide label (e.g. 'home', 'away', or 'overUnder').
minutesStringMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_madeInt64Field goals made (2-pt + 3-pt).
field_goals_attemptedInt64Field goal attempts (2-pt + 3-pt).
field_goals_percentageFloat64Field goal percentage (0-1 decimal).
three_pointers_madeInt64Three-point field goals made.
three_pointers_attemptedInt64Three-point field goal attempts.
three_pointers_percentageFloat64Three-point field goal percentage (0-1 decimal).
free_throws_madeInt64Free throws made.
free_throws_attemptedInt64Free throw attempts.
free_throws_percentageFloat64Free throw percentage (0-1 decimal).
rebounds_offensiveInt64Offensive rebounds.
rebounds_defensiveInt64Defensive rebounds.
rebounds_totalInt64Total rebounds.
assistsInt64Total assists.
stealsInt64Total steals.
blocksInt64Total blocks.
turnoversInt64Total turnovers.
fouls_personalInt64Personal fouls.
pointsInt64Points scored.
plus_minus_pointsFloat64Plus/minus point differential while on court.
game_idStringUnique game identifier.
seasonInt32Season year.
load_nba_stats_team_boxscores(seasons=2025)

load_nba_stats_team_season_stats

Release: nba_stats_team_season_stats · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_stats_team_season_stats/team_season_stats_{season + 1}.parquet

Returns

col_nametypedescription
team_idInt64Unique team identifier.
team_nameStringFull team display name (e.g. 'Las Vegas Aces').
gpInt64Games played.
wInt64Wins.
lInt64Losses.
w_pctFloat64Wins percentage (0-1 decimal).
minFloat64Minutes played.
e_off_ratingFloat64Estimated offensive rating (NBA Stats estimated-metrics family) over the split.
off_ratingFloat64Offensive rating (points scored per 100 possessions) over the split.
e_def_ratingFloat64Estimated defensive rating (NBA Stats estimated-metrics family) over the split.
def_ratingFloat64Defensive rating (points allowed per 100 possessions) over the split.
e_net_ratingFloat64Estimated net rating (NBA Stats estimated-metrics family) over the split.
net_ratingFloat64Net rating (off rating - def rating).
ast_pctFloat64Assist percentage.
ast_toFloat64Assist-to-turnover ratio over the split.
ast_ratioFloat64Assist ratio (assists per 100 possessions used) over the split.
oreb_pctFloat64Offensive rebound percentage over the split, as a decimal.
dreb_pctFloat64Defensive rebound percentage over the split, as a decimal.
reb_pctFloat64Total rebound percentage over the split, as a decimal.
tm_tov_pctFloat64Team turnover percentage (turnovers per 100 possessions) over the split, as a decimal.
efg_pctFloat64Effective field goal percentage over the split, as a decimal.
ts_pctFloat64True shooting percentage (0-1).
e_paceFloat64Estimated pace (NBA Stats estimated-metrics family) over the split.
paceFloat64Possessions per 48 minutes.
pace_per40Float64Pace per40.
possInt64Poss.
pieFloat64Player Impact Estimate (0-1).
gp_rankInt64League rank of the row's games played for the season and split.
w_rankInt64League rank of the row's wins for the season and split.
l_rankInt64League rank of the row's losses for the season and split.
w_pct_rankInt64League rank of the row's win percentage for the season and split.
min_rankInt64League rank of the row's minutes played for the season and split.
off_rating_rankInt64League rank of the row's offensive rating (points scored per 100 possessions) for the season and split.
def_rating_rankInt64League rank of the row's defensive rating (points allowed per 100 possessions) for the season and split.
net_rating_rankInt64League rank of the row's net rating (offensive minus defensive rating) for the season and split.
ast_pct_rankInt64League rank of the row's assist percentage (share of teammate field goals assisted while on the floor) for the season and split.
ast_to_rankInt64League rank of the row's assist-to-turnover ratio for the season and split.
ast_ratio_rankInt64League rank of the row's assist ratio (assists per 100 possessions used) for the season and split.
oreb_pct_rankInt64League rank of the row's offensive rebound percentage for the season and split.
dreb_pct_rankInt64League rank of the row's defensive rebound percentage for the season and split.
reb_pct_rankInt64League rank of the row's total rebound percentage for the season and split.
tm_tov_pct_rankInt64League rank of the row's team turnover percentage (turnovers per 100 possessions) for the season and split.
efg_pct_rankInt64League rank of the row's effective field goal percentage for the season and split.
ts_pct_rankInt64League rank of the row's true shooting percentage for the season and split.
pace_rankInt64League rank of the row's pace (possessions per 48 minutes) for the season and split.
pie_rankInt64League rank of the row's Player Impact Estimate (PIE, the NBA Stats catch-all impact metric) for the season and split.
seasonInt32Season year.
season_typeStringSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
measure_typeStringNBA Stats measure type the row was pulled from (e.g. Base, Advanced, Misc, Scoring, Opponent, Usage, Defense).
per_modeStringNBA Stats per-mode of the row values (e.g. Totals, PerGame, Per100Possessions).
fgmFloat64Field goals made.
fgaFloat64Field goal attempts.
fg_pctFloat64Field goal percentage (0-1).
fg3mFloat64Three-point field goals made.
fg3aFloat64Three-point field goal attempts.
fg3_pctFloat64Three-point field goal percentage (0-1).
ftmFloat64Free throws made.
ftaFloat64Free throw attempts.
ft_pctFloat64Free throw percentage (0-1).
orebFloat64Offensive rebounds.
drebFloat64Defensive rebounds.
rebFloat64Rebounds per game.
astFloat64Assists.
tovFloat64Turnovers.
stlFloat64Steals.
blkFloat64Blocks.
blkaFloat64Shot attempts blocked by opponents (blocks against).
pfFloat64Personal fouls.
pfdFloat64Personal fouls drawn.
ptsFloat64Points scored.
plus_minusFloat64Plus/minus point differential while on court.
fgm_rankInt64League rank of the row's field goals made for the season and split.
fga_rankInt64League rank of the row's field goals attempted for the season and split.
fg_pct_rankInt64League rank of the row's field goal percentage for the season and split.
fg3m_rankInt64League rank of the row's three-point field goals made for the season and split.
fg3a_rankInt64League rank of the row's three-point field goals attempted for the season and split.
fg3_pct_rankInt64League rank of the row's three-point field goal percentage for the season and split.
ftm_rankInt64League rank of the row's free throws made for the season and split.
fta_rankInt64League rank of the row's free throws attempted for the season and split.
ft_pct_rankInt64League rank of the row's free throw percentage for the season and split.
oreb_rankInt64League rank of the row's offensive rebounds for the season and split.
dreb_rankInt64League rank of the row's defensive rebounds for the season and split.
reb_rankInt64League rank of the row's total rebounds for the season and split.
ast_rankInt64League rank of the row's assists for the season and split.
tov_rankInt64League rank of the row's turnovers for the season and split.
stl_rankInt64League rank of the row's steals for the season and split.
blk_rankInt64League rank of the row's blocked shots for the season and split.
blka_rankInt64League rank of the row's shot attempts blocked by opponents (blocks against) for the season and split.
pf_rankInt64League rank of the row's personal fouls committed for the season and split.
pfd_rankInt64League rank of the row's personal fouls drawn for the season and split.
pts_rankInt64League rank of the row's points scored for the season and split.
plus_minus_rankInt64League rank of the row's plus-minus point differential while on the floor for the season and split.
opp_pts_off_tovFloat64Opponent points scored off opponent turnovers allowed over the split.
opp_pts_2nd_chanceFloat64Opponent second-chance points allowed over the split.
opp_pts_fbFloat64Opponent fast-break points allowed over the split.
opp_pts_paintFloat64Opponent points in the paint allowed over the split.
opp_pts_off_tov_rankInt64League rank of the row's opponent points scored off opponent turnovers for the season and split.
opp_pts_2nd_chance_rankInt64League rank of the row's opponent second-chance points for the season and split.
opp_pts_fb_rankInt64League rank of the row's opponent fast-break points for the season and split.
opp_pts_paint_rankInt64League rank of the row's opponent points in the paint for the season and split.
pts_off_tovFloat64Points scored off opponent turnovers over the split.
pts_2nd_chanceFloat64Second-chance points over the split.
pts_fbFloat64Fast-break points over the split.
pts_paintFloat64Points in the paint over the split.
pts_off_tov_rankInt64League rank of the row's points scored off opponent turnovers for the season and split.
pts_2nd_chance_rankInt64League rank of the row's second-chance points for the season and split.
pts_fb_rankInt64League rank of the row's fast-break points for the season and split.
pts_paint_rankInt64League rank of the row's points in the paint for the season and split.
opp_fgmFloat64Opponent field goals made allowed over the split.
opp_fgaFloat64Opponent field goals attempted allowed over the split.
opp_fg_pctFloat64Opponent field goal percentage allowed over the split.
opp_fg3mFloat64Opponent three-point field goals made allowed over the split.
opp_fg3aFloat64Opponent three-point field goals attempted allowed over the split.
opp_fg3_pctFloat64Opponent three-point field goal percentage allowed over the split.
opp_ftmFloat64Opponent free throws made allowed over the split.
opp_ftaFloat64Opponent free throws attempted allowed over the split.
opp_ft_pctFloat64Opponent free throw percentage allowed over the split.
opp_orebFloat64Opponent offensive rebounds allowed over the split.
opp_drebFloat64Opponent defensive rebounds allowed over the split.
opp_rebFloat64Opponent total rebounds allowed over the split.
opp_astFloat64Opponent assists allowed over the split.
opp_tovFloat64Opponent turnovers allowed over the split.
opp_stlFloat64Opponent steals allowed over the split.
opp_blkFloat64Opponent blocked shots allowed over the split.
opp_blkaFloat64Opponent shot attempts blocked by opponents (blocks against) allowed over the split.
opp_pfFloat64Opponent personal fouls committed allowed over the split.
opp_pfdFloat64Opponent personal fouls drawn allowed over the split.
opp_ptsFloat64Opponent points.
opp_fgm_rankInt64League rank of the row's opponent field goals made for the season and split.
opp_fga_rankInt64League rank of the row's opponent field goals attempted for the season and split.
opp_fg_pct_rankInt64League rank of the row's opponent field goal percentage for the season and split.
opp_fg3m_rankInt64League rank of the row's opponent three-point field goals made for the season and split.
opp_fg3a_rankInt64League rank of the row's opponent three-point field goals attempted for the season and split.
opp_fg3_pct_rankInt64League rank of the row's opponent three-point field goal percentage for the season and split.
opp_ftm_rankInt64League rank of the row's opponent free throws made for the season and split.
opp_fta_rankInt64League rank of the row's opponent free throws attempted for the season and split.
opp_ft_pct_rankInt64League rank of the row's opponent free throw percentage for the season and split.
opp_oreb_rankInt64League rank of the row's opponent offensive rebounds for the season and split.
opp_dreb_rankInt64League rank of the row's opponent defensive rebounds for the season and split.
opp_reb_rankInt64League rank of the row's opponent total rebounds for the season and split.
opp_ast_rankInt64League rank of the row's opponent assists for the season and split.
opp_tov_rankInt64League rank of the row's opponent turnovers for the season and split.
opp_stl_rankInt64League rank of the row's opponent steals for the season and split.
opp_blk_rankInt64League rank of the row's opponent blocked shots for the season and split.
opp_blka_rankInt64League rank of the row's opponent shot attempts blocked by opponents (blocks against) for the season and split.
opp_pf_rankInt64League rank of the row's opponent personal fouls committed for the season and split.
opp_pfd_rankInt64League rank of the row's opponent personal fouls drawn for the season and split.
opp_pts_rankInt64League rank of the row's opponent points scored for the season and split.
pct_fga_2ptFloat64Share of field goal attempts taken as two-pointers, as a decimal.
pct_fga_3ptFloat64Share of field goal attempts taken as three-pointers, as a decimal.
pct_pts_2ptFloat64Share of points scored on two-point field goals, as a decimal.
pct_pts_2pt_mrFloat64Share of points scored on mid-range two-pointers, as a decimal.
pct_pts_3ptFloat64Share of points scored on three-pointers, as a decimal.
pct_pts_fbFloat64Share of points scored on fast breaks, as a decimal.
pct_pts_ftFloat64Share of points scored at the free throw line, as a decimal.
pct_pts_off_tovFloat64Share of points scored off opponent turnovers, as a decimal.
pct_pts_paintFloat64Share of points scored in the paint, as a decimal.
pct_ast_2pmFloat64Percentage of made two-pointers that were assisted, as a decimal.
pct_uast_2pmFloat64Percentage of made two-pointers that were unassisted, as a decimal.
pct_ast_3pmFloat64Percentage of made three-pointers that were assisted, as a decimal.
pct_uast_3pmFloat64Percentage of made three-pointers that were unassisted, as a decimal.
pct_ast_fgmFloat64Percentage of made field goals that were assisted, as a decimal.
pct_uast_fgmFloat64Percentage of made field goals that were unassisted, as a decimal.
pct_fga_2pt_rankInt64League rank of the row's share of field goal attempts taken as two-pointers for the season and split.
pct_fga_3pt_rankInt64League rank of the row's share of field goal attempts taken as three-pointers for the season and split.
pct_pts_2pt_rankInt64League rank of the row's share of points scored on two-point field goals for the season and split.
pct_pts_2pt_mr_rankInt64League rank of the row's share of points scored on mid-range two-pointers for the season and split.
pct_pts_3pt_rankInt64League rank of the row's share of points scored on three-pointers for the season and split.
pct_pts_fb_rankInt64League rank of the row's share of points scored on fast breaks for the season and split.
pct_pts_ft_rankInt64League rank of the row's share of points scored at the free throw line for the season and split.
pct_pts_off_tov_rankInt64League rank of the row's share of points scored off opponent turnovers for the season and split.
pct_pts_paint_rankInt64League rank of the row's share of points scored in the paint for the season and split.
pct_ast_2pm_rankInt64League rank of the row's percentage of made two-pointers that were assisted for the season and split.
pct_uast_2pm_rankInt64League rank of the row's percentage of made two-pointers that were unassisted for the season and split.
pct_ast_3pm_rankInt64League rank of the row's percentage of made three-pointers that were assisted for the season and split.
pct_uast_3pm_rankInt64League rank of the row's percentage of made three-pointers that were unassisted for the season and split.
pct_ast_fgm_rankInt64League rank of the row's percentage of made field goals that were assisted for the season and split.
pct_uast_fgm_rankInt64League rank of the row's percentage of made field goals that were unassisted for the season and split.
load_nba_stats_team_season_stats(seasons=2025)

load_nba_player_crosswalk

Release: nba_crosswalk · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_crosswalk/nba_player_crosswalk_{season}.parquet

Returns

col_nametypedescription
seasonInt32Season year.
espn_team_idInt32ESPN team id (canonical key).
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
player_nameStringPlayer name.
espn_athlete_idStringESPN athlete id.
espn_full_nameStringESPN full name.
espn_jerseyStringESPN jersey number.
espn_positionStringESPN position abbreviation.
nba_player_idStringNBA Stats player id side of the ESPN-to-NBA player crosswalk.
nba_player_nameStringPlayer name as listed by the NBA Stats API.
nba_jersey_numStringPlayer's jersey number as listed by the NBA Stats API.
nba_positionStringPlayer's position as listed by the NBA Stats API.
fox_athlete_idStringFox athlete id (NA if unmatched).
fox_playerStringFox player name (NA if unmatched).
fox_jerseyStringFox jersey number (NA if unmatched).
fox_position_groupStringFox position group label (NA if unmatched).
yahoo_player_idStringYahoo player id (NA placeholder).
yahoo_player_nameStringYahoo player name (NA placeholder).
match_methodStringCombination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only".
match_confidenceFloat64Jaro-Winkler score or 1 for exact (NA if none).
match_keysStringNA (reserved for future use).
load_nba_player_crosswalk(seasons=2026)

load_nba_schedule_crosswalk

Release: nba_crosswalk · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_crosswalk/nba_schedule_crosswalk_{season}.parquet

Returns

col_nametypedescription
seasonInt32Season year.
season_typeStringSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_dateDateGame date (YYYY-MM-DD).
home_espn_team_idInt32ESPN home team id (NA for bart-only rows).
away_espn_team_idInt32ESPN away team id (NA for bart-only rows).
espn_game_idStringESPN game id (NA for bart-only rows).
nba_game_idStringNBA Stats 10-character game id matched to the ESPN game in the crosswalk.
nba_game_codeStringNBA game code (date and matchup string) from the NBA Stats API.
nba_home_team_idStringNBA Stats team id of the home team.
nba_away_team_idStringNBA Stats team id of the away team.
fox_game_idStringFox game id (NA placeholder).
fox_home_team_idStringFOX Sports team id of the home team in the crosswalk.
fox_away_team_idStringFOX Sports team id of the away team in the crosswalk.
yahoo_game_idStringYahoo game id (NA placeholder).
match_methodStringCombination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only".
match_confidenceFloat64Jaro-Winkler score or 1 for exact (NA if none).
load_nba_schedule_crosswalk(seasons=2026)

load_nba_team_crosswalk

Release: nba_crosswalk · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_crosswalk/nba_team_crosswalk_{season}.parquet

Returns

col_nametypedescription
seasonInt32Season year.
espn_team_idInt32ESPN team id (canonical key).
espn_abbreviationStringESPN abbreviation.
espn_display_nameStringESPN display name (school + mascot).
espn_short_nameStringESPN short name.
espn_locationStringESPN school/location only.
espn_mascotStringESPN mascot/nickname.
nba_team_idStringNBA Stats team id side of the ESPN-to-NBA team crosswalk.
nba_team_abbreviationStringTeam abbreviation as listed by the NBA Stats API.
nba_team_nameStringTeam nickname as listed by the NBA Stats API.
nba_team_cityStringTeam city as listed by the NBA Stats API.
nba_team_slugStringURL-friendly slug for the team's name on NBA Stats.
nba_conferenceStringTeam's conference as listed by the NBA Stats API.
nba_divisionStringTeam's division as listed by the NBA Stats API.
fox_team_idStringFox Bifrost team id (NA if unmatched).
fox_team_nameStringFox team name (NA if unmatched).
yahoo_team_idStringYahoo team id (NA placeholder).
yahoo_team_abbreviationStringYahoo abbreviation (NA placeholder).
yahoo_team_nameStringYahoo team name (NA placeholder).
match_methodStringCombination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only".
match_confidenceFloat64Jaro-Winkler score or 1 for exact (NA if none).
load_nba_team_crosswalk(seasons=2026)

load_nba_player_core

Release: espn_nba_player_core · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_player_core/player_core_{season}.parquet

Returns

col_nametypedescription
seasonInt32Season year.
athlete_idInt64Unique athlete identifier (ESPN).
guidStringStable cross-league team GUID.
uidStringESPN UID string.
slugStringURL-safe identifier.
typeStringRecord type / category.
first_nameStringPlayer's first name.
last_nameStringPlayer's last name.
full_nameStringPlayer's full name.
display_nameStringDisplay name.
short_nameStringShort display name.
heightFloat64Player height (string e.g. '6-2' or inches).
display_heightStringPlayer height in display format (e.g. '6-2').
weightFloat64Player weight in pounds.
display_weightStringPlayer weight in display format (e.g. '180 lbs').
ageInt32Player age (in years).
date_of_birthStringDate of birth (YYYY-MM-DD).
birth_cityStringBirth city.
birth_stateStringBirth state / region.
birth_countryStringPlayer birth country.
jerseyStringJersey number worn by the player.
position_idInt32Unique position identifier.
position_nameStringListed roster position ('Guard', 'Forward', 'Center').
position_abbreviationStringPosition abbreviation ('G' / 'F' / 'C').
position_display_nameStringPosition display name.
college_idInt32Unique identifier for college.
current_team_idInt32Player's current team identifier.
headshot_hrefStringHeadshot image URL.
experience_yearsInt32Experience years.
status_idInt32Status identifier.
status_nameStringStatus label.
status_typeStringStatus type.
draft_yearInt32Draft year (4-digit).
draft_roundInt32Round of the draft selection.
draft_selectionInt32Draft selection.
activeBooleanTRUE if the row represents an active record (player / team / season).
load_nba_player_core(seasons=2025)

load_nba_player_impact

Release: nba_player_impact · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_player_impact/nba_player_impact_{season}.parquet

Returns

col_nametypedescription
player_idInt64Unique player identifier.
player_nameStringPlayer name.
team_idInt64Unique team identifier.
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
team_nameStringFull team display name (e.g. 'Las Vegas Aces').
teamsStringNested list of member-team membership spans.
seasonInt64Season year.
season_typeStringSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
o_rapmFloat64Offensive regularized adjusted plus-minus per 100 possessions from the single-season ridge fit over possession-level lineup indicators; positive means the player raised his team's scoring rate while on offense.
d_rapmFloat64Defensive regularized adjusted plus-minus per 100 possessions, negated from the raw points-allowed coefficient so a positive value marks a defender who suppresses opponent scoring.
rapmFloat64Total regularized adjusted plus-minus per 100 possessions, exactly the sum of o_rapm and d_rapm.
off_possInt64Number of possessions the player was on the floor on offense, the count of design-matrix rows carrying his offensive indicator and therefore the offensive-side sample size behind o_rapm.
def_possInt64Number of possessions the player was on the floor on defense, the sample size behind d_rapm; it tracks off_poss almost exactly because substitutions rarely split an offense-defense pair.
o_adj_rapmFloat64Offensive regularized adjusted plus/minus after the ridge opponent adjustment.
d_adj_rapmFloat64Defensive regularized adjusted plus/minus after the ridge opponent adjustment.
adj_rapmFloat64Total prior-informed RAPM per 100 possessions, exactly the sum of o_adj_rapm and d_adj_rapm.
ospmFloat64Offensive statistical plus-minus per 100 possessions: the player's per-100 box-score feature vector scored through ridge coefficients trained on that season's o_rapm target.
dspmFloat64Defensive statistical plus-minus per 100 possessions from the same box-score feature vector scored through coefficients trained on the d_rapm target.
spmFloat64Total statistical plus-minus per 100 possessions, exactly the sum of ospm and dspm.
minFloat64Minutes played.
gpInt64Games played.
obpmFloat64Offensive box plus/minus.
dbpmFloat64Defensive box plus/minus.
bpmFloat64Career box plus/minus.
warFloat64Wins above replacement, computed as (rapm minus a replacement level of -2.0 per 100) times total possessions divided by 100, divided by a points-per-win constant calibrated each season by regressing team wins on full-season point margin.
darko_filtered_skillFloat64DARKO-style Kalman-filtered skill estimate at the end of the player's observed multi-season RAPM panel, i.e. his current-form rating after aging drift and possession-weighted observation noise.
darko_projected_ratingFloat64One-season-ahead DARKO forecast, the filtered skill plus the empirical aging-curve drift at the player's last observed age; both season_type rows of a player-season carry the same value because the projection is not playoff-specific.
darko_projected_sdFloat64Standard deviation of the one-season-ahead DARKO forecast, the square root of the filtered state variance plus the Kalman process variance; it sits at roughly 10.19 for a player with only one season in the panel, whose diffuse prior variance was never updated.
load_nba_player_impact(seasons=2024)