Where can I get football Elo ratings by club in Python?
Our Elo rating for every club, ranked, as of any date you pass, with the method written out in the response.
Code verified October 10, 2026. One call to get_ratings, 2 credits.
The call
Pass date (YYYY-MM-DD) for the ratings as they stood then.
import requests
import pandas as pd
API_KEY = "YOUR_API_KEY"
resp = requests.post(
"https://mcp.strikerapi.com/v1/get_ratings",
headers={"x-api-key": API_KEY},
json={
"limit": 20,
},
timeout=60,
)
resp.raise_for_status()
data = resp.json()["data"]
ratings = pd.DataFrame(data["ratings"])
print("ratings as of", data["as_of"])
print(ratings[["rank", "abbrev", "elo", "last_game"]].head(10))
# 400 points is 10-to-1 odds; home advantage is 60 points.
gap = ratings.loc[0, "elo"] - ratings.loc[1, "elo"]
print("first over second:", round(1 / (1 + 10 ** (-gap / 400)), 3))
Replace YOUR_API_KEY with a key from your dashboard. Python needs requests and pandas (pip install requests pandas). JavaScript runs on Node 18 or newer, or in the browser.
What comes back
The data object of the response, trimmed to the first rows. Every field is real output from the run above.
{
"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"
},
"...18 more"
],
"count": 20,
"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."
}What to do next
- get_odds (5 credits). Sportsbook prices to compare a rating gap with the market's probability.
- get_head_to_head (2 credits). Two clubs' meetings: record, goals and every result.
More guides
Start with 500 free credits
No card. REST or MCP.