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

Notes

Over MCP, ask for it in plain English and the client calls get_ratings itself. Point any MCP client at https://mcp.fastballapi.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.fastballapi.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": "19",
      "abbrev": "LAD",
      "team": "Los Angeles Dodgers",
      "rating": 1587.2,
      "as_of": "2024-10-31T00:08:00.000Z"
    },
    {
      "rank": 2,
      "team_id": "25",
      "abbrev": "SD",
      "team": "San Diego Padres",
      "rating": 1557,
      "as_of": "2024-10-12T00:08:00.000Z"
    },
    {
      "rank": 3,
      "team_id": "15",
      "abbrev": "ATL",
      "team": "Atlanta Braves",
      "rating": 1551.7,
      "as_of": "2024-10-03T00:30:00.000Z"
    }
  ],
  "count": 30,
  "method": "Elo from every final game in our data, with home advantage and a small margin multiplier; ratings regress a third of the way to the mean between seasons. 1500 is average; a 100-point gap is about a 64% favourite on a neutral field."
}