MBB dataset loaders
flowchart LR
raw["scrape / raw"] --> enrich["enrich"] --> rel["release asset"] --> load["load_*()"]
Automation status
load_mbb_pbp
Release: espn_mens_college_basketball_pbp · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_pbp/play_by_play_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
game_play_number | Int32 | Sequential play number within the game. |
id | Int64 | Id. |
sequence_number | Int32 | Sequence number representing a shot-possession (V3 PBP). |
type_id | Int32 | Type identifier (numeric). |
type_text | String | Display text for the type field. |
text | String | Text description of the play / record. |
away_score | Int32 | Away team score at the time of the play. |
home_score | Int32 | Home team score at the time of the play. |
period_number | Int32 | Numeric period (1-4 for quarters; 5+ for OT). |
period_display_value | String | Period display label (e.g. '1st Quarter', 'OT'). |
clock_display_value | String | Game clock display string (e.g. '8:32'). |
scoring_play | Boolean | TRUE if the play resulted in points scored. |
score_value | Int32 | Point value of the play (2 / 3 / 1). |
wallclock | String | Wallclock. |
shooting_play | Boolean | TRUE if the play was a shooting attempt. |
coordinate_x_raw | Float64 | X coordinate as returned by the API before any adjustment. |
coordinate_y_raw | Float64 | Y coordinate as returned by the API before any adjustment. |
points_attempted | Int32 | Point value at stake on the shot attempt (3 for threes, 2 for other field goals, 1 for free throws), from the ESPN play type. |
short_description | String | Shortened version of ESPN's play description text, without score context. |
team_id | Int32 | Unique team identifier. |
athlete_id_1 | Int32 | Primary athlete identifier (e.g. shooter). |
athlete_id_2 | Int32 | Secondary athlete identifier (e.g. assister / fouler). |
game_id | Int32 | Unique game identifier. |
season | Int32 | Season year. |
season_type | Int32 | Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats). |
home_team_id | Int32 | Unique identifier for the home team. |
home_team_name | String | Home team name. |
home_team_mascot | String | Home team mascot. |
home_team_abbrev | String | Home team three-letter abbreviation. |
home_team_name_alt | String | Alternate home team name. |
away_team_id | Int32 | Unique identifier for the away team. |
away_team_name | String | Away team name. |
away_team_mascot | String | Away team mascot. |
away_team_abbrev | String | Away team three-letter abbreviation. |
away_team_name_alt | String | Alternate away team name. |
game_spread | Float64 | Game spread (signed; positive = home favored). |
home_favorite | Boolean | TRUE if the home team is the betting favorite. |
game_spread_available | Boolean | TRUE if a point spread was available. |
home_team_spread | Float64 | Home team's point spread. |
half | Int32 | Half of the game (1 or 2). |
time | String | Time / clock value. |
clock_minutes | Int32 | Clock minutes split out for convenience. |
clock_seconds | Int32 | Clock seconds split out for convenience. |
home_timeout_called | Boolean | True when the home team called a timeout on the play. |
away_timeout_called | Boolean | True when the away team called a timeout on the play. |
lag_period | Int32 | Period number of the previous play in the same game (period_number shifted forward one row within game_id), and null on each game's first play. |
lead_period | Int32 | Period number of the next play in the same game (period_number shifted back one row within game_id), and null on each game's final play. |
lag_half | Int32 | A lag column on the half |
lead_half | Int32 | A lead column on the half |
start_period_seconds_remaining | Int32 | Seconds left in the current period when the play started, computed as 60 times the game clock minutes plus the seconds, so 1200 at the tip of each 20-minute half and 300 at the start of an overtime. |
start_game_seconds_remaining | Int32 | Seconds remaining in the game at the start of the play. |
end_period_seconds_remaining | Int32 | Seconds left in the period when the play ended. |
end_game_seconds_remaining | Int32 | Seconds remaining in the game at the end of the play. |
coordinate_x | Float64 | X coordinate on the court (half-court layout). |
coordinate_y | Float64 | Y coordinate on the court (half-court layout). |
game_date | Date | Game date (YYYY-MM-DD). |
game_date_time | Datetime(time_unit='us', time_zone='America/New_York') | Game start date/time (ISO 8601). |
athlete_name_1 | String | Display name of the first athlete in the ESPN play participants (e.g., the shooter on a shot attempt). |
athlete_name_2 | String | Display name of the second athlete in the ESPN play participants (e.g., the assisting player), when present. |
athlete_name_3 | String | Display name of the third athlete in the ESPN play participants, when present. |
load_mbb_pbp(seasons=2024)
load_mbb_player_boxscore
Release: espn_mens_college_basketball_player_boxscores · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_player_boxscores/player_box_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
game_id | Int32 | Unique game identifier. |
season | Int32 | Season year. |
season_type | Int32 | Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats). |
game_date | Date | Game date (YYYY-MM-DD). |
game_date_time | Datetime(time_unit='us', time_zone='America/New_York') | Game start date/time (ISO 8601). |
athlete_id | Int32 | Unique athlete identifier (ESPN). |
athlete_display_name | String | Athlete display name (full). |
team_id | Int32 | Unique team identifier. |
team_name | String | Full team display name (e.g. 'Las Vegas Aces'). |
team_location | String | Team city or location string. |
team_short_display_name | String | Short team display name (e.g. 'Aces'). |
minutes | Float64 | Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2). |
field_goals_made | Int32 | Field goals made (2-pt + 3-pt). |
field_goals_attempted | Int32 | Field goal attempts (2-pt + 3-pt). |
three_point_field_goals_made | Int32 | Three-point field goals made. |
three_point_field_goals_attempted | Int32 | Three-point field goal attempts. |
free_throws_made | Int32 | Free throws made. |
free_throws_attempted | Int32 | Free throw attempts. |
offensive_rebounds | Int32 | Offensive rebounds. |
defensive_rebounds | Int32 | Defensive rebounds. |
rebounds | Int32 | Total rebounds. |
assists | Int32 | Total assists. |
steals | Int32 | Total steals. |
blocks | Int32 | Total blocks. |
turnovers | Int32 | Total turnovers. |
fouls | Int32 | Personal fouls. |
points | Int32 | Points scored. |
starter | Boolean | TRUE if the player was in the starting lineup; FALSE otherwise. |
ejected | Boolean | TRUE if the player was ejected from the game. |
did_not_play | Boolean | TRUE if the player did not appear in the game. |
athlete_jersey | String | Athlete jersey number. |
athlete_short_name | String | Athlete short display name. |
athlete_headshot_href | String | Athlete headshot image URL. |
athlete_position_name | String | Athlete position ('Guard', 'Forward', 'Center'). |
athlete_position_abbreviation | String | Athlete position abbreviation (G / F / C). |
team_display_name | String | Full team display name. |
team_uid | String | ESPN universal team identifier (UID format 's:40~l:...~t:...'). |
team_slug | String | URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces'). |
team_logo | String | Team logo image URL. |
team_abbreviation | String | Short team abbreviation (e.g. 'LAS'). |
team_color | String | Team primary color (hex without leading '#'). |
team_alternate_color | String | Team alternate color (hex without leading '#'). |
home_away | String | Game venue label ('home' or 'away'). |
team_winner | Boolean | TRUE if the team won this game. |
team_score | Int32 | Team's score / final score. |
opponent_team_id | Int32 | Unique identifier for the opponent team. |
opponent_team_name | String | Opponent team display name. |
opponent_team_location | String | Opponent team city / location. |
opponent_team_display_name | String | Opponent team full display name. |
opponent_team_abbreviation | String | Opponent team abbreviation. |
opponent_team_logo | String | Opponent team logo URL. |
opponent_team_color | String | Opponent team primary color (hex). |
opponent_team_alternate_color | String | Opponent team alternate color (hex). |
opponent_team_score | Int32 | Opponent team's score. |
active | Boolean | TRUE if the row represents an active record (player / team / season). |
load_mbb_player_boxscore(seasons=2024)
load_mbb_schedule
Release: espn_mens_college_basketball_schedules · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_schedules/mbb_schedule_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
id | Int32 | Id. |
uid | String | ESPN UID string. |
date | String | Date in YYYY-MM-DD format. |
attendance | Float64 | Reported attendance. |
time_valid | Boolean | Time valid. |
neutral_site | Boolean | Neutral site. |
conference_competition | Boolean | Conference competition. |
play_by_play_available | Boolean | Whether play-by-play data is available. |
recent | Boolean | Recent. |
start_date | String | Start date (YYYY-MM-DD). |
broadcast | String | Broadcast information string. |
highlights | String | Game highlight urls. |
notes_type | String | Notes type. |
notes_headline | String | Notes headline. |
broadcast_market | String | Broadcast market label (e.g. 'national', 'home'). |
broadcast_name | String | Broadcast name. |
type_id | Int32 | Type identifier (numeric). |
type_abbreviation | String | Type abbreviation. |
venue_id | Int32 | Unique venue identifier. |
venue_full_name | String | Venue full name. |
venue_address_city | String | Venue address city. |
venue_address_state | String | Venue address state / region. |
venue_indoor | Boolean | TRUE if the venue is indoors. |
status_clock | Float64 | Status clock. |
status_display_clock | String | Status display clock. |
status_period | Float64 | Status period. |
status_type_id | Int32 | Unique identifier for status type. |
status_type_name | String | Status type name. |
status_type_state | String | Status type state. |
status_type_completed | Boolean | Status type completed. |
status_type_description | String | Status type description. |
status_type_detail | String | Status type detail. |
status_type_short_detail | String | Status type short detail. |
format_regulation_periods | Float64 | Format regulation periods. |
home_id | Int32 | Unique identifier for home. |
home_uid | String | Home team's uid. |
home_location | String | Home team's location. |
home_name | String | Home name. |
home_abbreviation | String | Home team's abbreviation. |
home_display_name | String | Home display name. |
home_short_display_name | String | Home short display name. |
home_color | String | Color code (hex) for home. |
home_alternate_color | String | Color code (hex) for home alternate. |
home_is_active | Boolean | Home team's is active. |
home_venue_id | Int32 | Unique identifier for home venue. |
home_logo | String | Home team logo URL. |
home_conference_id | Int32 | Unique identifier for home conference. |
home_score | Int32 | Home team score at the time of the play. |
home_winner | Boolean | Home team's winner. |
home_current_rank | Float64 | Poll ranking ESPN listed for the home team at game time (unranked teams carry a sentinel value). |
home_linescores | String | Period-by-period scores for the home team as a delimited string from ESPN's schedule feed. |
home_records | String | Record strings (overall and split records) for the home team from ESPN's schedule feed. |
away_id | Int32 | Unique identifier for away. |
away_uid | String | Away team's uid. |
away_location | String | Away team's location. |
away_name | String | Away name. |
away_abbreviation | String | Away team's abbreviation. |
away_display_name | String | Away display name. |
away_short_display_name | String | Away short display name. |
away_color | String | Color code (hex) for away. |
away_alternate_color | String | Color code (hex) for away alternate. |
away_is_active | Boolean | Away team's is active. |
away_venue_id | Int32 | Unique identifier for away venue. |
away_logo | String | Away team logo URL. |
away_conference_id | Int32 | Unique identifier for away conference. |
away_score | Int32 | Away team score at the time of the play. |
away_winner | Boolean | Away team's winner. |
away_current_rank | Float64 | Poll ranking ESPN listed for the away team at game time (unranked teams carry a sentinel value). |
away_linescores | String | Period-by-period scores for the away team as a delimited string from ESPN's schedule feed. |
away_records | String | Record strings (overall and split records) for the away team from ESPN's schedule feed. |
game_id | Int32 | Unique game identifier. |
season | Int32 | Season year. |
season_type | Int32 | Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats). |
status_type_alt_detail | String | Status type alt detail. |
tournament_id | Int32 | ESPN tournament identifier. |
groups_id | Int32 | Unique identifier for groups. |
groups_name | String | Groups name. |
groups_short_name | String | Groups short name. |
groups_is_conference | Boolean | Groups is conference. |
game_json | Boolean | Whether processed game JSON is available. |
game_json_url | String | URL to the processed game JSON. |
game_date_time | Datetime(time_unit='us', time_zone='America/New_York') | Game start date/time (ISO 8601). |
game_date | Date | Game date (YYYY-MM-DD). |
PBP | Boolean | Whether play-by-play data is available. |
team_box | Boolean | Team box. |
player_box | Boolean | Player box. |
load_mbb_schedule(seasons=2024)
load_mbb_team_boxscore
Release: espn_mens_college_basketball_team_boxscores · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_team_boxscores/team_box_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
game_id | Int32 | Unique game identifier. |
season | Int32 | Season year. |
season_type | Int32 | Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats). |
game_date | Date | Game date (YYYY-MM-DD). |
game_date_time | Datetime(time_unit='us', time_zone='America/New_York') | Game start date/time (ISO 8601). |
team_id | Int32 | Unique team identifier. |
team_uid | String | ESPN universal team identifier (UID format 's:40~l:...~t:...'). |
team_slug | String | URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces'). |
team_location | String | Team city or location string. |
team_name | String | Full team display name (e.g. 'Las Vegas Aces'). |
team_abbreviation | String | Short team abbreviation (e.g. 'LAS'). |
team_display_name | String | Full team display name. |
team_short_display_name | String | Short team display name (e.g. 'Aces'). |
team_color | String | Team primary color (hex without leading '#'). |
team_alternate_color | String | Team alternate color (hex without leading '#'). |
team_logo | String | Team logo image URL. |
team_home_away | String | Team home away. |
team_score | Int32 | Team's score / final score. |
team_winner | Boolean | TRUE if the team won this game. |
assists | Int32 | Total assists. |
blocks | Int32 | Total blocks. |
defensive_rebounds | Int32 | Defensive rebounds. |
fast_break_points | String | Fast-break points scored. |
field_goal_pct | Float64 | Field goal percentage (0-1). |
field_goals_made | Int32 | Field goals made (2-pt + 3-pt). |
field_goals_attempted | Int32 | Field goal attempts (2-pt + 3-pt). |
flagrant_fouls | Int32 | Total flagrant fouls. |
fouls | Int32 | Personal fouls. |
free_throw_pct | Float64 | Free throw percentage (0-1). |
free_throws_made | Int32 | Free throws made. |
free_throws_attempted | Int32 | Free throw attempts. |
largest_lead | String | Largest lead during the game. |
offensive_rebounds | Int32 | Offensive rebounds. |
points_in_paint | String | Points scored in the paint. |
steals | Int32 | Total steals. |
team_turnovers | Int32 | Team turnovers (turnovers credited to the team rather than a player). |
technical_fouls | Int32 | Total technical fouls. |
three_point_field_goal_pct | Float64 | Three-point field goal percentage (0-1). |
three_point_field_goals_made | Int32 | Three-point field goals made. |
three_point_field_goals_attempted | Int32 | Three-point field goal attempts. |
total_rebounds | Int32 | Total rebounds. |
total_technical_fouls | Int32 | Total technical fouls (player + team). |
total_turnovers | Int32 | Total turnovers (player + team). |
turnover_points | String | Turnover points. |
turnovers | Int32 | Total turnovers. |
opponent_team_id | Int32 | Unique identifier for the opponent team. |
opponent_team_uid | String | Opponent team uid. |
opponent_team_slug | String | Opponent team slug. |
opponent_team_location | String | Opponent team city / location. |
opponent_team_name | String | Opponent team display name. |
opponent_team_abbreviation | String | Opponent team abbreviation. |
opponent_team_display_name | String | Opponent team full display name. |
opponent_team_short_display_name | String | Opponent team short display name. |
opponent_team_color | String | Opponent team primary color (hex). |
opponent_team_alternate_color | String | Opponent team alternate color (hex). |
opponent_team_logo | String | Opponent team logo URL. |
opponent_team_score | Int32 | Opponent team's score. |
lead_changes | String | Lead changes. |
lead_percentage | String | Share of game time the team held the lead, as reported in ESPN's team boxscore. |
load_mbb_team_boxscore(seasons=2024)
load_mbb_ratings
Release: mbb_ratings · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/mbb_ratings/mbb_ratings_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
season | Int64 | Season year. |
team_id | String | Unique team identifier. |
adj_o | Float64 | Adj o. |
adj_d | Float64 | Adj d. |
adj_em | Float64 | Adj em. |
adj_tempo | Float64 | Opponent-adjusted possessions per 40 minutes, solved by the same fixed point as the efficiency ratings under the additive model that a game's pace is the two teams' tempos less the league baseline; it averages about 71 in 2025. |
raw_o | Float64 | Raw o. |
raw_d | Float64 | Raw d. |
games | Int64 | Games played. |
rank | Int64 | Rank. |
adj_em_z | Float64 | Within-season z-score of adj_em, computed as adj_em minus the season mean divided by the season standard deviation, so each season is centered at zero with unit spread. |
load_mbb_ratings(seasons=2025)
load_mbb_player_value
Release: mbb_player_value · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/mbb_player_value/mbb_player_value_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
player_id | String | Unique player identifier. |
player | String | Player name. |
season | Int64 | Season year. |
team_id | String | Unique team identifier. |
min | Float64 | Minutes played. |
box_obpm | Float64 | Box-score offensive plus/minus for the player, the offensive half of box BPM. |
box_dbpm | Float64 | Box-score defensive plus/minus for the player, the defensive half of box BPM. |
box_bpm | Float64 | Total box plus/minus in points per 100 possessions above an average player, exactly box_obpm plus box_dbpm (verified to zero residual across all 9,805 rows of 2025). |
load_mbb_player_value(seasons=2025)
load_mbb_shots
Release: espn_mens_college_basketball_shots · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_shots/shots_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
game_id | Int32 | Unique game identifier. |
season | Int32 | Season year. |
period_number | Int32 | Numeric period (1-4 for quarters; 5+ for OT). |
clock_display_value | String | Game clock display string (e.g. '8:32'). |
team_id | Int32 | Unique team identifier. |
athlete_id_1 | Int32 | Primary athlete identifier (e.g. shooter). |
athlete_id_2 | Int32 | Secondary athlete identifier (e.g. assister / fouler). |
type_id | Int32 | Type identifier (numeric). |
type_text | String | Display text for the type field. |
scoring_play | Boolean | TRUE if the play resulted in points scored. |
score_value | Int32 | Point value of the play (2 / 3 / 1). |
coordinate_x | Float64 | X coordinate on the court (half-court layout). |
coordinate_y | Float64 | Y coordinate on the court (half-court layout). |
coordinate_x_raw | Float64 | X coordinate as returned by the API before any adjustment. |
coordinate_y_raw | Float64 | Y coordinate as returned by the API before any adjustment. |
athlete_name_1 | String | Display name of the shooter credited on the attempt in ESPN's play participants. |
athlete_name_2 | String | Display name of the second athlete tied to the attempt (typically the assister), when present. |
team_name | String | Full team display name (e.g. 'Las Vegas Aces'). |
team_mascot | String | Mascot/nickname of the shooting team from ESPN's team record. |
team_abbrev | String | Abbreviation for team. |
load_mbb_shots(seasons=2025)
load_mbb_standings
Release: espn_mens_college_basketball_standings · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_standings/standings_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
season | Int32 | Season year. |
group_id | String | ESPN group id. |
group_name | String | Group name (conference / division). |
group_abbreviation | String | Group abbreviation. |
group_short_name | String | Abbreviated conference label ESPN prints in standings tables, such as ACC, Big Ten or Am. East, one value per group_id. |
team_id | Int32 | Unique team identifier. |
team_uid | String | ESPN universal team identifier (UID format 's:40~l:...~t:...'). |
team_slug | String | URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces'). |
team_location | String | Team city or location string. |
team_name | String | Full team display name (e.g. 'Las Vegas Aces'). |
team_abbreviation | String | Short team abbreviation (e.g. 'LAS'). |
team_display_name | String | Full team display name. |
team_short_display_name | String | Short team display name (e.g. 'Aces'). |
team_color | String | Team primary color (hex without leading '#'). |
team_alternate_color | String | Team alternate color (hex without leading '#'). |
team_logo | String | Team logo image URL. |
stat_name | String | Stat key. |
stat_display_name | String | Stat display name. |
stat_short_display_name | String | Short human-readable stat name. |
stat_description | String | ESPN's longer-form label for the standings statistic, which can differ from stat_display_name (streak is described as Current Streak and playoffSeed as Playoff Seed). |
stat_abbreviation | String | Short code ESPN prints for the standings statistic in a table header, such as W, L, PCT, GB or STRK; it diverges from stat_short_display_name for playoff seed and the home and conference record rows. |
stat_type | String | Stat type code (e.g. "win", "loss"). |
display_value | String | Display-formatted value. |
value | Float64 | Numeric or string value field. |
load_mbb_standings(seasons=2025)
load_mbb_player_season_stats
Release: espn_mens_college_basketball_player_season_stats · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_player_season_stats/player_season_stats_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
season | Int32 | Season year. |
athlete_id | Int32 | Unique athlete identifier (ESPN). |
athlete_display_name | String | Athlete display name (full). |
athlete_position_abbreviation | String | Athlete position abbreviation (G / F / C). |
athlete_jersey | String | Athlete jersey number. |
team_id | Int32 | Unique team identifier. |
team_slug | String | URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces'). |
team_display_name | String | Full team display name. |
category | String | Category label. |
stat_label | String | Human-readable label of the statistic (e.g. 'At bats'). |
stat_name | String | Stat key. |
stat_display_name | String | Stat display name. |
stat_description | String | ESPN's prose glossary definition of the statistic named in stat_name, for example defining assists as a pass to a teammate that leads directly to a field goal. |
display_value | String | Display-formatted value. |
value | Float64 | Numeric or string value field. |
load_mbb_player_season_stats(seasons=2025)
load_mbb_rosters
Release: espn_mens_college_basketball_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_rosters/rosters_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
season | Int32 | Season year. |
team_id | Int32 | Unique team identifier. |
team_slug | String | URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces'). |
team_abbreviation | String | Short team abbreviation (e.g. 'LAS'). |
team_display_name | String | Full team display name. |
team_short_display_name | String | Short team display name (e.g. 'Aces'). |
team_color | String | Team primary color (hex without leading '#'). |
team_alternate_color | String | Team alternate color (hex without leading '#'). |
team_logo | String | Team logo image URL. |
athlete_id | String | Unique athlete identifier (ESPN). |
uid | String | ESPN UID string. |
guid | String | Stable cross-league team GUID. |
full_name | String | Player's full name. |
display_name | String | Display name. |
short_name | String | Short display name. |
first_name | String | Player's first name. |
last_name | String | Player's last name. |
jersey | String | Jersey number worn by the player. |
position_abbreviation | String | Position abbreviation ('G' / 'F' / 'C'). |
position_name | String | Listed roster position ('Guard', 'Forward', 'Center'). |
position_id | String | Unique position identifier. |
height | String | Player height (string e.g. '6-2' or inches). |
weight | String | Player weight in pounds. |
age | String | Player age (in years). |
date_of_birth | String | Date of birth (YYYY-MM-DD). |
birth_place_city | String | Birth place city. |
birth_place_state | String | Birth place state. |
birth_place_country | String | Birth place country. |
experience_years | String | Experience years. |
experience_display_value | String | Experience display value. |
headshot_href | String | Headshot image URL. |
headshot_alt | String | Alternative-text label for the headshot. |
link_web | String | Web link / URL. |
status_id | String | Status identifier. |
status_name | String | Status label. |
status_type | String | Status type. |
load_mbb_rosters(seasons=2025)
load_mbb_officials
Release: espn_mens_college_basketball_officials · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_officials/officials_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
season | Int32 | Season year. |
game_id | Int32 | Unique game identifier. |
official_full_name | String | Full name of the game official as published in ESPN's gameInfo officials list; in this release it is byte-identical to official_display_name on every row. |
official_display_name | String | Display form of the official's name used by ESPN's game feed, which duplicates official_full_name for all 18,284 rows of the 2025 release. |
official_position | String | ESPN's role label for the crew member, which is the constant Referee for every men's college basketball official in this release rather than a distinct crew chief or umpire designation. |
official_position_id | Int32 | ESPN's numeric code for the official's role, constant at 40 (Referee) across the entire men's college basketball officials release. |
official_order | Int32 | Position of the official within the game's listed officiating crew. |
load_mbb_officials(seasons=2025)
load_mbb_game_rosters
Release: espn_mens_college_basketball_game_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_game_rosters/game_rosters_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
season | Int32 | Season year. |
game_id | String | Unique game identifier. |
team_id | Int32 | Unique team identifier. |
team_slug | String | URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces'). |
team_abbreviation | String | Short team abbreviation (e.g. 'LAS'). |
team_display_name | String | Full team display name. |
home_away | String | Game venue label ('home' or 'away'). |
athlete_id | Int32 | Unique athlete identifier (ESPN). |
athlete_uid | String | ESPN athlete UID (universal identifier). |
athlete_guid | String | ESPN athlete GUID. |
athlete_display_name | String | Athlete display name (full). |
athlete_short_name | String | Athlete short display name. |
athlete_first_name | String | Player first name; athlete_detail = TRUE only. |
athlete_last_name | String | Athlete last name. |
athlete_jersey | String | Athlete jersey number. |
athlete_position | String | Athlete position. |
athlete_headshot | String | URL of the player's ESPN headshot image, whose filename is the athlete_id (verified equal for all 190,365 non-null rows in 2025); null when ESPN publishes no photo for that player. |
starter | Boolean | TRUE if the player was in the starting lineup; FALSE otherwise. |
did_not_play | Boolean | TRUE if the player did not appear in the game. |
active | Boolean | TRUE if the row represents an active record (player / team / season). |
ejected | Boolean | TRUE if the player was ejected from the game. |
reason | String | Reason. |
load_mbb_game_rosters(seasons=2025)
load_mbb_team_season_stats
Release: espn_mens_college_basketball_team_season_stats · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_team_season_stats/team_season_stats_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
season | Int32 | Season year. |
team_id | Int32 | Unique team identifier. |
team_slug | String | URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces'). |
team_abbreviation | String | Short team abbreviation (e.g. 'LAS'). |
team_display_name | String | Full team display name. |
team_short_display_name | String | Short team display name (e.g. 'Aces'). |
team_color | String | Team primary color (hex without leading '#'). |
team_alternate_color | String | Team alternate color (hex without leading '#'). |
team_logo | String | Team logo image URL. |
category | String | Category label. |
stat_label | String | Human-readable label of the statistic (e.g. 'At bats'). |
stat_name | String | Stat key. |
stat_display_name | String | Stat display name. |
stat_description | String | ESPN's prose glossary definition of the statistic named in stat_name, for example defining field goal percentage as the ratio of field goals made to field goals attempted. |
display_value | String | Display-formatted value. |
value | Float64 | Numeric or string value field. |
load_mbb_team_season_stats(seasons=2025)
load_mbb_player_crosswalk
Release: mbb_crosswalk · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/mbb_crosswalk/mbb_player_crosswalk_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
season | Int32 | Season year. |
espn_team_id | Int32 | ESPN team id (canonical key). |
team_abbreviation | String | Short team abbreviation (e.g. 'LAS'). |
player_name | String | Player name. |
espn_athlete_id | String | ESPN athlete id. |
espn_full_name | String | ESPN full name. |
espn_jersey | String | ESPN jersey number. |
espn_position | String | ESPN position abbreviation. |
fox_athlete_id | String | Fox athlete id (NA if unmatched). |
fox_player | String | Fox player name (NA if unmatched). |
fox_jersey | String | Fox jersey number (NA if unmatched). |
fox_position_group | String | Fox position group label (NA if unmatched). |
yahoo_player_id | String | Yahoo player id (NA placeholder). |
yahoo_player_name | String | Yahoo player name (NA placeholder). |
match_method | String | Combination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only". |
match_confidence | Float64 | Jaro-Winkler score or 1 for exact (NA if none). |
match_keys | String | NA (reserved for future use). |
load_mbb_player_crosswalk(seasons=2026)
load_mbb_schedule_crosswalk
Release: mbb_crosswalk · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/mbb_crosswalk/mbb_schedule_crosswalk_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
season | Int32 | Season year. |
game_date | Date | Game date (YYYY-MM-DD). |
home_espn_team_id | Int32 | ESPN home team id (NA for bart-only rows). |
away_espn_team_id | Int32 | ESPN away team id (NA for bart-only rows). |
espn_game_id | String | ESPN game id (NA for bart-only rows). |
bart_muid | String | Torvik muid (NA for espn-only rows). |
bart_team1 | String | Torvik team1 name (NA for espn-only rows). |
bart_team2 | String | Torvik team2 name (NA for espn-only rows). |
bart_winner | String | Torvik winner name (NA for espn-only rows). |
kp_game_id | String | KenPom game id (NA unless kenpom enabled). |
fox_game_id | String | Fox game id (NA placeholder). |
yahoo_game_id | String | Yahoo game id (NA placeholder). |
match_method | String | Combination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only". |
match_confidence | Float64 | Jaro-Winkler score or 1 for exact (NA if none). |
load_mbb_schedule_crosswalk(seasons=2026)
load_mbb_team_crosswalk
Release: mbb_crosswalk · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/mbb_crosswalk/mbb_team_crosswalk_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
season | Int32 | Season year. |
espn_team_id | Int32 | ESPN team id (canonical key). |
espn_abbreviation | String | ESPN abbreviation. |
espn_display_name | String | ESPN display name (school + mascot). |
espn_short_name | String | ESPN short name. |
espn_location | String | ESPN school/location only. |
espn_mascot | String | ESPN mascot/nickname. |
espn_conference | String | ESPN conference name. |
fox_team_id | String | Fox Bifrost team id (NA if unmatched). |
fox_team_name | String | Fox team name (NA if unmatched). |
fox_section | String | Fox conference/section label (NA if unmatched). |
bart_team | String | Torvik team name (NA if unmatched). |
bart_conf | String | Torvik conference abbreviation (NA if unmatched). |
kp_team | String | KenPom team name (NA if unmatched). |
kp_conf | String | KenPom conference abbreviation (NA if unmatched). |
yahoo_team_id | String | Yahoo team id (NA placeholder). |
yahoo_team_name | String | Yahoo team name (NA placeholder). |
fox_match_confidence | Float64 | 1 for matched, NA for unmatched. |
bart_match_confidence | Float64 | 1 for matched, NA for unmatched. |
kp_match_confidence | Float64 | 1 for matched, NA for unmatched. |
match_method | String | Combination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only". |
load_mbb_team_crosswalk(seasons=2026)
load_mbb_player_core
Release: espn_mens_college_basketball_player_core · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_mens_college_basketball_player_core/player_core_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
season | Int32 | Season year. |
athlete_id | Int64 | Unique athlete identifier (ESPN). |
guid | String | Stable cross-league team GUID. |
uid | String | ESPN UID string. |
slug | String | URL-safe identifier. |
type | String | Record type / category. |
first_name | String | Player's first name. |
last_name | String | Player's last name. |
full_name | String | Player's full name. |
display_name | String | Display name. |
short_name | String | Short display name. |
height | Float64 | Player height (string e.g. '6-2' or inches). |
display_height | String | Player height in display format (e.g. '6-2'). |
weight | Float64 | Player weight in pounds. |
display_weight | String | Player weight in display format (e.g. '180 lbs'). |
age | Int32 | Player age (in years). |
date_of_birth | String | Date of birth (YYYY-MM-DD). |
birth_city | String | Birth city. |
birth_state | String | Birth state / region. |
birth_country | String | Player birth country. |
jersey | String | Jersey number worn by the player. |
position_id | Int32 | Unique position identifier. |
position_name | String | Listed roster position ('Guard', 'Forward', 'Center'). |
position_abbreviation | String | Position abbreviation ('G' / 'F' / 'C'). |
position_display_name | String | Position display name. |
college_id | Int32 | Unique identifier for college. |
current_team_id | Int32 | Player's current team identifier. |
headshot_href | String | Headshot image URL. |
experience_years | Int32 | Experience years. |
status_id | Int32 | Status identifier. |
status_name | String | Status label. |
status_type | String | Status type. |
draft_year | Int32 | Draft year (4-digit). |
draft_round | Int32 | Round of the draft selection. |
draft_selection | Int32 | Draft selection. |
active | Boolean | TRUE if the row represents an active record (player / team / season). |
load_mbb_player_core(seasons=2025)
load_ncaa_mbb_pbp
Release: ncaa_mbb_pbp · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_mbb_pbp/ncaa_mbb_pbp_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
game_date | String | Game date (YYYY-MM-DD). |
home | String | Home. |
away | String | Away record. |
period | Int64 | Period of the game (1-4 quarters; 5+ for OT). |
clock | String | Game clock value. |
game_time | String | Game start time. |
game_seconds | Int64 | Elapsed seconds in the game. |
home_score | Int64 | Home team score at the time of the play. |
away_score | Int64 | Away team score at the time of the play. |
event_team | String | Team associated with the shift change. |
event_description | String | Human-readable event description. |
player_1 | String | Name of the primary player credited on the event (shooter, fouler, rebounder, etc.), as scraped from stats.ncaa.org. |
player_2 | String | Name of the secondary player on the event (e.g., the assister or the player subbed for), when present. |
event_type | String | Event / play type code (V2 PBP). |
event_result | String | Outcome of the event, e.g. made or missed for shot attempts. |
shot_value | Int64 | Point value of the shot (2 or 3). |
event_length | Int64 | Seconds elapsed between this event and the previous event in the game. |
poss_num | Int64 | Sequential possession number within the game that the event belongs to. |
poss_team | String | Name of the team in possession when the event occurred. |
poss_length | Int64 | Duration of the enclosing possession in seconds. |
is_transition | Boolean | Flag marking events that occurred in transition, within the opening seconds of the possession. |
home_1 | String | Name of the home team's on-floor player in lineup slot 1 for the event, from the substitution walk-forward. |
home_2 | String | Name of the home team's on-floor player in lineup slot 2 for the event, from the substitution walk-forward. |
home_3 | String | Name of the home team's on-floor player in lineup slot 3 for the event, from the substitution walk-forward. |
home_4 | String | Name of the home team's on-floor player in lineup slot 4 for the event, from the substitution walk-forward. |
home_5 | String | Name of the home team's on-floor player in lineup slot 5 for the event, from the substitution walk-forward. |
away_1 | String | Name of the away team's on-floor player in lineup slot 1 for the event, from the substitution walk-forward. |
away_2 | String | Name of the away team's on-floor player in lineup slot 2 for the event, from the substitution walk-forward. |
away_3 | String | Name of the away team's on-floor player in lineup slot 3 for the event, from the substitution walk-forward. |
away_4 | String | Name of the away team's on-floor player in lineup slot 4 for the event, from the substitution walk-forward. |
away_5 | String | Name of the away team's on-floor player in lineup slot 5 for the event, from the substitution walk-forward. |
status | String | Status label. |
is_garbage_time | Boolean | Flag marking events in garbage time under the score-margin and clock rule of the pbp builder. |
sub_deviate | Int64 | Per-game count of substitution-tracking deviations found while walking lineups forward; nonzero flags imperfect substitution data. |
contest_id | String | stats.ncaa.org contest (game) identifier. |
home_ncaa_team_id | String | stats.ncaa.org team identifier for the home team. |
home_espn_team_id | String | ESPN home team id (NA for bart-only rows). |
away_ncaa_team_id | String | stats.ncaa.org team identifier for the away team. |
away_espn_team_id | String | ESPN away team id (NA for bart-only rows). |
event_team_ncaa_team_id | String | stats.ncaa.org team identifier of the team credited with the event. |
event_team_espn_team_id | String | ESPN team identifier of the team credited with the event, via the NCAA-to-ESPN crosswalk. |
poss_team_ncaa_team_id | String | stats.ncaa.org team identifier of the team in possession. |
poss_team_espn_team_id | String | ESPN team identifier of the team in possession, via the NCAA-to-ESPN crosswalk. |
player_1_id | String | stats.ncaa.org player identifier for player_1, resolved through the roster name matcher. |
player_1_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name for player_1. |
player_2_id | String | stats.ncaa.org player identifier for player_2, resolved through the roster name matcher. |
player_2_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name for player_2. |
home_1_player_id | String | stats.ncaa.org player identifier for the home slot-1 on-floor player. |
home_1_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the home slot-1 on-floor player. |
home_2_player_id | String | stats.ncaa.org player identifier for the home slot-2 on-floor player. |
home_2_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the home slot-2 on-floor player. |
home_3_player_id | String | stats.ncaa.org player identifier for the home slot-3 on-floor player. |
home_3_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the home slot-3 on-floor player. |
home_4_player_id | String | stats.ncaa.org player identifier for the home slot-4 on-floor player. |
home_4_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the home slot-4 on-floor player. |
home_5_player_id | String | stats.ncaa.org player identifier for the home slot-5 on-floor player. |
home_5_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the home slot-5 on-floor player. |
away_1_player_id | String | stats.ncaa.org player identifier for the away slot-1 on-floor player. |
away_1_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the away slot-1 on-floor player. |
away_2_player_id | String | stats.ncaa.org player identifier for the away slot-2 on-floor player. |
away_2_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the away slot-2 on-floor player. |
away_3_player_id | String | stats.ncaa.org player identifier for the away slot-3 on-floor player. |
away_3_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the away slot-3 on-floor player. |
away_4_player_id | String | stats.ncaa.org player identifier for the away slot-4 on-floor player. |
away_4_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the away slot-4 on-floor player. |
away_5_player_id | String | stats.ncaa.org player identifier for the away slot-5 on-floor player. |
away_5_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the away slot-5 on-floor player. |
espn_game_id | String | ESPN game id (NA for bart-only rows). |
is_fastbreak | Boolean | Flag marking the shot as a fast-break attempt, from the stats.ncaa.org play text. |
is_from_turnover | Boolean | Flag marking an attempt generated off an opponent turnover. |
is_paint | Boolean | Flag marking the shot as attempted in the paint. |
is_second_chance | Boolean | Flag marking a second-chance attempt following an offensive rebound. |
assist_player | String | Name of the player credited with the assist on a made shot, when present. |
ft_number | Int64 | Which free throw of the trip this attempt is (1 of 2, 2 of 2, etc.). |
ft_attempts | Int64 | Total free throws in the trip this attempt belongs to. |
foul_class | String | Parsed category of the foul event (e.g. personal, offensive). |
is_shooting_foul | Boolean | Flag marking the foul as a shooting foul. |
is_looseball_foul | Boolean | Flag marking the foul as a loose-ball foul. |
is_one_and_one | Boolean | Flag marking a bonus one-and-one free-throw trip. |
is_flagrant | Boolean | Flag marking the foul as flagrant. |
foul_tech_class | String | Parsed technical-foul class for technical foul events, when present. |
ft_awarded | Int64 | Number of free throws awarded by the foul. |
turnover_type | String | Parsed turnover subtype (e.g. lost ball, bad pass, travel). |
is_team_turnover | Boolean | Flag marking a turnover charged to the team rather than an individual player. |
timeout_type | String | Type of timeout called (e.g. full, 30-second, media). |
challenge_outcome | String | Outcome of a coach's challenge or video-review event, when present. |
season | Int64 | Season year. |
load_ncaa_mbb_pbp(seasons=2024)
load_ncaa_mbb_schedule
Release: ncaa_mbb_schedule · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_mbb_schedule/ncaa_mbb_schedule_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
contest_id | String | stats.ncaa.org contest (game) identifier. |
game_date | String | Game date (YYYY-MM-DD). |
home | String | Home. |
away | String | Away record. |
home_score | Int64 | Home team score at the time of the play. |
away_score | Int64 | Away team score at the time of the play. |
season | Int64 | Season year. |
load_ncaa_mbb_schedule(seasons=2024)
load_ncaa_mbb_player_box
Release: ncaa_mbb_player_box · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_mbb_player_box/ncaa_mbb_player_box_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
game_date | String | Game date (YYYY-MM-DD). |
home | String | Home. |
away | String | Away record. |
team | String | Team-side label or team identifier. |
player | String | Player name. |
mins | Float64 | Minutes played, derived from the lineup walk-forward through the play-by-play. |
o_poss | Float64 | Offensive possessions the player was on the floor for. |
pts | Float64 | Points scored. |
orb | Float64 | Offensive rebounds. |
drb | Float64 | Defensive rebounds. |
ast | Float64 | Assists. |
stl | Float64 | Steals. |
blk | Float64 | Blocks. |
tov | Float64 | Turnovers. |
pf | Float64 | Personal fouls. |
ts_pct | Float64 | True shooting percentage (0-1). |
efg_pct | Float64 | Effective field-goal percentage, weighting made threes at 1.5. |
fgm | Float64 | Field goals made. |
fga | Float64 | Field goal attempts. |
fg_pct | Float64 | Field goal percentage (0-1). |
tpm | Float64 | Three-point field goals made. |
tpa | Float64 | Three-point field goals attempted. |
tp_pct | Float64 | Three-point field-goal percentage. |
ftm | Float64 | Free throws made. |
fta | Float64 | Free throw attempts. |
ft_pct | Float64 | Free throw percentage (0-1). |
rimm | Float64 | Rim shots (dunks, layups, hooks, tip-ins) made. |
rima | Float64 | Rim shots (dunks, layups, hooks, tip-ins) attempted. |
rim_pct | Float64 | Field-goal percentage on rim attempts. |
midm | Float64 | Mid-range (non-rim two-point) shots made. |
mida | Float64 | Mid-range (non-rim two-point) shots attempted. |
mid_pct | Float64 | Field-goal percentage on mid-range attempts. |
pbackm | Float64 | Putbacks made — rim shots immediately following an offensive rebound. |
pbacka | Float64 | Putbacks attempted — rim shots immediately following an offensive rebound. |
pback_pct | Float64 | Field-goal percentage on putback attempts. |
blk_rim | Float64 | Blocks recorded against opponent rim attempts. |
blk_mid | Float64 | Blocks recorded against opponent mid-range attempts. |
blk_three | Float64 | Blocks recorded against opponent three-point attempts. |
pct_fga_trans | Float64 | Share of the player's field-goal attempts taken in transition. |
pct_tpa_trans | Float64 | Share of the player's three-point attempts taken in transition. |
pct_rima_trans | Float64 | Share of the player's rim attempts taken in transition. |
pct_fgm_trans | Float64 | Share of the player's field-goal makes that came in transition. |
pct_tpm_trans | Float64 | Share of the player's three-point makes that came in transition. |
pct_rimm_trans | Float64 | Share of the player's rim makes that came in transition. |
pct_fgm_ast | Float64 | Share of the player's made field goals that were assisted. |
pct_tpm_ast | Float64 | Share of the player's made threes that were assisted. |
pct_rimm_ast | Float64 | Share of the player's made rim shots that were assisted. |
pts_trans | Float64 | Points scored in transition possessions. |
orb_trans | Float64 | Offensive rebounds in transition possessions. |
drb_trans | Float64 | Defensive rebounds in transition possessions. |
ast_trans | Float64 | Assists in transition possessions. |
stl_trans | Float64 | Steals in transition possessions. |
blk_trans | Float64 | Blocks in transition possessions. |
tov_trans | Float64 | Turnovers in transition possessions. |
ts_pct_trans | Float64 | True-shooting percentage in transition possessions. |
efg_pct_trans | Float64 | Effective field-goal percentage in transition possessions. |
fgm_trans | Float64 | Field goals made in transition possessions. |
fga_trans | Float64 | Field goals attempted in transition possessions. |
fg_pct_trans | Float64 | Field-goal percentage in transition possessions. |
tpm_trans | Float64 | Three-pointers made in transition possessions. |
tpa_trans | Float64 | Three-pointers attempted in transition possessions. |
tp_pct_trans | Float64 | Three-point percentage in transition possessions. |
ftm_trans | Float64 | Free throws made in transition possessions. |
fta_trans | Float64 | Free throws attempted in transition possessions. |
ft_pct_trans | Float64 | Free-throw percentage in transition possessions. |
rimm_trans | Float64 | Rim shots made in transition possessions. |
rima_trans | Float64 | Rim shots attempted in transition possessions. |
rim_pct_trans | Float64 | Rim field-goal percentage in transition possessions. |
midm_trans | Float64 | Mid-range shots made in transition possessions. |
mida_trans | Float64 | Mid-range shots attempted in transition possessions. |
mid_pct_trans | Float64 | Mid-range field-goal percentage in transition possessions. |
pts_half | Float64 | Points scored in halfcourt possessions. |
orb_half | Float64 | Offensive rebounds in halfcourt possessions. |
drb_half | Float64 | Defensive rebounds in halfcourt possessions. |
ast_half | Float64 | Assists in halfcourt possessions. |
stl_half | Float64 | Steals in halfcourt possessions. |
blk_half | Float64 | Blocks in halfcourt possessions. |
tov_half | Float64 | Turnovers in halfcourt possessions. |
ts_pct_half | Float64 | True-shooting percentage in halfcourt possessions. |
efg_pct_half | Float64 | Effective field-goal percentage in halfcourt possessions. |
fgm_half | Float64 | Field goals made in halfcourt possessions. |
fga_half | Float64 | Field goals attempted in halfcourt possessions. |
fg_pct_half | Float64 | Field-goal percentage in halfcourt possessions. |
tpm_half | Float64 | Three-pointers made in halfcourt possessions. |
tpa_half | Float64 | Three-pointers attempted in halfcourt possessions. |
tp_pct_half | Float64 | Three-point percentage in halfcourt possessions. |
ftm_half | Float64 | Free throws made in halfcourt possessions. |
fta_half | Float64 | Free throws attempted in halfcourt possessions. |
ft_pct_half | Float64 | Free-throw percentage in halfcourt possessions. |
rimm_half | Float64 | Rim shots made in halfcourt possessions. |
rima_half | Float64 | Rim shots attempted in halfcourt possessions. |
rim_pct_half | Float64 | Rim field-goal percentage in halfcourt possessions. |
midm_half | Float64 | Mid-range shots made in halfcourt possessions. |
mida_half | Float64 | Mid-range shots attempted in halfcourt possessions. |
mid_pct_half | Float64 | Mid-range field-goal percentage in halfcourt possessions. |
pts_ast | Float64 | Points from the player's assisted field-goal makes. |
fgm_ast | Float64 | Assisted field-goal makes. |
tpm_ast | Float64 | Assisted three-point makes. |
rimm_ast | Float64 | Assisted rim makes. |
midm_ast | Float64 | Assisted mid-range makes. |
pts_unast | Float64 | Points from the player's unassisted field-goal makes. |
efg_pct_unast | Float64 | Effective field-goal percentage in the unassisted split (makes for which no assist was credited). |
fgm_unast | Float64 | Field goals made in the unassisted split (makes for which no assist was credited). |
fga_unast | Float64 | Field goals attempted in the unassisted split (makes for which no assist was credited). |
fg_pct_unast | Float64 | Field-goal percentage in the unassisted split (makes for which no assist was credited). |
tpm_unast | Float64 | Three-pointers made in the unassisted split (makes for which no assist was credited). |
tpa_unast | Float64 | Three-pointers attempted in the unassisted split (makes for which no assist was credited). |
tp_pct_unast | Float64 | Three-point percentage in the unassisted split (makes for which no assist was credited). |
rimm_unast | Float64 | Rim shots made in the unassisted split (makes for which no assist was credited). |
rima_unast | Float64 | Rim shots attempted in the unassisted split (makes for which no assist was credited). |
rim_pct_unast | Float64 | Rim field-goal percentage in the unassisted split (makes for which no assist was credited). |
midm_unast | Float64 | Mid-range shots made in the unassisted split (makes for which no assist was credited). |
mida_unast | Float64 | Mid-range shots attempted in the unassisted split (makes for which no assist was credited). |
mid_pct_unast | Float64 | Mid-range field-goal percentage in the unassisted split (makes for which no assist was credited). |
contest_id | String | stats.ncaa.org contest (game) identifier. |
home_ncaa_team_id | String | stats.ncaa.org team identifier for the home team. |
home_espn_team_id | String | ESPN home team id (NA for bart-only rows). |
away_ncaa_team_id | String | stats.ncaa.org team identifier for the away team. |
away_espn_team_id | String | ESPN away team id (NA for bart-only rows). |
team_ncaa_team_id | String | stats.ncaa.org team identifier of the player's team. |
team_espn_team_id | String | ESPN team identifier of the player's team, via the NCAA-to-ESPN crosswalk. |
player_id | String | Unique player identifier. |
clean_name | String | Normalized (diacritics- and punctuation-cleaned) player name used to join across the NCAA datasets. |
espn_game_id | String | ESPN game id (NA for bart-only rows). |
season | Int64 | Season year. |
load_ncaa_mbb_player_box(seasons=2024)
load_ncaa_mbb_team_box
Release: ncaa_mbb_team_box · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_mbb_team_box/ncaa_mbb_team_box_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
home | String | Home. |
away | String | Away record. |
team | String | Team-side label or team identifier. |
mins | Float64 | Minutes covered by the team's tracked lineups in the game. |
o_mins | Float64 | Minutes spent on tracked offensive possessions. |
d_mins | Float64 | Minutes spent on tracked defensive possessions. |
o_poss | Float64 | Offensive possessions. |
d_poss | Float64 | Defensive possessions. |
ortg | Float64 | Offensive rating — points scored per 100 possessions. |
drtg | Float64 | Defensive rating — points allowed per 100 possessions. |
netrtg | Float64 | Net rating — offensive rating minus defensive rating. |
pts | Float64 | Points scored. |
d_pts | Float64 | Points allowed. |
fga | Float64 | Field goal attempts. |
d_fga | Float64 | Opponent field-goal attempts. |
fgm | Float64 | Field goals made. |
d_fgm | Float64 | Opponent field goals made. |
tpa | Float64 | Three-point attempts. |
d_tpa | Float64 | Opponent three-point attempts. |
tpm | Float64 | Three-pointers made. |
d_tpm | Float64 | Opponent three-pointers made. |
fta | Float64 | Free throw attempts. |
d_fta | Float64 | Opponent free-throw attempts. |
ftm | Float64 | Free throws made. |
d_ftm | Float64 | Opponent free throws made. |
rima | Float64 | Rim shots (dunks, layups, hooks, tip-ins) attempted. |
d_rima | Float64 | Opponent rim shots attempted. |
rimm | Float64 | Rim shots made. |
d_rimm | Float64 | Opponent rim shots made. |
orb | Float64 | Offensive rebounds. |
d_orb | Float64 | Opponent offensive rebounds. |
drb | Float64 | Defensive rebounds. |
d_drb | Float64 | Opponent defensive rebounds. |
blk | Float64 | Blocks. |
d_blk | Float64 | Opponent blocks (own shots blocked). |
to | Float64 | To. |
d_to | Float64 | Opponent turnovers forced. |
ast | Float64 | Assists. |
d_ast | Float64 | Opponent assists allowed. |
e_poss | Float64 | Estimated possessions — the average of the team's and the opponent's raw possession counts. |
fg_pct | Float64 | Field goal percentage (0-1). |
d_fg_pct | Float64 | Opponent field-goal percentage. |
tpp | Float64 | Three-point percentage. |
d_tpp | Float64 | Opponent three-point percentage. |
ftp | Float64 | Free-throw percentage. |
d_ftp | Float64 | Opponent free-throw percentage. |
efg_pct | Float64 | Effective field-goal percentage, weighting made threes at 1.5. |
d_efg_pct | Float64 | Opponent effective field-goal percentage. |
ts_pct | Float64 | True shooting percentage (0-1). |
d_ts_pct | Float64 | Opponent true-shooting percentage. |
rim_pct | Float64 | Field-goal percentage on rim attempts. |
d_rim_pct | Float64 | Opponent field-goal percentage on rim attempts. |
mid_pct | Float64 | Field-goal percentage on mid-range attempts. |
d_mid_pct | Float64 | Opponent field-goal percentage on mid-range attempts. |
tp_rate | Float64 | Three-point attempts as a share of field-goal attempts. |
d_tp_rate | Float64 | Opponent three-point attempts as a share of their field-goal attempts. |
rim_rate | Float64 | Rim attempts as a share of field-goal attempts. |
d_rim_rate | Float64 | Opponent rim attempts as a share of their field-goal attempts. |
mid_rate | Float64 | Mid-range attempts as a share of field-goal attempts. |
d_mid_rate | Float64 | Opponent mid-range attempts as a share of their field-goal attempts. |
ft_rate | Float64 | Ft rate. |
d_ft_rate | Float64 | Opponent free-throw attempts relative to their field-goal attempts. |
ast_rate | Float64 | Share of the team's made field goals that were assisted. |
d_ast_rate | Float64 | Share of opponent made field goals that were assisted. |
to_rate | Float64 | To rate. |
d_to_rate | Float64 | Opponent turnovers as a share of their possessions (forced-turnover rate). |
blk_rate | Float64 | Share of opponent two-point attempts the team blocked. |
o_blk_rate | Float64 | Share of the team's own two-point attempts blocked by the opponent. |
orb_pct | Float64 | Offensive rebound percentage. |
drb_pct | Float64 | Defensive rebound percentage. |
time_per_poss | Float64 | Average seconds per offensive possession. |
d_time_per_poss | Float64 | Average seconds per defensive possession. |
contest_id | String | stats.ncaa.org contest (game) identifier. |
home_ncaa_team_id | String | stats.ncaa.org team identifier for the home team. |
home_espn_team_id | String | ESPN home team id (NA for bart-only rows). |
away_ncaa_team_id | String | stats.ncaa.org team identifier for the away team. |
away_espn_team_id | String | ESPN away team id (NA for bart-only rows). |
team_ncaa_team_id | String | stats.ncaa.org team identifier of the team the row belongs to. |
team_espn_team_id | String | ESPN team identifier of the team, via the NCAA-to-ESPN crosswalk. |
espn_game_id | String | ESPN game id (NA for bart-only rows). |
season | Int64 | Season year. |
load_ncaa_mbb_team_box(seasons=2024)
load_ncaa_mbb_rosters
Release: ncaa_mbb_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_mbb_rosters/ncaa_mbb_rosters_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
season | Int64 | Season year. |
team | String | Team-side label or team identifier. |
player | String | Player name. |
games | Int64 | Games played. |
load_ncaa_mbb_rosters(seasons=2024)
load_ncaa_mbb_team_rosters
Release: ncaa_mbb_team_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_mbb_team_rosters/ncaa_mbb_team_rosters_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
season | Int64 | Season year. |
team_id | String | Unique team identifier. |
team | String | Team-side label or team identifier. |
player_id | String | Unique player identifier. |
player | String | Player name. |
clean_name | String | Normalized (diacritics- and punctuation-cleaned) player name used to join across the NCAA datasets. |
name | String | Display name. |
jersey | String | Jersey number worn by the player. |
class | String | College class / draft eligibility note. |
position | String | Listed roster position (G, F, C, etc.). |
height | String | Player height (string e.g. '6-2' or inches). |
ht_inches | Int64 | Player height converted to total inches from the stats.ncaa.org roster listing. |
hometown | String | Player hometown. |
high_school | String | High school |
gp | String | Games played. |
gs | String | Games started. |
load_ncaa_mbb_team_rosters(seasons=2024)
load_ncaa_mbb_team_ids
Release: ncaa_mbb_team_ids · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_mbb_team_ids/ncaa_mbb_team_ids_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
team | String | Team-side label or team identifier. |
conference | String | Conference name. |
id | String | Id. |
season | Int64 | Season year. |
load_ncaa_mbb_team_ids(seasons=2024)
load_ncaa_mbb_possessions
Release: ncaa_mbb_possessions · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_mbb_possessions/ncaa_mbb_possessions_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
game_date | String | Game date (YYYY-MM-DD). |
home | String | Home. |
away | String | Away record. |
period | Int64 | Period of the game (1-4 quarters; 5+ for OT). |
poss_num | Int64 | Sequential possession number within the game. |
poss_team | String | Name of the team in possession. |
home_1 | String | Name of the home team's on-floor player in lineup slot 1 for the possession, from the substitution walk-forward. |
home_2 | String | Name of the home team's on-floor player in lineup slot 2 for the possession, from the substitution walk-forward. |
home_3 | String | Name of the home team's on-floor player in lineup slot 3 for the possession, from the substitution walk-forward. |
home_4 | String | Name of the home team's on-floor player in lineup slot 4 for the possession, from the substitution walk-forward. |
home_5 | String | Name of the home team's on-floor player in lineup slot 5 for the possession, from the substitution walk-forward. |
away_1 | String | Name of the away team's on-floor player in lineup slot 1 for the possession, from the substitution walk-forward. |
away_2 | String | Name of the away team's on-floor player in lineup slot 2 for the possession, from the substitution walk-forward. |
away_3 | String | Name of the away team's on-floor player in lineup slot 3 for the possession, from the substitution walk-forward. |
away_4 | String | Name of the away team's on-floor player in lineup slot 4 for the possession, from the substitution walk-forward. |
away_5 | String | Name of the away team's on-floor player in lineup slot 5 for the possession, from the substitution walk-forward. |
home_score | Int64 | Home team score at the time of the play. |
away_score | Int64 | Away team score at the time of the play. |
pts | Int64 | Points scored. |
is_assisted | Int64 | 1 when the possession's made field goal was assisted, else 0. |
is_transition | Int64 | 1 for transition possessions, else 0. |
is_garbage_time | Int64 | 1 for possessions in garbage time under the score-margin and clock rule, else 0. |
start_event_type | String | Event type that opened the possession (e.g., a defensive rebound or a made-basket inbound). |
first_shot_time | Int64 | Clock time in seconds at the possession's first shot attempt, from the possession segmentation engine. |
first_shot_type | String | Shot class of the possession's first attempt (rim, mid-range, or three). |
last_event_time | Int64 | Clock time in seconds at the possession's final event. |
last_event_type | String | Event type that ended the possession (e.g., a made shot, turnover, or defensive rebound). |
contest_id | String | stats.ncaa.org contest (game) identifier. |
home_ncaa_team_id | String | stats.ncaa.org team identifier for the home team. |
home_espn_team_id | String | ESPN home team id (NA for bart-only rows). |
away_ncaa_team_id | String | stats.ncaa.org team identifier for the away team. |
away_espn_team_id | String | ESPN away team id (NA for bart-only rows). |
poss_team_ncaa_team_id | String | stats.ncaa.org team identifier of the team in possession. |
poss_team_espn_team_id | String | ESPN team identifier of the team in possession, via the NCAA-to-ESPN crosswalk. |
home_1_player_id | String | stats.ncaa.org player identifier for the home slot-1 on-floor player. |
home_1_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the home slot-1 on-floor player. |
home_2_player_id | String | stats.ncaa.org player identifier for the home slot-2 on-floor player. |
home_2_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the home slot-2 on-floor player. |
home_3_player_id | String | stats.ncaa.org player identifier for the home slot-3 on-floor player. |
home_3_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the home slot-3 on-floor player. |
home_4_player_id | String | stats.ncaa.org player identifier for the home slot-4 on-floor player. |
home_4_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the home slot-4 on-floor player. |
home_5_player_id | String | stats.ncaa.org player identifier for the home slot-5 on-floor player. |
home_5_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the home slot-5 on-floor player. |
away_1_player_id | String | stats.ncaa.org player identifier for the away slot-1 on-floor player. |
away_1_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the away slot-1 on-floor player. |
away_2_player_id | String | stats.ncaa.org player identifier for the away slot-2 on-floor player. |
away_2_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the away slot-2 on-floor player. |
away_3_player_id | String | stats.ncaa.org player identifier for the away slot-3 on-floor player. |
away_3_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the away slot-3 on-floor player. |
away_4_player_id | String | stats.ncaa.org player identifier for the away slot-4 on-floor player. |
away_4_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the away slot-4 on-floor player. |
away_5_player_id | String | stats.ncaa.org player identifier for the away slot-5 on-floor player. |
away_5_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the away slot-5 on-floor player. |
espn_game_id | String | ESPN game id (NA for bart-only rows). |
season | Int64 | Season year. |
load_ncaa_mbb_possessions(seasons=2024)
load_ncaa_mbb_lineups
Release: ncaa_mbb_lineups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_mbb_lineups/ncaa_mbb_lineups_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
lineup_key | String | Sorted player-code key identifying the five-player unit on the floor (hoop-explorer convention). |
date | String | Date in YYYY-MM-DD format. |
location_type | String | Whether the lineup's team was the Home or Away side in the game. |
team | String | Team-side label or team identifier. |
team_year | Int64 | Season year of the team-season the lineup row belongs to. |
opponent | String | Opponent. |
lineup_id | String | Sorted-name identifier of the five-player lineup, joined from the on-floor player names. |
start_min | Float64 | Game minute at which the stint began. |
end_min | Float64 | Game minute at which the stint ended. |
duration_mins | Float64 | Length of the stint in minutes. |
player_1 | String | Name of the first player (in sorted order) of the five-player lineup. |
player_2 | String | Name of the second player (in sorted order) of the five-player lineup. |
player_3 | String | Name of the third player (in sorted order) of the five-player lineup. |
player_4 | String | Name of the fourth player (in sorted order) of the five-player lineup. |
player_5 | String | Name of the fifth player (in sorted order) of the five-player lineup. |
players_in | String | Delimited names of the players substituted in at the start of the stint. |
players_out | String | Delimited names of the players substituted out at the end of the stint. |
start_scored | Int64 | Team points scored at the moment the stint began. |
start_allowed | Int64 | Points allowed at the moment the stint began. |
end_scored | Int64 | Team points scored at the moment the stint ended. |
end_allowed | Int64 | Points allowed at the moment the stint ended. |
start_diff | Int64 | Score margin (scored minus allowed) when the stint began. |
end_diff | Int64 | Score margin (scored minus allowed) when the stint ended. |
player_count_error | Null | Flag marking stints where the reconciled on-floor count was not exactly five players (all-null when clean). |
poss | Int64 | Poss. |
pts | Int64 | Points scored. |
plus_minus | Int64 | Plus/minus point differential while on court. |
fga | Int64 | Field goal attempts. |
fgm | Int64 | Field goals made. |
rima | Int64 | Rim shots (dunks, layups, hooks, tip-ins) attempted by the lineup during the stint. |
rimm | Int64 | Rim shots made by the lineup during the stint. |
rim_ast | Int64 | Assisted rim makes by the lineup during the stint. |
mida | Int64 | Mid-range shots attempted by the lineup during the stint. |
midm | Int64 | Mid-range shots made by the lineup during the stint. |
mid_ast | Int64 | Assisted mid-range makes by the lineup during the stint. |
fg2a | Int64 | Two-point field goals attempted by the lineup during the stint. |
fg2m | Int64 | Two-point field goals made by the lineup during the stint. |
tpa | Int64 | Three-pointers attempted by the lineup during the stint. |
tpm | Int64 | Three-pointers made by the lineup during the stint. |
tp_ast | Int64 | Assisted three-point makes by the lineup during the stint. |
fta | Int64 | Free throw attempts. |
ftm | Int64 | Free throws made. |
orb | Int64 | Offensive rebounds by the lineup during the stint. |
drb | Int64 | Defensive rebounds by the lineup during the stint. |
to | Int64 | To. |
stl | Int64 | Steals. |
blk | Int64 | Blocks. |
ast | Int64 | Assists. |
foul | Int64 | Fouls committed by the lineup during the stint. |
opp_poss | Int64 | Opponent possessions while the lineup was on the floor during the stint. |
opp_pts | Int64 | Opponent points. |
opp_plus_minus | Int64 | Opponent scoring margin while the lineup was on the floor during the stint. |
opp_fga | Int64 | Opponent field-goal attempts while the lineup was on the floor during the stint. |
opp_fgm | Int64 | Opponent field goals made while the lineup was on the floor during the stint. |
opp_rima | Int64 | Opponent rim shots attempted while the lineup was on the floor during the stint. |
opp_rimm | Int64 | Opponent rim shots made while the lineup was on the floor during the stint. |
opp_rim_ast | Int64 | Opponent assisted rim makes while the lineup was on the floor during the stint. |
opp_mida | Int64 | Opponent mid-range shots attempted while the lineup was on the floor during the stint. |
opp_midm | Int64 | Opponent mid-range shots made while the lineup was on the floor during the stint. |
opp_mid_ast | Int64 | Opponent assisted mid-range makes while the lineup was on the floor during the stint. |
opp_fg2a | Int64 | Opponent two-point attempts while the lineup was on the floor during the stint. |
opp_fg2m | Int64 | Opponent two-point makes while the lineup was on the floor during the stint. |
opp_tpa | Int64 | Opponent three-point attempts while the lineup was on the floor during the stint. |
opp_tpm | Int64 | Opponent three-point makes while the lineup was on the floor during the stint. |
opp_tp_ast | Int64 | Opponent assisted three-point makes while the lineup was on the floor during the stint. |
opp_fta | Int64 | Opponent free-throw attempts while the lineup was on the floor during the stint. |
opp_ftm | Int64 | Opponent free throws made while the lineup was on the floor during the stint. |
opp_orb | Int64 | Opponent offensive rebounds while the lineup was on the floor during the stint. |
opp_drb | Int64 | Opponent defensive rebounds while the lineup was on the floor during the stint. |
opp_to | Int64 | Opponent turnovers while the lineup was on the floor during the stint. |
opp_stl | Int64 | Opponent steals while the lineup was on the floor during the stint. |
opp_blk | Int64 | Opponent blocks while the lineup was on the floor during the stint. |
opp_ast | Int64 | Opponent assists while the lineup was on the floor during the stint. |
opp_foul | Int64 | Opponent fouls committed while the lineup was on the floor during the stint. |
stint_num | Int64 | Sequential on-floor stint number for the lineup within the game. |
contest_id | String | stats.ncaa.org contest (game) identifier. |
season | Int64 | Season year. |
load_ncaa_mbb_lineups(seasons=2024)
load_ncaa_mbb_matchup_stints
Release: ncaa_mbb_matchup_stints · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_mbb_matchup_stints/ncaa_mbb_matchup_stints_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
contest_id | String | stats.ncaa.org contest (game) identifier. |
season | Int64 | Season year. |
game_date | String | Game date (YYYY-MM-DD). |
home | String | Home. |
away | String | Away record. |
game_stint_num | Int64 | Sequential stint number within the game, incremented at every substitution by either team. |
period | Int64 | Period of the game (1-4 quarters; 5+ for OT). |
start_seconds | Int64 | Elapsed game seconds at which the stint began. |
end_seconds | Int64 | Elapsed game seconds at which the stint ended. |
duration_seconds | Int64 | Duration of the lineup stint in seconds. |
matchup_key | String | Combined home-plus-away lineup key identifying the ten-player matchup on the floor. |
home_lineup_key | String | Sorted player-code key for the home five on the floor. |
away_lineup_key | String | Sorted player-code key for the away five on the floor. |
home_lineup | String | Delimited names of the home five on the floor during the stint. |
away_lineup | String | Delimited names of the away five on the floor during the stint. |
end_home_score | Int64 | Home team score when the stint ended. |
end_away_score | Int64 | Away team score when the stint ended. |
n_events | Int64 | Number of play-by-play events falling within the stint. |
n_possessions | Int64 | Number of possessions falling within the stint. |
start_home_score | Int64 | Home team score when the stint began. |
start_away_score | Int64 | Away team score when the stint began. |
home_pts | Int64 | Points scored by the home team during the stint. |
away_pts | Int64 | Points scored by the away team during the stint. |
home_1 | String | Name of the home team's on-floor player in lineup slot 1 for the stint. |
home_2 | String | Name of the home team's on-floor player in lineup slot 2 for the stint. |
home_3 | String | Name of the home team's on-floor player in lineup slot 3 for the stint. |
home_4 | String | Name of the home team's on-floor player in lineup slot 4 for the stint. |
home_5 | String | Name of the home team's on-floor player in lineup slot 5 for the stint. |
away_1 | String | Name of the away team's on-floor player in lineup slot 1 for the stint. |
away_2 | String | Name of the away team's on-floor player in lineup slot 2 for the stint. |
away_3 | String | Name of the away team's on-floor player in lineup slot 3 for the stint. |
away_4 | String | Name of the away team's on-floor player in lineup slot 4 for the stint. |
away_5 | String | Name of the away team's on-floor player in lineup slot 5 for the stint. |
load_ncaa_mbb_matchup_stints(seasons=2024)
load_ncaa_mbb_shots
Release: ncaa_mbb_shots · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_mbb_shots/ncaa_mbb_shots_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
season | Int64 | Season year. |
team_id | String | Unique team identifier. |
shooter_id | String | Unique identifier for shooter. |
shot_x | Float64 | Court x-coordinate of the attempt in feet, decoded from the stats.ncaa.org shot-chart map. |
shot_y | Float64 | Court y-coordinate of the attempt in feet, decoded from the stats.ncaa.org shot-chart map. |
dist_ft | Float64 | Shot distance from the basket in feet. |
shot_zone | String | Labeled zone of the attempt (rim, mid-range, or three-point). |
shot_type | String | Shot type label (e.g. 'Jump Shot', 'Layup'). |
made | Boolean | Whether the shot was made. |
point_value | Int64 | Point value of the attempt (2 or 3). |
period | Null | Period of the game (1-4 quarters; 5+ for OT). |
sec_left | Null | Seconds remaining in the period when the shot was taken (all-null in current captures). |
source | String | News source. |
contest_id | String | stats.ncaa.org contest (game) identifier. |
ncaa_team_id | String | stats.ncaa.org team identifier of the shooting team. |
espn_team_id | String | ESPN team id (canonical key). |
shooter_player_id | String | stats.ncaa.org player identifier of the shooter. |
shooter_clean_name | String | Normalized (diacritics- and punctuation-cleaned) name of the shooter. |
espn_game_id | String | ESPN game id (NA for bart-only rows). |
load_ncaa_mbb_shots(seasons=2024)
load_ncaa_mbb_rapm_within_team
Release: ncaa_mbb_rapm_within_team · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_mbb_rapm_within_team/ncaa_mbb_rapm_within_team_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
team | String | Team-side label or team identifier. |
player_code | String | Short unique-within-team player code generated from the player's name (hoop-explorer convention). |
rapm_off | Float64 | Ridge-regressed offensive RAPM per 100 possessions, estimated relative to the player's own teammates. |
rapm_def | Float64 | Ridge-regressed defensive RAPM per 100 possessions relative to teammates; positive means good defense. |
team_off_poss | Float64 | Team offensive possessions underlying the within-team fit. |
num_players | Int64 | Number of players in the team's RAPM design matrix. |
rapm_net | Float64 | Net RAPM — the sum of the offensive and defensive components, per 100 possessions. |
season | Int32 | Season year. |
player_id | String | Unique player identifier. |
team_id | String | Unique team identifier. |
person_id | String | Unique player identifier (V3 endpoints). |
load_ncaa_mbb_rapm_within_team(seasons=2024)
load_ncaa_mbb_rapm
Release: ncaa_mbb_rapm · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_mbb_rapm/ncaa_mbb_rapm_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
season | Int32 | Season as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted. |
player_id | String | Unique player identifier. |
person_id | String | Unique player identifier (V3 endpoints). |
player | String | Player name. |
team | String | Team-side label or team identifier. |
orapm | Float64 | Offensive regularized adjusted plus-minus: points contributed per 100 possessions on offense, adjusted for the other 9 players on the floor. |
drapm | Float64 | Defensive regularized adjusted plus-minus: points prevented per 100 possessions on defense (higher is better defense), adjusted for the other 9 players on the floor. |
rapm_net | Float64 | Net RAPM (orapm plus drapm): overall point contribution per 100 possessions. Verified against live data: rapm_net == orapm + drapm exactly. |
off_poss | Int64 | Offensive possessions the player was on court for; the regression weight behind orapm. |
def_poss | Int64 | Defensive possessions the player was on court for; the regression weight behind drapm. |
estimand | String | Fit-scope tag for the RAPM model that produced this row (observed value: 'league', a Division I-wide fit) -- one row per player-season, not per estimand. |
load_ncaa_mbb_rapm(seasons=2024)