A query to this endpoint without a date parameter will return the current ELO rankings and ratings for all active teams within the competition level. Passing a date parameter will return an ELO rankings and ratings "snapshot" for that date if data is available. Passing a team parameter (in conjunction with season) will return a series of data points and detailed changes in team ELO ratings over the course of the season.
| Name | Required | Type | Description |
|---|
key |
required |
string |
A valid API key in XXXX-XXXXXX format |
format |
optional |
string |
The preferred data format: xml, json or php (presented as a SimpleXML object). The default is json |
max |
optional |
number |
The number of results per page to return. The default value is 100, and the maximum allowed parameter value is 1000. This value is echoed back as Max_Results in the meta block |
page |
optional |
number |
The pagination page number. This value is echoed back as Page in the meta block. The meta block also contains the Total_Results of the query. If there are further results, a fully-formed Next_Page URI containing a pre-filled &page=X value will be returned |
team |
optional |
number |
A valid team ID code. A list of teams can be retrieved from the teams endpoint |
season |
optional |
number |
A valid season ID code, formatted as the year that a season completes, in YYYY format. A list of available seasons can be retrieved from the seasons endpoint |
date |
optional |
string |
Returns a snapshot of ELO ratings and rankings for that date. The API will attempt to translate the date, but YYYYMMDD or YYYY-MM-DD are preferred. Entering a date will supercede the season parameter |
| Name | Required | Type | Description |
|---|
Date |
|
date |
The date the ELO rankings were taken, in YYYY-MM-DD format |
Season_ID |
|
number |
The seasons ID of the season, in YYYY format |
TID |
|
string |
The teams ID of the relevant team |
Team |
|
string |
The teams name of the relevant team |
TeamAbbrev |
|
string |
The teams abbreviation of the relevant team |
ELO |
|
number |
The ELO rating of the team |
ELORank |
|
number |
The ELO ranking number of the team |
lastgame |
|
object |
Contains games metadata for the last game the team played |
GameDay |
|
date |
The date of this game, in YYYY-MM-DD format |
Visitor_ID |
|
number |
The teams ID of the visting team |
Visitor |
|
string |
The teams name of the visiting team |
ScoreVis |
|
number |
The visiting team's score in the relevant game |
Home_ID |
|
number |
The teams ID of the home team |
Home |
|
string |
The teams name of the home team |
ScoreHome |
|
number |
The home team's score in the relevant game |
GameStatus |
|
string |
The period and time of the game, or Final. Returns empty value if game has not started |
WinOrLoss |
|
string |
Returns W or L |
ELO_BeforeGame |
|
number |
The ELO rating of the team before the game |
ELO_Change |
|
number |
The + or - adjustment to the team's ELO rating after the result |
ELO_KFactor |
|
number |
The K-Factor used in weighing the game's significance |
ELO_Adjust |
|
string |
The situational game adjustment to the ELO formula |
ELO_WinExpectancy |
|
number |
The ELO win expectancy for the team |
Forecast_FavoriteID |
|
number |
The teams ID of the computer prediction favorite |
Forecast_Favorite |
|
string |
The teams name of the computer prediciton favorite |
Forecast_Correct |
|
boolean |
Whether the computer prediction forecast was correct, in Y/N format |
ELORank_Tied |
|
boolean |
Whether the ELO ranking is tied with another team, in Y/N format |
