Updated

Historical NBA Elo

API Access

Access dataset files directly from scripts, code, or AI agents.

Browse dataset files
Dataset Files

Each file has a stable URL (r-link) that you can use directly in scripts, apps, or AI agents. These URLs are permanent and safe to hardcode.

/fivethirtyeight/nba-elo/
https://datahub.io/fivethirtyeight/nba-elo/_r/-/README.md
https://datahub.io/fivethirtyeight/nba-elo/_r/-/data/nbaallelo.csv
https://datahub.io/fivethirtyeight/nba-elo/_r/-/datapackage.json
Key Files

Start with these files — they give you everything you need to understand and access the dataset.

datapackage.jsonmetadata & schema
https://datahub.io/fivethirtyeight/nba-elo/_r/-/datapackage.json
README.mddocumentation
https://datahub.io/fivethirtyeight/nba-elo/_r/-/README.md
Typical Usage
  1. 1. Fetch datapackage.json to inspect schema and resources
  2. 2. Download data resources listed in datapackage.json
  3. 3. Read README.md for full context

Data Previews

nbaallelo

Loading data...

Schema

nametypeformat
gameorderintegerdefault
game_idstringdefault
lg_idstringdefault
_iscopyintegerdefault
year_idintegerdefault
date_gamestringdefault
seasongameintegerdefault
is_playoffsintegerdefault
team_idstringdefault
fran_idstringdefault
ptsintegerdefault
elo_inumberdefault
elo_nnumberdefault
win_equivnumberdefault
opp_idstringdefault
opp_franstringdefault
opp_ptsintegerdefault
opp_elo_inumberdefault
opp_elo_nnumberdefault
game_locationstringdefault
game_resultstringdefault
forecastnumberdefault
notesstringdefault

Data Files

FileDescriptionSizeLast modifiedDownload
nbaallelo
18.2 MBabout 2 months ago
nbaallelo
FilesSizeFormatCreatedUpdatedLicenseSource
118.2 MBcsvabout 2 months agoFiveThirtyEight - Nba Elo

Historical NBA Elo

This directory contains the data behind the Complete History Of The NBA interactive. Data updated periodically. Game information is from Basketball-Reference.com.

In the data file nbaallelo.csv are the following variables:

HeaderDefinition
gameorderPlay order of game in NBA history
game_idUnique ID for each game
lg_idWhich league the game was played in
_iscopyEach row of data is tied to a single team for a single game, so _iscopy flags if this game_id has already occured for the opposing team in the same matchup
year_idSeason id, named based on year in which the season ended
date_gameGame date
is_playoffsFlag for playoff games
team_idThree letter code for team name, from Basketball Reference
fran_idFranchise id. Multiple team_ids can fall under the same fran_id due to name changes or moves. Interactive is grouped by fran_id.
ptsPoints scored by team
elo_iTeam elo entering the game
elo_nTeam elo following the game
win_equivEquivalent number of wins in a 82-game season for a team of elo_n quality
opp_idTeam id of opponent
opp_franFranchise id of opponent
opp_ptsPoints scored by opponent
opp_elo_iOpponent elo entering the game
opp_elo_nOpponent elo following the game
game_locationHome (H), away (A), or neutral (N)
game_resultWin or loss for team in the team_id column
forecastElo-based chances of winning for the team in the team_id column, based on elo ratings and game location
notesAdditional information

This dataset was scraped from FiveThirtyEight - nba-elo