Skip to content

Elo rating

also: Elo · team rating

Our team rating, updated after every game from the score and where it was played, and pulled toward average each offseason.

Formula
expected win = 1 / (1 + 10^(-(rating diff + home advantage) / 400))

Every team starts a season near its last rating. A win moves it up by how surprising the result was, scaled by a margin-of-victory multiplier so a blowout counts for more than a one-point game. Home court is added to the home team's side before the expectation is computed.

Between seasons we regress each rating a quarter of the way back to the mean, because rosters change. The ratings run for the NBA, the WNBA and both college leagues from every game we hold.

The common mistake

Elo knows scores, not rosters. A star injury or a trade shows up only after the games, so treat a rating as a prior, not a lineup-aware forecast.

The data behind it

Elo rating comes from NBA shot chart data and NBA odds history. The x/y location of every NBA field goal attempt in the play-by-play since 2003-04, with distance, zone, result and expected points. REST or MCP.

Where to get it

Related

Elo rating from the API

500 free credits every month, no card. REST or MCP.

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
}'

get_ratings: every parameter and the full response.

Also from DunkAPI: player props history by sportsbook · today's props board · every dataset

Get a free key