Skip to content
AcesAPI

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

json
{
  "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.

StartsPlayerOpponentRoundMatch id
Sun 12:00 PM ETAlexander ZverevCarlos AlcarazATP Final187529
Sun 4:00 PM ETLeyre Romero GormazRebeka MasarovaWTA Final186812
Mon 12:00 AM ETTBDTBDWTA Round 1186813
Mon 12:00 AM ETTBDTBDWTA Round 1186814
Mon 12:00 AM ETTBDTBDWTA Round 1186815
Mon 12:00 AM ETTBDTBDWTA Round 1186816

get_schedule · 2 credits · then get_match for the score by set, tiebreaks and both ratings

Coverage

Coverage you can inspect before you build.

Matches
Since 2007

ATP and WTA singles, main draws from 2007 and qualifying from 2022, with every set and tiebreak score.

Rankings
Weekly

The weekly top 100 to 150 for both tours since 2007, 35 to 49 lists a year.

Ratings
By surface

Our Elo for every player, overall and on hard, clay and grass, before and after every match.

DatasetSeasonsVolumeStatusTools
Matches and scores
Players, seeds, round, status, every set's games and tiebreak points, retirements and walkovers.
2007 to current124,000+ finished singles matches, both toursFull
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 currentAbout 60 to 75 ATP and 55 to 110 WTA tournaments a yearFull
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 matchProfiles and careersFull
Rankings
Rank, previous rank and points per weekly list, and each player's ranking history.
2007 to currentTop 100 to 150, most weeksPartial
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 currentEvery player, every completed matchFull

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.

Every set

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.

2007

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.

By surface

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.

Access

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-Remaining

Pricing

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.

Free
$0
500 free credits every month
  • +All 14 endpoints
  • +REST API + MCP access
  • +No credit card required
Start free
Starter
$19/mo
10,000 credits/month
  • +10,000 credits/month
  • +All 14 endpoints
  • +Email support
  • +Overage at wallet rates
Choose Starter
ProMost popular
$49/mo
30,000 credits/month
  • +30,000 credits/month
  • +All 14 endpoints
  • +Priority support
  • +Overage at wallet rates
Choose Pro
Scale
$149/mo
125,000 credits/month
  • +125,000 credits/month
  • +All 14 endpoints
  • +Dedicated support
  • +Volume rates available
Choose Scale

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.