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
leagueenum: mlb | ncaabaseoptional
League. Defaults to mlb. One of: mlb, ncaabase.

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

Response

json
{
  "season": 2025,
  "ratings": [
    {
      "rank": 1,
      "team_id": "19",
      "abbrev": "LAD",
      "team": "Los Angeles Dodgers",
      "rating": 1578.3,
      "as_of": "2025-11-02T00:00:00.000Z"
    },
    {
      "rank": 2,
      "team_id": "8",
      "abbrev": "MIL",
      "team": "Milwaukee Brewers",
      "rating": 1564.4,
      "as_of": "2025-10-18T00:38:00.000Z"
    },
    {
      "rank": 3,
      "team_id": "22",
      "abbrev": "PHI",
      "team": "Philadelphia Phillies",
      "rating": 1559.5,
      "as_of": "2025-10-09T22:08: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."
}

Response fields

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

Used in

  • MLB odds history: Each sportsbook's moneyline, run line and total for MLB games, with whether the favourite won and the total went over. Built for backtests. REST or MCP.

Related endpoints

Try it

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