get_ratings

2 creditsBasic lookupPOST /v1/get_ratings

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).

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": 2024
}'

Response

json

{
  "season": 2024,
  "ratings": [
    {
      "rank": 1,
      "team_id": "2",
      "abbrev": "BOS",
      "team": "Boston Celtics",
      "rating": 1747.4,
      "as_of": "2024-06-18T00:30:00.000Z"
    },
    {
      "rank": 2,
      "team_id": "6",
      "abbrev": "DAL",
      "team": "Dallas Mavericks",
      "rating": 1681.4,
      "as_of": "2024-06-18T00:30:00.000Z"
    },
    {
      "rank": 3,
      "team_id": "16",
      "abbrev": "MIN",
      "team": "Minnesota Timberwolves",
      "rating": 1660.6,
      "as_of": "2024-05-31T00:30:00.000Z"
    }
  ],
  "count": 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."
}