Skip to content

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_ratings itself. Point any MCP client at https://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

seasonnumber
ratings[]array
List of objects
ratings[].ranknumber
ratings[].team_idstring
ratings[].abbrevstring
ratings[].teamstring
ratings[].ratingnumber
ratings[].as_ofstring
countnumber
totalnumber
methodstring

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

Try it

500 free credits every month: 250 calls to get_ratings, and no card.