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
{ "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 serverEngineered 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.
Odds & tick history
Live and upcoming prediction-market implied probabilities, decimal odds, volume metrics, and tick-by-tick price history back to November 2024.
- GET
/api/v1/tennis/odds/liveLive in-play prediction-market odds and volume.
- GET
/api/v1/tennis/odds/upcomingUpcoming matches with market odds and liquidity.
- GET
/api/v1/tennis/odds/{match_id}Current prediction-market odds for one match.
- GET
/api/v1/tennis/odds/{match_id}/liveReal-time live market snapshot for one match.
- GET
/api/v1/tennis/odds/{match_id}/historyTick-by-tick historical price series since Nov 2024.
Surface Elo
Point-in-time overall, Hard, Clay, and Grass Elo ratings and pre-match win probabilities across 2.1M+ matches back to 1968.
- GET
/api/v1/tennis/rankings/eloSurface and overall Elo leaderboard by tour and surface.
- GET
/api/v1/tennis/players/{player_id}/eloSingle player's surface Elo trajectory and recent match probabilities.
- GET
/api/v1/tennis/matches?include=stats,elo,oddsJoin serve stats, Elo ratings, and odds in one match list call.
Live scores
Every match in progress with the set scores, the game score, who is serving, and live match stats. Open one match for its full state.
- GET
/api/v1/tennis/matches/liveMatches in progress: sets, game score, server, and live stats.
- GET
/api/v1/tennis/matches/live/{match_id}One live match: every set, the current game, and both players' stats.
- GET
/api/v1/tennis/matches/{match_id}/statusScheduled, in progress, or finished, with the result once decided.
- GET
/api/v1/tennis/scheduleThe day's order of play across tours.
- GET
/api/v1/tennis/matches/upcomingScheduled matches, soonest first.
Results
Finished matches with the score of every set, the winner and loser, and the serve and return box score behind them.
- GET
/api/v1/tennis/matches/recentFinished matches, newest first, with set scores.
- GET
/api/v1/tennis/matches/completedEvery match completed on a given day.
- GET
/api/v1/tennis/matches/{match_id}One match: tournament, round, surface, score, and box score.
- GET
/api/v1/tennis/matches/{match_id}/statsAces, double faults, first-serve %, points won, break points.
- GET
/api/v1/tennis/matches?player_id=&year=&surface=The archive, filtered by player, opponent, year, surface, level or round.
Players
Player profiles with country, hand and birth date, career serve and return stats, recent form, and every match played.
- GET
/api/v1/tennis/players/search?q={name}Find a player by name and get their id.
- GET
/api/v1/tennis/players/{player_id}Name, country, hand, height, birth date and ranking.
- GET
/api/v1/tennis/players/{player_id}/statsCareer and season serve, return and win-loss stats.
- GET
/api/v1/tennis/players/{player_id}/formRecent results and win rate.
- GET
/api/v1/tennis/players/{player_id}/matchesThe player's match log, newest first.
Head-to-head
The full record between two players, split by surface and level, or a grid of records across a group of players.
- GET
/api/v1/tennis/h2h?player1_id=&player2_id=Wins, losses and every meeting between two players.
- GET
/api/v1/tennis/h2h/{player1_id}/{player2_id}The same record in path form.
- GET
/api/v1/tennis/h2h/matrix?player_ids=A head-to-head grid for several players at once.
Rankings
Weekly ATP and WTA singles rankings with points and movement, back through the decades, and any player's ranking history.
- GET
/api/v1/tennis/rankingsA full weekly ranking table for ATP or WTA.
- GET
/api/v1/tennis/rankings/topThe top N players of the latest list.
- GET
/api/v1/tennis/rankings/moversBiggest risers and fallers between two lists.
- GET
/api/v1/tennis/rankings/history/{player_id}One player's ranking, week by week.
- GET
/api/v1/tennis/rankings/datesEvery ranking date on file.
Tournaments
Tournaments from Grand Slams to ITF events, the season calendar, and the draw of any edition as a bracket.
- GET
/api/v1/tennis/tournamentsTournaments filtered by tour, level, surface and year.
- GET
/api/v1/tennis/tournaments/calendar?year=2026One season's tournament calendar.
- GET
/api/v1/tennis/tournaments/{tournament_id}One tournament: level, surface, location and editions.
- GET
/api/v1/tennis/tournaments/{tournament_id}/drawThe draw of the latest edition.
- GET
/api/v1/tennis/tournaments/{tournament_id}/editions/{year}/drawThe draw of any past edition.
Leaderboards
Season leaders for the stats that decide matches, computed from every match box score.
- GET
/api/v1/tennis/leaderboards/acesMost aces in the season.
- GET
/api/v1/tennis/leaderboards/1st-serve-wonBest first-serve points won %.
- GET
/api/v1/tennis/leaderboards/break-conversionBest break-point conversion.
- GET
/api/v1/tennis/leaderboards/tiebreak-win-pctBest tiebreak record.
- GET
/api/v1/tennis/leaderboards/comeback-winsMost wins after losing the first set.
Coverage
What the dataset holds: tours, levels, ITF and junior coverage, and the years on file.
- GET
/api/v1/tennis/coverageTours, levels, year range, ITF and junior event counts.
- GET
/api/v1/tennis/competitionsEvery competition with its tour and level.
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
More for tennis models
- Tennis odds APILive, pre-match and tick-by-tick prediction-market odds.
- Tennis CSV datasetDownload 2.1M+ matches, surface Elo and odds on Business ($299/mo).
- Tennis prediction dataPoint-in-time Elo, surface splits, form and odds for models.
- Historical tennis data2.25M+ results since 1877 and weekly rankings since 1973.
- Tennis stats APIBox scores, career serve/return splits and leaderboards.
- Cito vs BetsAPIUnified IDs, 1968+ surface Elo and tick history vs basic feeds.
- Cito vs GoalserveTransparent self-serve pricing ($59-$299) vs enterprise contracts.
- Tennis APILive scores, odds, surface Elo, rankings and stats on one key.
- Tennis API docsEvery endpoint, its parameters, and a real response.
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).