The server marks this tool read-only

get_head_to_head

Use for two players' head to head: wins each, sets won, wins by surface and in finals, and every meeting with its score. Walkovers are listed but not counted as wins; incomplete records are not counted. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 3 credits.

read-only

Argument	Type	Description
league	string	League. Defaults to tennis. One of: tennis, wta.
player_id*	string	First player id.
opponent_id*	string	Second player id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "player_id",
    "opponent_id"
  ],
  "properties": {
    "league": {
      "enum": [
        "tennis",
        "wta"
      ],
      "type": "string",
      "description": "League. Defaults to tennis. One of: tennis, wta."
    },
    "player_id": {
      "type": "string",
      "description": "First player id."
    },
    "opponent_id": {
      "type": "string",
      "description": "Second player id."
    }
  }
}

get_match

Use for everything about one match: the score by set with tiebreak points, seeds, each player's sets, games and tiebreaks won, both players' ratings before and after (overall and on the surface), what the score says (total games, tiebreaks, whether it went the distance, comebacks), and each sportsbook's opening and closing moneylines where the match had them (Grand Slam, ATP Masters and WTA 1000 matches only). No serve statistics: they are not available. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

read-only

Argument	Type	Description
league	string	League. Defaults to tennis. One of: tennis, wta.
match_id*	string	Match id from get_tournament, get_matches or get_player_matches.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "match_id"
  ],
  "properties": {
    "league": {
      "enum": [
        "tennis",
        "wta"
      ],
      "type": "string",
      "description": "League. Defaults to tennis. One of: tennis, wta."
    },
    "match_id": {
      "type": "string",
      "description": "Match id from get_tournament, get_matches or get_player_matches."
    }
  }
}

get_matches

Use for match results by day, tournament or season: each match with both players, seeds, round, status, score and sets (games and tiebreak points). Pass a date (YYYY-MM-DD, UTC), a tournament_id or a season; filter by round (e.g. "Final") and status. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits.

read-only

Argument	Type	Description
date	string	UTC date, YYYY-MM-DD.
limit	integer	Max matches (default 100).
round	string	Round name as listed, e.g. "Final", "Semifinal", "Round 1".
league	string	League. Defaults to tennis. One of: tennis, wta.
offset	integer
season	string \| number	Year.
status	string
tournament_id	string	Tournament edition id, e.g. "188-2025".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date, YYYY-MM-DD."
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Max matches (default 100)."
    },
    "round": {
      "type": "string",
      "description": "Round name as listed, e.g. \"Final\", \"Semifinal\", \"Round 1\"."
    },
    "league": {
      "enum": [
        "tennis",
        "wta"
      ],
      "type": "string",
      "description": "League. Defaults to tennis. One of: tennis, wta."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "season": {
      "type": [
        "string",
        "number"
      ],
      "description": "Year."
    },
    "status": {
      "enum": [
        "scheduled",
        "live",
        "final"
      ],
      "type": "string"
    },
    "tournament_id": {
      "type": "string",
      "description": "Tournament edition id, e.g. \"188-2025\"."
    }
  }
}

get_player

Use for a player profile: date of birth, country, height, playing hand; latest ranking; our rating overall and per surface with peak; career record (wins, losses, sets, games, tiebreaks, deciding sets), titles, finals and Grand Slam titles; record by surface; and the last 10 matches. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 5 credits.

read-only

Argument	Type	Description
league	string	League. Defaults to tennis. One of: tennis, wta.
player_id*	string	Player id from search_players.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "player_id"
  ],
  "properties": {
    "league": {
      "enum": [
        "tennis",
        "wta"
      ],
      "type": "string",
      "description": "League. Defaults to tennis. One of: tennis, wta."
    },
    "player_id": {
      "type": "string",
      "description": "Player id from search_players."
    }
  }
}

get_player_matches

Use for a player's matches, newest first: tournament, surface, round, opponent, result, score by set and the player's rating before and after. Filter by season, surface, opponent_id, tournament_id or draw. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 5 credits.

read-only

Argument	Type	Description
draw	string
limit	integer	Max matches (default 50).
league	string	League. Defaults to tennis. One of: tennis, wta.
offset	integer
season	string \| number	Year.
surface	string
player_id*	string	Player id from search_players.
opponent_id	string	Only matches against this player.
tournament_id	string	Only this tournament edition, e.g. "188-2025".

get_player_stats

Use for a player's match statistics by season: wins, losses, sets and games won, tiebreaks won and lost, deciding sets, 6-0 sets and retirements, all counted from scores; plus the record by round and by the opponent's ranking (top 10, 11-50, 51-100). No serve statistics: they are not available. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 3 credits.

read-only

Argument	Type	Description
league	string	League. Defaults to tennis. One of: tennis, wta.
season	string \| number	Year (default every season).
player_id*	string	Player id from search_players.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "player_id"
  ],
  "properties": {
    "league": {
      "enum": [
        "tennis",
        "wta"
      ],
      "type": "string",
      "description": "League. Defaults to tennis. One of: tennis, wta."
    },
    "season": {
      "type": [
        "string",
        "number"
      ],
      "description": "Year (default every season)."
    },
    "player_id": {
      "type": "string",
      "description": "Player id from search_players."
    }
  }
}

get_rankings

Use for the ranking list: the latest (default), or a season and week, or the list in force on a date, with rank, previous rank, points and player. Pass player_id instead for one player's ranking history. Weekly lists hold the top 100 to 150 for most weeks since 2007. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits.

read-only

Argument	Type	Description
date	string	The list in force on this date, YYYY-MM-DD.
week	integer	Week number of the season.
limit	integer	Max rows of a list (default 100).
league	string	League. Defaults to tennis. One of: tennis, wta.
season	string \| number	Year.
player_id	string	One player's ranking history instead of a list.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "date": {
      "type": "string",
      "description": "The list in force on this date, YYYY-MM-DD."
    },
    "week": {
      "type": "integer",
      "maximum": 53,
      "minimum": 1,
      "description": "Week number of the season."
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Max rows of a list (default 100)."
    },
    "league": {
      "enum": [
        "tennis",
        "wta"
      ],
      "type": "string",
      "description": "League. Defaults to tennis. One of: tennis, wta."
    },
    "season": {
      "type": [
        "string",
        "number"
      ],
      "description": "Year."
    },
    "player_id": {
      "type": "string",
      "description": "One player's ranking history instead of a list."
    }
  }
}

get_ratings

Use for our Elo ratings, highest first: overall, or on one surface (hard, clay, grass). Players with a rated match since active_since (default a year ago) and at least 10 rated matches. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits.

read-only

Argument	Type	Description
limit	integer	Max players (default 50).
league	string	League. Defaults to tennis. One of: tennis, wta.
surface	string	Rank by the surface rating instead of overall.
active_since	string	Only players with a rated match since this date, YYYY-MM-DD (default one year ago).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Max players (default 50)."
    },
    "league": {
      "enum": [
        "tennis",
        "wta"
      ],
      "type": "string",
      "description": "League. Defaults to tennis. One of: tennis, wta."
    },
    "surface": {
      "enum": [
        "hard",
        "clay",
        "grass",
        "carpet"
      ],
      "type": "string",
      "description": "Rank by the surface rating instead of overall."
    },
    "active_since": {
      "type": "string",
      "description": "Only players with a rated match since this date, YYYY-MM-DD (default one year ago)."
    }
  }
}

get_schedule

Use for upcoming matches: every scheduled or in-progress singles match in the next N days (default 7, max 30) with players, seeds, round and start time where one is set. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits.

read-only

Argument	Type	Description
days	integer	Days ahead (default 7).
league	string	League. Defaults to tennis. One of: tennis, wta.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 30,
      "minimum": 1,
      "description": "Days ahead (default 7)."
    },
    "league": {
      "enum": [
        "tennis",
        "wta"
      ],
      "type": "string",
      "description": "League. Defaults to tennis. One of: tennis, wta."
    }
  }
}

get_surface_splits

Use for a player's record by surface (hard, clay, grass, carpet): wins, losses, win rate, sets, share of games won, tiebreaks, deciding sets and 6-0 sets, plus the current surface ratings. For one season or the whole career; by_season splits each surface by year. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 3 credits.

read-only

Argument	Type	Description
league	string	League. Defaults to tennis. One of: tennis, wta.
season	string \| number	Year (default the whole career).
by_season	boolean	Split each surface by season.
player_id*	string	Player id from search_players.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "player_id"
  ],
  "properties": {
    "league": {
      "enum": [
        "tennis",
        "wta"
      ],
      "type": "string",
      "description": "League. Defaults to tennis. One of: tennis, wta."
    },
    "season": {
      "type": [
        "string",
        "number"
      ],
      "description": "Year (default the whole career)."
    },
    "by_season": {
      "type": "boolean",
      "description": "Split each surface by season."
    },
    "player_id": {
      "type": "string",
      "description": "Player id from search_players."
    }
  }
}

get_tournament

Use for a tournament's draw and results: every singles match of one edition grouped by round in draw order (qualifying, then the main draw to the final), each with the score by set and tiebreak points, seeds, and the champion and runner-up. draw: main (default), qualifying or all. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits.

read-only

Argument	Type	Description
draw	string	Which draw (default main).
league	string	League. Defaults to tennis. One of: tennis, wta.
tournament_id*	string	Tournament edition id from list_tournaments, e.g. "188-2025".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "tournament_id"
  ],
  "properties": {
    "draw": {
      "enum": [
        "main",
        "qualifying",
        "all"
      ],
      "type": "string",
      "description": "Which draw (default main)."
    },
    "league": {
      "enum": [
        "tennis",
        "wta"
      ],
      "type": "string",
      "description": "League. Defaults to tennis. One of: tennis, wta."
    },
    "tournament_id": {
      "type": "string",
      "description": "Tournament edition id from list_tournaments, e.g. \"188-2025\"."
    }
  }
}

list_tournaments

Use to find tournaments. Lists a season's tournaments in calendar order with dates, city, surface, whether it is a Grand Slam, status, main-draw match count and the champion. Filter by surface (hard, clay, grass, carpet) and status. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 1 credit.

read-only

Argument	Type	Description
limit	integer	Max tournaments (default 100).
league	string	League. Defaults to tennis. One of: tennis, wta.
offset	integer	Page offset; use next_offset.
season	string \| number	Year, e.g. 2025 (default this year).
status	string	Only upcoming, in-progress or completed tournaments.
surface	string	Only tournaments on this surface.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Max tournaments (default 100)."
    },
    "league": {
      "enum": [
        "tennis",
        "wta"
      ],
      "type": "string",
      "description": "League. Defaults to tennis. One of: tennis, wta."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Page offset; use next_offset."
    },
    "season": {
      "type": [
        "string",
        "number"
      ],
      "description": "Year, e.g. 2025 (default this year)."
    },
    "status": {
      "enum": [
        "scheduled",
        "live",
        "final"
      ],
      "type": "string",
      "description": "Only upcoming, in-progress or completed tournaments."
    },
    "surface": {
      "enum": [
        "hard",
        "clay",
        "grass",
        "carpet"
      ],
      "type": "string",
      "description": "Only tournaments on this surface."
    }
  }
}

search_players

Use to find a player's id. Search by name (accents optional) and/or country code (e.g. ITA); most-played first, with matches, last match and rank on the current list (null outside the top 100 to 150 listed). Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 1 credit.

read-only

Argument	Type	Description
name	string	Part of the player's name, e.g. "sinner".
limit	integer	Max players (default 20).
league	string	League. Defaults to tennis. One of: tennis, wta.
country	string	Three-letter country code, e.g. ESP.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "name": {
      "type": "string",
      "description": "Part of the player's name, e.g. \"sinner\"."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Max players (default 20)."
    },
    "league": {
      "enum": [
        "tennis",
        "wta"
      ],
      "type": "string",
      "description": "League. Defaults to tennis. One of: tennis, wta."
    },
    "country": {
      "type": "string",
      "description": "Three-letter country code, e.g. ESP."
    }
  }
}

AcesAPI

Try it

get_head_to_head Read-only

AcesAPI

Try it

get_head_to_head Read-only

Tools (13)