2.1M+ Matches ยท 1968+Read Elo docs

Point-in-time surface Elo ratings back to 1968.

Query chronologically computed Overall, Hard, Clay, Grass, and Indoor Elo ratings alongside match-by-match pre-match win probabilities (`expected_win_prob`, `elo_pre`, `elo_post`) across 2,103,706 matches and 78,472 players.

  • 2,103,706 Elo-rated matches
  • 78,472 players rated
  • Overall, Hard, Clay, Grass & Indoor splits
GET /tennis/rankings/elo?surface=Hard&limit=2200 OK
$ curl "https://api.citoapi.com/api/v1/tennis/rankings/elo?surface=Hard&limit=2" \ -H "x-api-key: $CITO_API_KEY"
{  "success": true,  "items": [    {      "rank": 1,      "player_id": "atp_206173",      "name": "Jannik Sinner",      "tour": "ATP",      "elo_overall": 2843.6,      "elo_hard": 2733.4,      "elo_clay": 2567.2,      "elo_grass": 2227.9,      "peak_elo_overall": 2851.9,      "matches_rated": 580    },    {      "rank": 2,      "player_id": "atp_207989",      "name": "Carlos Alcaraz",      "tour": "ATP",      "elo_overall": 2764.6,      "elo_hard": 2630,      "elo_clay": 2613.7,      "elo_grass": 2243.6,      "peak_elo_overall": 2798.1,      "matches_rated": 455    }  ]}

Seamless Integration with our MCP Server

Give Claude, Cursor, and ChatGPT the tennis data. One command configures the MCP server so agents call real player IDs, surface Elo, live odds, and match logs instead of hallucinating them.

MCPInstall the Cito MCP server
Claude
Cursor
OpenAI
Python
Cito API
Next.js
Discord
Slack
GitHub

Engineered with zero lookahead leakage

Every pre-match rating and expected win probability is snapshotted strictly before first ball, updated daily as matches finish.

Five surface dimensions

Overall, Hard, Clay, Grass, and Indoor ratings plus blended effective_elo per player.

Match-by-match trajectories

GET /tennis/players/{id}/elo returns peak Elo, surface counts, and per-match elo_pre, elo_post, and expected_win_prob.

Surface leaderboards

GET /tennis/rankings/elo filters by tour (ATP/WTA) and surface to rank active players instantly.

Inline on match archive

Pass ?include=elo (or ?include=stats,elo,odds) on /tennis/matches for single-call training sets.

Paired with market odds

Compare Elo-implied win probabilities against live and closing prediction-market odds on the same match ID.

Bulk CSV export

Download all 2.1M+ rated matches and player rating series directly via Business CSV ($299/mo).

Endpoints you can ship with

Test surface Elo leaderboards, player Elo history, and odds endpoints.

Surface Elo

Point-in-time overall, Hard, Clay, and Grass Elo ratings and pre-match win probabilities across 2.1M+ matches back to 1968.

View docs
  • GET/api/v1/tennis/rankings/elo

    Surface and overall Elo leaderboard by tour and surface.

  • GET/api/v1/tennis/players/{player_id}/elo

    Single player's surface Elo trajectory and recent match probabilities.

  • GET/api/v1/tennis/matches?include=stats,elo,odds

    Join serve stats, Elo ratings, and odds in one match list call.

Figures on this page were checked against the live API on 2026-11-15.

FAQs

Methodology, coverage, and API/CSV access

Can't find what you're looking for? Contact our customer support team

Compare plans

Model every point withย 1968+ Elo

Call /tennis/rankings/elo on a free key today or export all 2.1M+ rated matches in Business CSV ($299/mo).