API Access
Access dataset files directly from scripts, code, or AI agents.
Browse dataset files
API Access
Access dataset files directly from scripts, code, or AI agents.
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.json— metadata & schema
https://datahub.io/fivethirtyeight/nba-elo/_r/-/datapackage.json
README.md— documentation
https://datahub.io/fivethirtyeight/nba-elo/_r/-/README.md
Typical Usage
- 1. Fetch datapackage.json to inspect schema and resources
- 2. Download data resources listed in datapackage.json
- 3. Read README.md for full context
Data Files
Explore with AInbaallelo
| Field | Type | Format |
|---|---|---|
| gameorder | integer | default |
| game_id | string | default |
| lg_id | string | default |
| _iscopy | integer | default |
| year_id | integer | default |
| date_game | string | default |
| seasongame | integer | default |
| is_playoffs | integer | default |
| team_id | string | default |
| fran_id | string | default |
| pts | integer | default |
| elo_i | number | default |
| elo_n | number | default |
| win_equiv | number | default |
| opp_id | string | default |
| opp_fran | string | default |
| opp_pts | integer | default |
| opp_elo_i | number | default |
| opp_elo_n | number | default |
| game_location | string | default |
| game_result | string | default |
| forecast | number | default |
| notes | string | default |
Download
Download CSVAbout
- Last updated
- 12 March 2026
- Total rows
- ...
- Format
- CSV
- File size
- 18.2 MB
About this dataset
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:
| Header | Definition |
|---|---|
gameorder | Play order of game in NBA history |
game_id | Unique ID for each game |
lg_id | Which league the game was played in |
_iscopy | Each 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_id | Season id, named based on year in which the season ended |
date_game | Game date |
is_playoffs | Flag for playoff games |
team_id | Three letter code for team name, from Basketball Reference |
fran_id | Franchise id. Multiple team_ids can fall under the same fran_id due to name changes or moves. Interactive is grouped by fran_id. |
pts | Points scored by team |
elo_i | Team elo entering the game |
elo_n | Team elo following the game |
win_equiv | Equivalent number of wins in a 82-game season for a team of elo_n quality |
opp_id | Team id of opponent |
opp_fran | Franchise id of opponent |
opp_pts | Points scored by opponent |
opp_elo_i | Opponent elo entering the game |
opp_elo_n | Opponent elo following the game |
game_location | Home (H), away (A), or neutral (N) |
game_result | Win or loss for team in the team_id column |
forecast | Elo-based chances of winning for the team in the team_id column, based on elo ratings and game location |
notes | Additional information |
This dataset was scraped from FiveThirtyEight - nba-elo