Tennis APIATP and WTA tennis since 2007, set by set.
124,000 ATP and WTA singles matches with every set and tiebreak score, tournament draws round by round, player profiles, weekly rankings, head to head, surface splits and our own Elo by surface. Call it over REST or point Claude at it over MCP. You get 500 free credits every month and we do not ask for a card.
500 free credits every month, no card. Works in Claude, ChatGPT and Cursor: connect over MCP
- sets
- 301,000+
- matches
- 124,000+
- players
- 3,800+
- seasons
- 20
Call it over REST or point Claude at it over MCP. You get 500 free credits every month and we do not ask for a card.
Try it
One request, JSON back.
Copy the call, put your key in, run it. get_match costs 2 credits, and every account starts with 500 free credits every month, no card.
Request
curl -X POST https://mcp.acesapi.com/v1/get_match \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"match_id": "157774"
}'Response
{
"tour": "ATP",
"match": {
"match_id": "157774",
"tournament_id": "188-2025",
"tournament": "Wimbledon",
"season": 2025,
"surface": "grass",
"indoor": false,
"starts_at": "2025-07-13T15:20:00.000Z",
"match_date": "2025-07-13",
"draw": "main",
"round": "Final",
"round_order": 22,
"court": "Centre Court",
"player1_id": "3623",
"player1": "Jannik Sinner",
"player1_country": "ITA",
"seed1": 1,
"player2_id": "3782",
"player2": "Carlos Alcaraz",
"player2_country": "ESP",
...First 22 lines. Full response and every field
Also in AcesAPI
The WTA tennis data API
WTA Tour (women's professional tennis), every season since 2007: sportsbook lines and season lines. Same key and credits as the ATP.
WTA API: see the data- matches
- 64,899
- tournaments
- 1,364
- seasons
- 20
This week
What get_schedule returns right now.
Rendered from the same rows get_schedule returns, refreshed every morning. Lines are held only for Grand Slam and (from August 2024) ATP Masters / WTA 1000 matches, and appear in get_odds and get_match once posted.
| Starts | Player | Opponent | Round | Match id |
|---|---|---|---|---|
| Sun 12:00 PM ET | Alexander Zverev | Carlos Alcaraz | ATP Final | 187529 |
| Sun 4:00 PM ET | Leyre Romero Gormaz | Rebeka Masarova | WTA Final | 186812 |
| Mon 12:00 AM ET | TBD | TBD | WTA Round 1 | 186813 |
| Mon 12:00 AM ET | TBD | TBD | WTA Round 1 | 186814 |
| Mon 12:00 AM ET | TBD | TBD | WTA Round 1 | 186815 |
| Mon 12:00 AM ET | TBD | TBD | WTA Round 1 | 186816 |
get_schedule · 2 credits · then get_match for the score by set, tiebreaks and both ratings
Coverage
Coverage you can inspect before you build.
ATP and WTA singles, main draws from 2007 and qualifying from 2022, with every set and tiebreak score.
The weekly top 100 to 150 for both tours since 2007, 35 to 49 lists a year.
Our Elo for every player, overall and on hard, clay and grass, before and after every match.
| Dataset | Seasons | Volume | Status | Tools |
|---|---|---|---|---|
Matches and scores Players, seeds, round, status, every set's games and tiebreak points, retirements and walkovers. | 2007 to current | 124,000+ finished singles matches, both tours | Full Singles only. Main draws from 2007, qualifying from 2022. About 0.6% of records left mid-match are marked incomplete. | |
Tournaments and draws Dates, city, surface, Grand Slam flag, each round's matches and the champion. | 2007 to current | About 60 to 75 ATP and 55 to 110 WTA tournaments a year | Full Surface is from our own reference: placed for 99.6% of ATP and 96% of WTA matches, null for the rest. | |
Players Date of birth, country, height, playing hand, career record, titles, head to head and records by surface. | Everyone in a listed match | Profiles and careers | Full | |
Rankings Rank, previous rank and points per weekly list, and each player's ranking history. | 2007 to current | Top 100 to 150, most weeks | Partial Only 35 to 49 lists a year per tour are kept; the other weeks are missing. | |
Ratings Our Elo, overall and per surface, before and after every match. | 2007 to current | Every player, every completed match | Full |
Full detail in the data atlas. Sportsbooks: 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.
Last written 2026-11-22 10:00 UTC. Every dataset's own refresh time is in the changelog.
Why trust it
Built from the score, and honest about what the score cannot tell.
Public tennis data has results and rankings, not serve statistics. Everything here is counted from scores we check, and nothing is filled in where the source is silent.
Scores checked against the result line
Each match's sets are stored game by game with tiebreak points, then rebuilt into a score and compared with the published result line for the match: 99.8% agree. Records left mid-match are marked incomplete and counted in no record or rating.
Both tours, every season since
ATP and WTA singles, main draws from 2007 and qualifying from 2022, with seeds, rounds, retirements and walkovers, and the weekly top 100 to 150.
Ratings that know clay from grass
Our Elo is computed twice for every player: once from every match, once from matches on the same surface only. Surfaces come from our own tournament reference; a tournament we cannot place stays unknown rather than guessed.
Tools
Every tool, and what a call costs.
Every tool is one REST endpoint and one MCP tool with the same name, the same parameters, and a fixed credit cost. Empty results are not charged.
- get_tournamentA tournament's draw and results, round by round, with every set
- get_matchesMatch results by day, tournament or season, with set and tiebreak scores
- get_scheduleUpcoming and in-progress matches for the next days
- get_matchOne match: sets, tiebreak points, seeds, ratings, what the score says and its sportsbook lines
- get_rankingsWeekly ranking lists since 2007, or one player's ranking history
- get_ratingsOur Elo ratings, overall or by surface
- get_playerProfile, ranking, ratings, career record, titles and recent matches
- get_player_matchesA player's matches with scores and ratings, filtered by season, surface or opponent
- get_oddsEach sportsbook's opening and closing moneylines for a match or a whole tournament, with the games handicap and total
Built for
Four jobs, and the endpoints that do them.
Surface ratings and head to head, ready for a model
Every ATP and WTA singles result since 2007 with our Elo by surface before and after each match, head to head and records by surface.
Read more →Every set of every tour match since 2007
ATP and WTA singles since 2007: draws round by round, every set's games and tiebreak points, rankings by week, all in rows.
Read more →Tennis data your app or agent can query
REST and MCP over the same data: tournaments, draws, matches, players, rankings and ratings, with stable ids.
Read more →Guides
Working code for the questions people ask.
- get_ratings
How do I get tennis Elo ratings by surface in Python?
Our Elo rating for every active player, overall or on one surface, with the number of matches behind each rating.
Python, JavaScript, cURL → - get_surface_splits
How do I compare a tennis player's results on clay, grass and hard court?
A player's career record split by surface: wins, losses, sets, games, tiebreaks and deciding sets, with the surface Elo ratings alongside.
Python, JavaScript, cURL → - get_head_to_head
How do I get a tennis head-to-head record in Python?
Every meeting between two players with the score and sets, plus wins by surface and in finals.
Python, JavaScript, cURL →
Integrations
In your AI assistant, your editor or your spreadsheet.
All integrationsAccess
REST or MCP. Same data either way.
Call it from any language over REST. Let Claude or Cursor query it in plain English over MCP.
- GET https://mcp.acesapi.com/v1/tools public catalogue with JSON Schema
- GET https://mcp.acesapi.com/openapi.json OpenAPI 3.1 spec
- POST https://mcp.acesapi.com/v1/{tool}
- MCP https://mcp.acesapi.com/mcp
curl -X POST https://mcp.acesapi.com/v1/list_tournaments \
-H "x-api-key: YOUR_API_KEY"
# every tool: POST /v1/{tool} with a JSON body
# responses carry X-Credits-Used and X-Credits-RemainingPricing
Free to start, then you pay per call.
500 credits every month, no card. Subscriptions add a monthly allowance; wallet top-ups do not expire while your account is open.
- +All 14 endpoints
- +REST API + MCP access
- +No credit card required
- +10,000 credits/month
- +All 14 endpoints
- +Email support
- +Overage at wallet rates
- +30,000 credits/month
- +All 14 endpoints
- +Priority support
- +Overage at wallet rates
- +125,000 credits/month
- +All 14 endpoints
- +Dedicated support
- +Volume rates available
Full breakdown, credit costs per tool, and FAQ on the pricing page.
Questions
The things people ask before signing up.
Is AcesAPI free?
Every account gets 500 credits every month and no card. Calls cost 1 to 5 credits depending on the endpoint, so 500 is a few hundred real requests. Paid plans start at $19/mo for 10,000 credits a month, and wallet top-ups do not expire while your account is open.
How far back does the data go?
ATP and WTA singles from 2007 to the tournaments under way now (main draws from 2007, qualifying from 2022): every set and tiebreak score, the draw round by round, and the weekly top 100 to 150 of each tour's ranking. There is nothing before 2007, no doubles and no serve statistics (aces, double faults, break points): none of those are published for tennis. Sportsbook lines are held for Grand Slam matches from mid-2020 and ATP Masters / WTA 1000 matches from August 2024, only.
What is MCP, and do I need it?
MCP is the protocol Claude, Cursor and similar assistants use to call tools. Point one at https://mcp.acesapi.com/mcp with your key and it picks the endpoint and reads the response itself, no client code. If you are writing an application instead, ignore MCP and use the REST endpoints; they are the same 14 tools.
Can I use this commercially?
Yes, inside your own product or model, within the terms. Reselling the data itself as a feed is not permitted. AcesAPI is independent and not affiliated with the ATP or the WTA.
How current is it?
Pre-match odds refresh every hour for matches in the next four days. Everything else updates once a day, early morning US Eastern (10:00 UTC): the year's tournaments, every result and the schedule, the newest ranking list, new players' profiles and the ratings. There is no live, point-by-point feed; a match in progress shows the score at the time of the update.
Where do the numbers come from?
Results, draws, players and ranking lists from public data. Every match's sets are checked against the published result line. Surfaces come from our own tournament reference; records, head to head, surface splits and the Elo ratings are computed here from the scores.
What are the rate limits?
60 requests a minute, dropping to 10 if your credit balance falls below 100. The limit is the same on every plan: credits, not requests, are the spend boundary.
Before you write another scraper
Start with 500 free credits every month, no card.
AcesAPI · The tennis data API.