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 | stringoptionalleagueenum: mlb | ncaabaseoptional- League. Defaults to mlb. One of: mlb, ncaabase.
Notes
- Over MCP, ask for it in plain English and the client calls
get_ratingsitself. Point any MCP client athttps://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
seasonnumberratings[]array- List of objects
ratings[].ranknumberratings[].team_idstringratings[].abbrevstringratings[].teamstringratings[].ratingnumberratings[].as_ofstringcountnumbermethodstring
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
get_games2 cr
Takes the team this one returns.
Games with runs, hits and errors by season, date, range or team
get_schedule2 cr
Takes the team this one returns.
Upcoming games with the median line across sportsbooks
list_teams1 cr
Filters by the same season and league.
Team ids, abbreviations and colours for a season
search_players1 cr
Filters by the same league.
Find players by name
Try it
500 free credits every month: 250 calls to get_ratings, and no card.