Skip to content

get_ratings

2 creditsBasic lookupPOST /v1/get_ratings

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).

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-09-20",
  "ratings": [
    {
      "rank": 1,
      "team_id": "382",
      "abbrev": "MNC",
      "name": "Manchester City",
      "elo": 1670.4,
      "last_game": "2026-09-20"
    },
    {
      "rank": 2,
      "team_id": "359",
      "abbrev": "ARS",
      "name": "Arsenal",
      "elo": 1658,
      "last_game": "2026-09-19"
    },
    {
      "rank": 3,
      "team_id": "364",
      "abbrev": "LIV",
      "name": "Liverpool",
      "elo": 1578,
      "last_game": "2026-09-20"
    }
  ],
  "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."
}

Response fields

as_ofstring
ratings[]array
List of objects
ratings[].ranknumber
ratings[].team_idstring
ratings[].abbrevstring
ratings[].namestring
ratings[].elonumber
ratings[].last_gamestring
countnumber
methodstring

Related endpoints

Try it

500 credits free on signup: 250 calls to get_ratings, and no card.