hoopR
Access Men's Basketball Play by Play Data

Package index
Search the hoopR package
Vignettes
Functions
1572
Source code
575
Man pages
338
Home
/
CRAN
/
hoopR
/
nba_alltimeleadersgrids: *Get NBA Stats API All-time Leaders Grid*

nba_alltimeleadersgrids: *Get NBA Stats API All-time Leaders Grid*
In hoopR: Access Men's Basketball Play by Play Data

View source: R/nba_stats_leaders.R

nba_alltimeleadersgridsR Documentation

Get NBA Stats API All-time Leaders Grid

Description

[Deprecated]

NBA Stats no longer returns stable data for this endpoint. This function is deprecated and now errors when called. Use nba_leagueleaders() instead. Note: stat_category = "Defense" was never supported upstream by this endpoint even before deprecation (#51).

[Deprecated]

NBA Stats no longer returns stable data for this endpoint. This function is deprecated and now errors when called. Use nba_leagueleaders() instead.

[Deprecated]

NBA Stats no longer returns stable data for this endpoint. This function is deprecated and now errors when called. Use nba_leagueleaders() instead.

Usage

nba_alltimeleadersgrids(
  league_id = "00",
  per_mode = "PerGame",
  season_type = "Regular Season",
  top_x = 10,
  ...
)

nba_assistleaders(
  league_id = "00",
  per_mode = "PerGame",
  player_or_team = "Team",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

nba_assisttracker(
  league_id = "00",
  per_mode = "PerGame",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

nba_homepageleaders(
  league_id = "00",
  game_scope = "Season",
  player_or_team = "Team",
  player_scope = "All Players",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  stat_category = "Points",
  ...
)

nba_homepagev2(
  league_id = "00",
  game_scope = "Season",
  player_or_team = "Team",
  player_scope = "All Players",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  stat_type = "Traditional",
  ...
)

nba_leaderstiles(
  league_id = "00",
  game_scope = "Season",
  player_or_team = "Team",
  player_scope = "All Players",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  stat = "PTS",
  ...
)

nba_defensehub(
  league_id = "00",
  game_scope = "Season",
  player_or_team = "Team",
  player_scope = "All Players",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

nba_leagueleaders(
  active_flag = "",
  league_id = "00",
  per_mode = "Totals",
  scope = "S",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  stat_category = "PTS",
  ...
)

nba_dunkscoreleaders(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  player_id = "",
  team_id = "",
  game_id = "",
  ...
)

nba_gravityleaders(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League

per_mode

Per Mode - PerGame, Totals

season_type

Season Type - Regular Season, Playoffs, All-Star

top_x

Top X

...

Additional arguments passed to an underlying function like httr.

player_or_team

Player or Team

season

Season - format 2020-21

game_scope

Game Scope - Season, Last 10, ,Yesterday, Finals

player_scope

Player Scope - All Players, Rookies

stat_category

Stat Category: Points, Rebounds, Assists, Defense, Clutch, Playmaking, Efficiency, Fast Break, Scoring Breakdown

stat_type

Stat Type - Traditional, Advanced, Tracking

stat

Stat - PTS, REB, AST, FG_PCT, FT_PCT, FG3_PCT, STL, BLK

active_flag

Active Flag

scope

Scope - RS, S, Rookies

player_id

Player ID filter (optional, leave empty for all players)

team_id

Team ID filter (optional, leave empty for all teams)

game_id

Game ID filter (optional, leave empty for all games)

Details

 nba_alltimeleadersgrids(league_id = '00')

 nba_assistleaders(league_id = '00', player_or_team = "Player")
 nba_assistleaders(league_id = '00', player_or_team = "Team")

  nba_assisttracker(league_id = '00')

 nba_homepageleaders(league_id = '00', player_or_team = "Player")
 nba_homepageleaders(league_id = '00', player_or_team = "Team")

 nba_homepagev2(league_id = '00', player_or_team = "Player")
 nba_homepagev2(league_id = '00', player_or_team = "Team")

 nba_leaderstiles(league_id = '00', player_or_team = "Player")
 nba_leaderstiles(league_id = '00', player_or_team = "Team")

(Possibly Deprecated) 

 nba_defensehub(league_id = '00', player_or_team = "Player")
 nba_defensehub(league_id = '00', player_or_team = "Team")

League Leaders 

 nba_leagueleaders(league_id = '00')

 nba_dunkscoreleaders(season = year_to_season(most_recent_nba_season() - 1))

 nba_gravityleaders(season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: ASTLeaders, BLKLeaders, DREBLeaders, FG3ALeaders, FG3MLeaders, FG3_PCTLeaders, FGALeaders, FGMLeaders, FG_PCTLeaders, FTALeaders, FTMLeaders, FT_PCTLeaders, GPLeaders, OREBLeaders, PFLeaders, PTSLeaders, REBLeaders, STLLeaders, TOVLeaders

GPLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
GP character Games played.
GP_RANK character
IS_ACTIVE_FLAG character

PTSLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
PTS character Points scored.
PTS_RANK character
IS_ACTIVE_FLAG character

ASTLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
AST character Assists.
AST_RANK character
IS_ACTIVE_FLAG character

STLLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
STL character Steals.
STL_RANK character
IS_ACTIVE_FLAG character

OREBLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
OREB character Offensive rebounds.
OREB_RANK character
IS_ACTIVE_FLAG character

DREBLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
DREB character Defensive rebounds.
DREB_RANK character
IS_ACTIVE_FLAG character

REBLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
REB character Total rebounds.
REB_RANK character
IS_ACTIVE_FLAG character

BLKLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
BLK character Blocks.
BLK_RANK character
IS_ACTIVE_FLAG character

FGMLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FGM character Field goals made.
FGM_RANK character
IS_ACTIVE_FLAG character

FGALeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FGA character Field goal attempts.
FGA_RANK character
IS_ACTIVE_FLAG character

FG_PCTLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FG_PCT character Field goal percentage (0-1).
FG_PCT_RANK character
IS_ACTIVE_FLAG character

TOVLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TOV character Turnovers.
TOV_RANK character
IS_ACTIVE_FLAG character

FG3MLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FG3M character Three-point field goals made.
FG3M_RANK character
IS_ACTIVE_FLAG character

FG3ALeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FG3A character Three-point field goal attempts.
FG3A_RANK character
IS_ACTIVE_FLAG character

FG3_PCTLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FG3_PCT character Three-point field goal percentage (0-1).
FG3_PCT_RANK character
IS_ACTIVE_FLAG character

PFLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
PF character Personal fouls.
PF_RANK character
IS_ACTIVE_FLAG character

FTMLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FTM character Free throws made.
FTM_RANK character
IS_ACTIVE_FLAG character

FTALeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FTA character Free throw attempts.
FTA_RANK character
IS_ACTIVE_FLAG character

FT_PCTLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FT_PCT character Free throw percentage (0-1).
FT_PCT_RANK character
IS_ACTIVE_FLAG character

Returns a named list of data frames: AssistLeaders

AssistLeaders

Columns as documented in the shared nba_assistleaders_assistleaders_schema table.

Returns a named list of data frames: AssistTracker

Returns a named list of data frames: HomePageLeaders, LeagueAverage, LeagueMax

HomePageLeaders

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
PTS character Points scored.
FG_PCT character Field goal percentage (0-1).
FG3_PCT character Three-point field goal percentage (0-1).
FT_PCT character Free throw percentage (0-1).
EFG_PCT character Effective field goal percentage (0-1).
TS_PCT character True shooting percentage (0-1).
PTS_PER48 character

LeagueAverage

col_name types description
PTS numeric Points scored.
FG_PCT numeric Field goal percentage (0-1).
FG3_PCT numeric Three-point field goal percentage (0-1).
FT_PCT numeric Free throw percentage (0-1).
EFG_PCT numeric Effective field goal percentage (0-1).
TS_PCT numeric True shooting percentage (0-1).
PTS_PER48 numeric

LeagueMax

Same columns as the LeagueAverage table above.

Returns a named list of data frames: HomePageStat1, HomePageStat2, HomePageStat3, HomePageStat4, HomePageStat5, HomePageStat6, HomePageStat7, HomePageStat8

HomePageStat1

Columns as documented in the shared nba_homepagev2_homepagestat1_schema table.

HomePageStat2

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
REB character Total rebounds.

HomePageStat3

Columns as documented in the shared nba_assistleaders_assistleaders_schema table.

HomePageStat4

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
STL character Steals.

HomePageStat5

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
FG_PCT character Field goal percentage (0-1).

HomePageStat6

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
FT_PCT character Free throw percentage (0-1).

HomePageStat7

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
FG3_PCT character Three-point field goal percentage (0-1).

HomePageStat8

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
BLK character Blocks.

Returns a named list of data frames: AllTimeSeasonHigh, LastSeasonHigh, LeadersTiles, LowSeasonHigh,

LeadersTiles

Columns as documented in the shared nba_homepagev2_homepagestat1_schema table.

AllTimeSeasonHigh

col_name types description
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
SEASON_YEAR character Season year string ('YYYY-YY' format).
PTS character Points scored.

LastSeasonHigh

Columns as documented in the shared nba_homepagev2_homepagestat1_schema table.

LowSeasonHigh

Same columns as the AllTimeSeasonHigh table above.

Returns a named list of data frames: DefenseHubStat1, DefenseHubStat10, DefenseHubStat2, DefenseHubStat3, DefenseHubStat4, DefenseHubStat5, DefenseHubStat6, DefenseHubStat7, DefenseHubStat8, DefenseHubStat9

Returns a named list of data frames: LeagueLeaders

LeagueLeaders

col_name types description
PLAYER_ID character Unique player identifier.
RANK character Rank.
PLAYER character Player.
TEAM_ID character Unique team identifier.
TEAM character Team-side label or team identifier.
GP character Games played.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.
EFF character Eff.
AST_TOV character
STL_TOV character

Returns a named list of data frames: DunkScoreLeaders

DunkScoreLeaders

col_name types description
game_id character Unique game identifier.
game_date character Game date (YYYY-MM-DD).
matchup character Matchup.
period character Period of the game (1-4 quarters; 5+ for OT).
game_clock_time character Time / clock value.
event_num character Sequential event number within the game (V2 PBP).
player_id character Unique player identifier.
player_name character Player name.
first_name character Player's first name.
last_name character Player's last name.
team_id character Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
dunk_score character Dunk score.
jump_subscore character Jump subscore.
power_subscore character Power subscore.
style_subscore character Style subscore.
defensive_contest_subscore character Defensive contest subscore.
max_ball_height character Max ball height.
ball_speed_through_rim character Ball speed through rim.
player_vertical character Player vertical.
hang_time character Time / clock value.
takeoff_distance character Takeoff distance.
reverse_dunk character Reverse dunk.
dunk360 character Dunk360.
through_the_legs character Through the legs.
alley_oop character Alley oop.
tip_in character Tip in.
self_oop character Self oop.
player_rotation character Player rotation.
player_lateral_speed character Player lateral speed.
ball_distance_traveled character Ball distance traveled.
ball_reach_back character Ball reach back.
total_ball_acceleration character Total ball acceleration.
dunking_hand character Dunking hand.
jumping_foot character Jumping foot.
pass_length character Pass length.
catching_hand character Catching hand.
catch_distance character Catch distance.
lateral_catch_distance character Lateral catch distance.
passer_id character Unique identifier for passer.
passer_name character Passer name.
passer_first_name character Passer first name.
passer_last_name character Passer last name.
pass_release_point character Pass release point.
shooter_id character Unique identifier for shooter.
shooter_name character Shooter name (for shot events).
shooter_first_name character Shooter first name.
shooter_last_name character Shooter last name.
shot_release_point character Shot release point.
shot_length character Shot length.
defensive_contest_level character Defensive contest level.
possible_attempted_charge character Possible attempted charge.
video_available character Video available.

Returns a named list of data frames: GravityLeaders

GravityLeaders

col_name types description
playerid character Playerid.
firstname character Firstname.
lastname character Lastname.
teamid character Teamid.
teamabbreviation character Teamabbreviation.
teamname character Teamname.
teamcity character Teamcity.
frames character Frames.
gravityscore character Gravityscore.
avggravityscore character Avggravityscore.
onballperimeterframes character Onballperimeterframes.
onballperimetergravityscore character Onballperimetergravityscore.
avgonballperimetergravityscore character Avgonballperimetergravityscore.
offballperimeterframes character Offballperimeterframes.
offballperimetergravityscore character Offballperimetergravityscore.
avgoffballperimetergravityscore character Avgoffballperimetergravityscore.
onballinteriorframes character Onballinteriorframes.
onballinteriorgravityscore character Onballinteriorgravityscore.
avgonballinteriorgravityscore character Avgonballinteriorgravityscore.
offballinteriorframes character Offballinteriorframes.
offballinteriorgravityscore character Offballinteriorgravityscore.
avgoffballinteriorgravityscore character Avgoffballinteriorgravityscore.
gamesplayed character Gamesplayed.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
pts character Points scored.
reb character Total rebounds.
ast character Assists.

Author(s)

Saiem Gilani


hoopR documentation built on Aug. 25, 2026, 9:07 a.m.

Related to nba_alltimeleadersgrids in hoopR...

hoopR index
Package overview README.md

R Package Documentation

rdrr.io home R language documentation Run R code online

Browse R Packages

CRAN packages Bioconductor packages R-Forge packages GitHub packages

We want your feedback!

Note that we can't provide technical support on individual packages. You should contact the package authors for that.
GitHub issue tracker
ian@mutexlabs.com
Personal blog

 
Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.

Close