get_ratings
2 creditsBasic lookupPOST /v1/get_ratings
Data refreshed · changelog
Our team Elo ratings, ranked
Use it when you want our Elo power ratings, ranked, as of the end of a season or today.
Parameters
seasonnumber | stringoptional- Season by the year it ends (default: the latest).
limitintegeroptional- Teams to return, best first (default 100; college has more than 300).
leagueenum: nba | wnba | ncaam | ncaaw | nbloptional- League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw, nbl.
Notes
- Over MCP, ask for it in plain English and the client calls
get_ratingsitself. Point any MCP client athttps://mcp.dunkapi.com/mcp?key=YOUR_API_KEY. - Each call costs 2 credits, taken before it runs and refunded if the server errors.
- Not the call you need? Find the right call by what you are trying to answer.
Request
curl -X POST https://mcp.dunkapi.com/v1/get_ratings \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"season": 2026
}'Response
json
{
"season": 2026,
"ratings": [
{
"rank": 1,
"team_id": "18",
"abbrev": "NY",
"team": "New York Knicks",
"rating": 1807.7,
"as_of": "2026-06-14T00:30:00.000Z"
},
{
"rank": 2,
"team_id": "24",
"abbrev": "SA",
"team": "San Antonio Spurs",
"rating": 1768.5,
"as_of": "2026-06-14T00:30:00.000Z"
},
{
"rank": 3,
"team_id": "25",
"abbrev": "OKC",
"team": "Oklahoma City Thunder",
"rating": 1748.8,
"as_of": "2026-05-31T00:00:00.000Z"
}
],
"count": 30,
"total": 30,
"method": "Elo from every final game since the start of our data, with home advantage and a margin-of-victory multiplier; ratings regress a quarter of the way to the mean between seasons. 1500 is average; a 100-point gap is about a 64% favourite on a neutral floor."
}Response fields
seasonnumberratings[]array- List of objects
ratings[].ranknumberratings[].team_idstringratings[].abbrevstringratings[].teamstringratings[].ratingnumberratings[].as_ofstringcountnumbertotalnumbermethodstring
Used in
- NBA odds history: Each sportsbook's moneyline, spread and total for NBA games from 2013-14, with results against the line. Built for backtests. REST or MCP.
Related endpoints
list_games2 cr
Takes the team this one returns.
Games with scores by season, date, range or team
get_schedule2 cr
Takes the team this one returns.
Upcoming games with the median line across sportsbooks
list_teams1 cr
Filters by the same season and league.
Team ids, abbreviations and colours for a season
search_players1 cr
Filters by the same limit and league.
Find players by name
Try it
500 free credits every month: 250 calls to get_ratings, and no card.