Skip to content
AcesAPI

Data atlas

Inspect the tennis data layer before you build on it.

AcesAPI exposes tennis datasets through REST and MCP. This atlas keeps coverage claims explicit: what exists, which endpoints expose it, and where availability is partial.

Since 2007
Matches
ATP and WTA singles, main draws from 2007 and qualifying from 2022, with every set and tiebreak score.
Weekly
Rankings
The weekly top 100 to 150 for both tours since 2007, 35 to 49 lists a year.
By surface
Ratings
Our Elo for every player, overall and on hard, clay and grass, before and after every match.

Coverage ledger

Coverage is a product claim, not a freshness signal. Operational freshness is tracked separately.

Open docs
DataStatusCoverageVolume
Matches and scores
Players, seeds, round, status, every set's games and tiebreak points, retirements and walkovers.
Singles only. Main draws from 2007, qualifying from 2022. About 0.6% of records left mid-match are marked incomplete.
Available2007 to current124,000+ finished singles matches, both tours
Tournaments and draws
Dates, city, surface, Grand Slam flag, each round's matches and the champion.
Surface is from our own reference: placed for 99.6% of ATP and 96% of WTA matches, null for the rest.
Available2007 to currentAbout 60 to 75 ATP and 55 to 110 WTA tournaments a year
Players
Date of birth, country, height, playing hand, career record, titles, head to head and records by surface.
AvailableEveryone in a listed matchProfiles and careers
Rankings
Rank, previous rank and points per weekly list, and each player's ranking history.
Only 35 to 49 lists a year per tour are kept; the other weeks are missing.
Partial2007 to currentTop 100 to 150, most weeks
Ratings
Our Elo, overall and per surface, before and after every match.
Available2007 to currentEvery player, every completed match

Endpoint map

Start with the dataset, then jump to the exact tool reference or a runnable surface.

Matches and scores

available

Players, seeds, round, status, every set's games and tiebreak points, retirements and walkovers.

Tournaments and draws

available

Dates, city, surface, Grand Slam flag, each round's matches and the champion.

Players

available

Date of birth, country, height, playing hand, career record, titles, head to head and records by surface.

Rankings

partial

Rank, previous rank and points per weekly list, and each player's ranking history.

Ratings

available

Our Elo, overall and per surface, before and after every match.

Sportsbook coverage

Odds coverage currently documents pre-match moneylines for Grand Slam matches (and, from August 2024, ATP Masters / WTA 1000 matches). Grand Slams from mid-2020 and ATP Masters / WTA 1000 events from August 2024, from the sportsbook odds archive. Other tournaments have no lines. Pre-match prices are refreshed hourly, and nothing is in play. Lines come back from get_odds and inside get_match.