# Tennis Database API > Tennis results, closing prices, games and sets lines, price movement and match statistics as a JSON API: 2,344,876 matches, men and women, from 1877, with 103,673 players and 16,440 tournaments. Base address: https://api.tennisdatabaseapi.com/v1. GET only. Send the key as `Authorization: Bearer `. Every id is our own and stable; times are UTC; prices are decimal and turned to the winner and the loser. ## Docs - [Manual](https://tennisdatabaseapi.com/documentation/manual.md): every endpoint, plan, field and error - [OpenAPI](https://api.tennisdatabaseapi.com/openapi.json) - MCP server: https://api.tennisdatabaseapi.com/mcp (Bearer key) - [Status](https://tennisdatabaseapi.com/status.json) ## Agent skill - [Tennis Database API agent skill](https://tennisdatabaseapi.com/.well-known/agent-skills/tennisdatabaseapi/SKILL.md): how agents use Tennis Database API. Index: https://tennisdatabaseapi.com/.well-known/agent-skills/index.json ## Endpoints - Matches on a day, GET /v1/matches: Matches on a day, with scores and closing prices - Yesterday's results, GET /v1/results/yesterday: Yesterday's results - Fixtures, GET /v1/fixtures: The matches set to be played, from those under way to two days ahead: start time, round, both players with ranking and Elo, the chance Elo gives each, and the price before play where the market has one - Live scores, GET /v1/live: The singles matches in play now, read every 15 seconds: sets, games, the game in progress with who serves and its points, how long ago each was read, and those finished in the last 15 minutes - Live match, GET /v1/live/{id}: One match in play: the live score and every game so far, point by point, with who served, breaks, break points and set points. After it leaves Live, its last score stays here 7 days (meta.in_live false) - Match, GET /v1/matches/{id}: One match: score, every bookmaker's price with its opening price, the games and sets lines, correct score prices, price movement and the full statistics - Match statistics, GET /v1/matches/{id}/statistics: Serve and return figures for each player, for the match and each set, with the service games held and broken - Point by point, GET /v1/matches/{id}/points: Every game and point of a match: who served, who won it, breaks, break points and set points - Match prices, GET /v1/matches/{id}/odds: Every bookmaker's closing and opening price for a match, and every market: games, sets, handicaps and correct score - Price moves, GET /v1/matches/{id}/moves: Each change of each bookmaker's match price before the start, timed - Find players, GET /v1/players: Find players by name - Player profile, GET /v1/players/{id}: A player, with their win and loss record by surface - Player matches, GET /v1/players/{id}/matches: A player's matches, newest first - Player seasons, GET /v1/players/{id}/seasons: A player's won and lost by season, and by surface within each season - Player statistics, GET /v1/players/{id}/statistics: A player's serve and return figures over every match held with statistics, and their opponents' against them - Player titles, GET /v1/players/{id}/titles: Every final a player won and lost, by level - Ranking history, GET /v1/players/{id}/rankings: A player's singles ranking and points, week by week, newest first - Elo history, GET /v1/players/{id}/elo: A player's Elo rating now, and before every match, overall and on the match's surface, with the chance it gave them - Head to head, GET /v1/h2h/{a}/{b}: Head to head between two players - Rankings, GET /v1/rankings: The current singles rankings, with each player's highest ranking and Elo - Rankings on a date, GET /v1/rankings/{date}: The ranking list of the week of a date: singles, men from 1973 and women from 2003; women's doubles with list=doubles - Elo ratings, GET /v1/elo: The players our Elo rates highest, overall or on one surface, among those with a match in the last year - Find tournaments, GET /v1/tournaments: Tournaments, by name, tour or tier - Tournament, GET /v1/tournaments/{id}: A tournament and every season held - Champions, GET /v1/tournaments/{id}/champions: The champion and runner-up of every season of a tournament, and who has won it most - Tournament season, GET /v1/tournaments/{id}/{season}: Every match of one season of a tournament - Season draw, GET /v1/tournaments/{id}/{season}/draw: One season of a tournament round by round, from qualifying to the final, with seeds and entry - This week, GET /v1/calendar: The events being played in the week of a date, every level, with surface, city and matches held so far - Doubles on a day, GET /v1/doubles: Every doubles match of one day, with both pairs, seeds, the score and closing prices - Doubles statistics, GET /v1/doubles/matches/{id}/statistics: A doubles match's serve and return figures for each pair, for the match and each set, where the match has them (tour-level doubles from 13 November 2026) - Doubles point by point, GET /v1/doubles/matches/{id}/points: Every game and point of a doubles match: which pair served, who won it, breaks and break points - Doubles pair, GET /v1/doubles/pairs/{id}: A doubles pair, their record together and every match they played, newest first - Market accuracy, GET /v1/markets/accuracy: How often the closing favourite won: by price, level, surface and season, and over the last 30 days - Biggest upsets, GET /v1/markets/upsets: The longest closing prices that won at Grand Slam and tour level - Bookmaker margins, GET /v1/markets/margins: Each bookmaker's average margin on its closing prices since the start of last year - All-time leaders, GET /v1/records: The most matches won and the most titles, all time - Season leaders, GET /v1/records/{season}: The most matches won and the most titles in one season - Search, GET /v1/search: Players and tournaments together, by name - Coverage, GET /v1/meta/coverage: What the database holds, season by season, counted from the data - Bulk files, GET /v1/exports: Every season as compressed CSV files: matches, prices, price moves, statistics and point by point, with rows, size and checksum, rebuilt nightly - Bulk file, GET /v1/exports/{season}/{dataset}: One season's file of one dataset (matches, prices, moves, statistics or points), gzip-compressed CSV - Freshness, GET /v1/freshness: How current each dataset is: the newest day held for results, prices, price moves, statistics and point by point, the share of yesterday's and the last 7 days' matches with each, and when the database was last updated (does not count) - Usage, GET /v1/usage: Your plan, calls used and limits (does not count) ## Plans - Free key: 10 calls a minute, 50 a day, no limit a month; matches from yesterday to today and the next 2 days; prices included on matches already played; statistics included on matches already played - Live: 120 calls a minute, no limit a day, 300,000 a month; matches from 45 days ago to today and the next 2 days; prices included; statistics included - Archive: 120 calls a minute, no limit a day, 300,000 a month; matches from the first season held to yesterday; prices included; statistics included - Complete: 300 calls a minute, no limit a day, 1,000,000 a month; matches from the first season held to today and the next 2 days; prices included; statistics included ## Optional - Operated by DeveloperData.net, Bangkok, Thailand. Support: https://tennisdatabaseapi.com/support