Skip to content

get_ratings

2 creditsBasic lookupPOST /v1/get_ratings

Data refreshed · changelog

Our club Elo ratings, ranked

Use it when you want our Elo ratings, strongest club first, today or as of a date.

Parameters

datestringoptional
Ratings as of this day, YYYY-MM-DD (default: the latest).
limitintegeroptional
Max clubs (default 50).
leagueenum: soccer | mls | laliga | seriea | bundesliga | ligue1 | ucl | championship | nwsl | ligamx | uel | uecl | eredivisie | primeira | scotland | brazil | argentinaoptional
League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.

Notes

  • Over MCP, ask for it in plain English and the client calls get_ratings itself. Point any MCP client at https://mcp.strikerapi.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.strikerapi.com/v1/get_ratings \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "limit": 5
}'

Response

json
{
  "as_of": "2026-11-06",
  "ratings": [
    {
      "rank": 1,
      "team_id": "359",
      "abbrev": "ARS",
      "name": "Arsenal",
      "elo": 1685.5,
      "last_game": "2026-11-01"
    },
    {
      "rank": 2,
      "team_id": "382",
      "abbrev": "MNC",
      "name": "Manchester City",
      "elo": 1662.3,
      "last_game": "2026-10-31"
    },
    {
      "rank": 3,
      "team_id": "331",
      "abbrev": "BHA",
      "name": "Brighton & Hove Albion",
      "elo": 1598.4,
      "last_game": "2026-10-31"
    }
  ],
  "count": 5,
  "method": "Elo from every final match in this competition: K 20, home advantage 60 points (none at neutral venues), scaled by goal difference, a third of the way back to 1500 between seasons. 400 points = 10-to-1 odds. A rating moves only on this competition's matches."
}