Live Tennis API
Real-time tennis scores, player data, match-winner market prices, and model-driven match analysis. Read-only. Coverage spans ATP, WTA, Challenger, ITF and the…
Data & analytics#sports--fitness
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Real-time tennis scores, player data, match-winner market prices, and
model-driven match analysis. Read-only. Coverage spans ATP, WTA,
Challenger, ITF and the junior Grand Slam draws — depth differs by tour
and surface; GET /history/coverage states the measured numbers.
Access is tiered (FREE / BASIC / PRO / ULTRA). Each tier includes
everything in the tiers below it; the concrete deltas are:
FREE — self-serve, no card (https://livetennisapi.com/subscribe/free).
Live and upcoming matches, current scores, players, fixtures, the
tournament catalogue (/tournaments), and your own usage stats.
30 requests/minute, 100/day. No market prices, no model fields, no
WebSocket. Historical results are not part of the tier, but a FREE key
may spend 20 calls per calendar month on the history endpoints as a
taste of the product — served exactly like an entitled call. Past that
they answer 403 upgrade_required carryingfree_history_taste: "used".
BASIC — adds historical data: the completed-match listing
(/history/matches, and status=completed on /matches), the
per-match point-by-point tape with the model win-probability on the
rows where the model ran
(/history/matches/{matchId}), the measured completeness rollup
(/history/coverage), and the results archive (1968–2022) —
deep results (/history/archive/matches), archive player bios
(/history/archive/players), career aggregates
(/history/archive/career) and head-to-head (/h2h).
60 requests/minute, 1,000/day.
PRO — adds match events (/matches/{matchId}/events), market prices
(/markets, /markets/{matchId}/prices, /matches/{matchId}/prices),
the pre-built monthly bulk history packages (/history/packages), the
rank-ordered rankings listing (/rankings?system=) and one player's
win/loss and set-based record (/players/{playerId}/stats).
300 requests/minute, 10,000/day.
ULTRA — adds model analysis (/matches/{matchId}/analysis), the live
model fields (win_probability_p1, danger) on every score object,
in-play match statistics (/matches/{matchId}/statistics) and their
per-player sums (serve_return on /players/{playerId}/stats), per-player
as-of ranking records (/rankings?player=), the as-of Elo tape
(/rankings?system=elo — both modes, plus kind=elo bulk packages),
rally construction
(/rally/matches, shot-by-shot charted data), career and per-match
charting stats (/charting/players, /charting/matches/{chartingMatchId}),
the reconstructed 2013–2022 archive tape
(/history/archive/matches/{archiveId}/tape — also opened by ANY active
History plan, Starter included), the WebSocket live feed at /ws and the
high-fan-out push feed (/ws-token), and outbound webhooks (direct keys).
600 requests/minute, 500,000/day.
History runs in two continuous halves, deliberately non-overlapping: the
point-by-point tape (2023→now) covers January 2023 to now, match by
match, point by point; the results archive (1968–2022) covers 1968
through 2022 as winner/loser-shaped RESULTS (final score, seeds, ranks at
the time — no point-by-point). The archive ends exactly where the tape
begins, so no match is ever served from two datasets.
Archive results played 2013–2022 additionally carry a RECONSTRUCTED
point-by-point tape at /history/archive/matches/{archiveId}/tape — the
score sequence behind the published result: reconstructed point sequences,
no capture timestamps. 97,901 matches / 14,340,663 rows, seasons **2013–2022
ONLY**: the archive holds a further 977,903 results from 1968–2012 and NOT
ONE of them has a tape, because we hold no point sequence for those years and
we do not manufacture one. Write the range as
2013–2022, never as "pre-2023" — the second phrasing reads as 1968 onward
and is wrong by 45 seasons.
Nobody watched those matches, and the data says so: timestamp,win_probability_p1 and danger are null on EVERY row and cannot be
filled in later — the production table has no timestamp column at all, and
the promotion script refuses to run if one ever appears.
Contrast the 2023→now tape, which is our own recording: the rows we
actually watched carry a real clock, and most of them a model probability.
Coverage of the era is real but partial — 19.3% of archive matches played
2013–2022 and 44.9% of tour-level play; main-draw tour buckets run
91.6–98.7%, ATP Challenger main draws 55.3% and Challenger qualifying
33.6%, slam QUALIFYING only 16.0% (ATP) / 18.1% (WTA), and ITF/futures
effectively nothing (25 of 116,575 ATP futures matches). It is not a
complete record of the era and is not sold as one.
Two different gates, on purpose: the per-match tape needs core ULTRA **or
any active History plan, Starter included**; the per-year bulk files
(/history/packages?kind=archive_tape, 2013–2022, JSONL + CSV) need core
ULTRA or a History Pro/Business subscription (an active one-off package
window counts). Core PRO carries NEITHER — it reads the archive RESULT and
is refused the tape.
A call above your tier returns…
Endpoints 49
- GETLiveness probe (no auth)
/health - GETList matches by lifecycle status (FREE)
/matchesstatus=live and status=upcoming are the FREE current-state picture. status=completed pages historical results and is part of the paid History product — it… - GETFull match detail (FREE; +market PRO, +analysis ULTRA)
/matches/:matchId - GETCurrent score only — lowest-latency REST read (FREE)
/matches/:matchId/scoreThis is a POINT-IN-TIME SNAPSHOT: the single current state, overwritten on every score commit. It carries no history and no accumulated statistics. For the… - GETMatch events, newest first (PRO)
/matches/:matchId/events - GETSlate-wide events feed — every match's events in one call, oldest first, cursor by id (PRO)
/eventsAdded 2026-09-13. The rows of GET /matches/{matchId}/events for EVERY match in one request, so a poller watching the whole live slate spends one request per… - GETOne player's in-match stoppages and did-not-finish outcomes, newest first over a window (PRO)
/players/:playerId/stoppagesAdded 2026-09-16. Medical timeouts and trainer calls on the player's matches (from the stoppage family of GET /matches/{matchId}/events), plus retirements and… - GETAlias of /players/{playerId}/stoppages — the identical response (PRO)
/players/:playerId/injuriesAdded 2026-09-16. The same handler, parameters, rows and meta as /players/{playerId}/stoppages, under the word the request used. The honest name is stoppages:… - GETThe per-match status ledger — every status / event_status transition with its UTC instant (BASIC, history)
/matches/:matchId/status-historyAdded 2026-09-12. Append-only, oldest first: one row per change of status and/or event_status, with the instant we published it, the value before and the… - GETThe durable record of every score state we withdrew on this match (ULTRA)
/matches/:matchId/withdrawalsAdded 2026-09-25. One row per refused sequence, oldest first, each carrying the score_withdrawn frame exactly as the push feed sent it. This is the RECOVERY… - GETModel analysis for a match (ULTRA)
/matches/:matchId/analysisThe model's thesis and profile for one match. COVERAGE IS NOT UNIVERSAL, and a polling client should plan for that. Analysis is produced per match by the… - GETIn-play statistics — aces, double faults, serve split, hold/break %, break points, service & return points (ULTRA)
/matches/:matchId/statisticsIn-play statistics for one match, in TWO families that are deliberately not merged. DERIVED (the top level of players.pN) are rebuilt from the point-by-point… - GETLive per-point events in seq order — the REST catch-up for the WebSocket point stream (ULTRA)
/matches/:matchId/pointsThe live per-point event stream of one match, in seq order. The WebSocket point frames are best-effort with NO replay, so this endpoint is how you join… - GETSearch players by name (FREE)
/players - GETOne player's bio + ranking + cached stats (FREE)
/players/:playerIdplayerId is a ROSTER id — the live player registry, the id space /players, /matches and /rankings all speak. It is NOT the archive corpus person id. The… - GETOne player's record over our completed singles matches — W/L splits, set-based record, recent matches (PRO; +serve_return ULTRA)
/players/:playerId/statsAdded 2026-10-22. Aggregates over OUR OWN completed singles matches (2023 onward); the default window is the 365 days ending now. For 1968–2022 use… - GETTournament catalogue — the id space `Match.tournament_id` joins (FREE)
/tournamentsStable tournament identity, one row per tournament × event type, stable across seasons. city/country come from a curated table and category only where our… - GETOne tournament by its stable id (FREE)
/tournaments/:tournamentId - GETThe match's match-winner market (PRO)
/markets?match_id=0The match-winner market mapped to this match — data holds at most one object, and meta.count is 0 when nothing is mapped. MATCH-WINNER ONLY. No handicaps or… - GETMarket + recent price ticks per side, newest first (PRO)
/markets/:matchId/pricesThe mapped match-winner market for one match, with its recent price ticks per side, newest first. 404 with error: no_market (since 2026-09-02; match_id and… - GETBare price ticks of the mapped match-winner market, newest first (PRO)
/matches/:matchId/pricesRecent ticks only (no market wrapper). limit caps at 500; minutes bounds the lookback window; cursor pages an older match. 404 no_market when the match exists… - GETPer-point price history — the match-winner quote in force at every played point (PRO)
/history/matches/:matchId/pricesOne row per played point of a match with a mapped market, ascending by seq (added 2026-09-15). Each row carries the score state the BASIC tape publishes and,… - GETCompleted matches, newest first, with derived winner and tape coverage (BASIC)
/history/matchesRequires BASIC on the live API, or any Historical Data API plan (Starter and up — see https://livetennisapi.com/historical-tennis-data-api). A FREE key may… - GETMeasured completeness rollup per tour × draw bucket (BASIC)
/history/coverageRequires BASIC on the live API, or any Historical Data API plan (Starter and up — see https://livetennisapi.com/historical-tennis-data-api). A FREE key may… - GETPer-match tape — point-by-point score + per-point model probabilities (BASIC)
/history/matches/:matchIdThe tape is the point-by-point score sequence we hold for this match — every recorded score row including the model fields win_probability_p1 and danger at… - GETPublished data-quality incidents (BASIC)
/history/incidentsEvery data-quality incident we have published, oldest window first. This is the register to reconcile against when a published value changed after you read… - GETThe matches one incident affected, as JSONL or CSV (BASIC)
/history/incidents/:incidentId/matchesOne row per affected match, streamed as JSONL by default or CSV with ?format=csv. Columns are incident_id, match_id, tournament, tour, round, draw_stage,… - GETResults archive (1968–2022) — deep historical results (BASIC)
/history/archive/matchesCompleted-match RESULTS from a licensed historical corpus — ATP and WTA main draws, qualifying/challengers and futures tiers, 1968 through 2022.… - GETOne archive result, with serve statistics where recorded (BASIC)
/history/archive/matches/:archiveIdSame entitlement as the archive listing. stats is null for the (mostly pre-1991) rows the source never recorded statistics for — never synthesised. A result… - GETReconstructed 2013–2022 point-by-point tape for one archive result (ULTRA, or any History plan)
/history/archive/matches/:archiveId/tapeThe score sequence behind a 2013–2022 archive result: RECONSTRUCTED POINT SEQUENCES, NO CAPTURE TIMESTAMPS. The result tells you what happened; this tells you… - GETArchive player bios — hand, DOB, country, height, career-high (BASIC)
/history/archive/playersPeople of the results archive (1968–2022), in their own id space — id is the corpus person id that archive match rows carry as winner.player_id /… - GETCareer aggregates over the results archive, 1968–2022 (BASIC)
/history/archive/career?name=stringOne player's whole archive career in one response: W-L record (overall, by surface, by level, by year), titles, and the summed serve-stat block with derived… - GETHead-to-head across the results archive (1968–2022) and our own completed matches (2023→now) (BASIC)
/h2h?p1=string&p2=stringThe record between two players, assembled from BOTH halves of the product: the results archive, where the winner is a stored column, and our own completed… - GETList the pre-built monthly bulk history packages (PRO)
/history/packagesBulk downloads are a heavier product than single-match tape reads. Requires PRO on the live API, or the Historical Data API Pro plan and up, or a one-off… - GETOne monthly package — manifest, or the bulk file itself (PRO)
/history/packages/:periodWithout format returns the package manifest (file set, counts, sha256). With format=jsonl or format=csv streams that file as an attachment. Same entitlement… - GETUpcoming scheduled fixtures, earliest first (FREE)
/fixturesOne row per schedule entry, keyed on the schedule's own event key. A fixture bound to a match (match_id set) is served with the MATCH's status (mapped onto… - GETYour own usage vs quota (FREE — any tier)
/usageDurable daily usage for the calling key: tier, limits, today's calls (current to the second) and a 30-day history. The per-minute window is on the… - GETRankings and Elo — rank-ordered listing (PRO) or per-player as-of records (ULTRA); the as-of Elo tape is ULTRA in both modes
/rankingsReturns, per ranking system, the newest record effective ON OR BEFORE as_of — never one dated after it. Every other ranking field in this API is the player's… - GETCharted matches with shot-by-shot data (ULTRA)
/rally/matchesCharted matches, newest first. RALLY CONSTRUCTION IS THE LAYER BELOW THE TAPE: the tape says what the score became after each point, this says how the point… - GETRally construction for one charted match (ULTRA)
/rally/matches/:rallyMatchIdOne charted match with its points, in play order. Paged with limit/offset; meta.total is the match's full point count. - GETRally construction by OUR match id (ULTRA)
/history/matches/:matchId/rallyRally construction addressed by OUR match id, resolved through the optional link. Answers 404 {"error":"not_charted"} when we hold the match but nobody… - GETCareer shot-level charting aggregate for one player (ULTRA)
/charting/players?name=stringThe deepest serve/return profile we hold: serve placement (deuce/ad × wide/body/T), return depth and outcomes, net and serve-and-volley conversion, clutch… - GETOne charted match, every stat family for both players (ULTRA)
/charting/matches/:chartingMatchIdEvery charting stat family for one charted match, both players, with the per-set split (row/set 1, 2, Total) exactly as charted. chartingMatchId is this… - GETList your webhooks (ULTRA, direct keys only; never includes the secret)
/webhooks - POSTRegister an outbound webhook (ULTRA, direct keys only)
/webhooksWe POST the same frames the WebSocket sends to your HTTPS endpoint on every live score commit. Up to 3 webhooks per key (409 webhook_limit past that). The… - DELETERemove one of your webhooks (ULTRA, direct keys only)
/webhooks/:webhookId - GETOne flat object for on-air graphics (ULTRA)
/broadcast/match/:matchIdAdded 2026-09-24, from a broadcaster's request. ONE flat JSON object for one match, built so a graphics template can bind each field to a fixed path. Three… - GETThe broadcast object for every live match (ULTRA)
/broadcast/liveThe same object as GET /broadcast/match/{matchId}, for every actively-live match, in one call. A ticker or a multi-match wall polls this instead of one URL… - GETMint a connection token for the high-fan-out push feed (ULTRA)
/ws-tokenReturns a short-lived signed token plus the push WebSocket URL and the channel vocabulary: match:{match_id} per-match streams and slate:all for every live…
API details
- Base URL
https://api.livetennisapi.com/api/public/v1- Authentication
- A bearer token in the Authorization header
An API key in the X-API-Key header - Operations
- 49 operations on 48 pathsGET 47POST 1DELETE 1
- Response formats
application/jsonapplication/x-ndjsontext/csv- Description format
- OpenAPI 3.1.0, API version
1.13.85 - Links
- OpenAPI document · Terms of service · Support
How to test the Live Tennis API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Live Tennis API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Liveness probe (no auth)” (GET /health), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Live Tennis API?
Real-time tennis scores, player data, match-winner market prices, and model-driven match analysis. Read-only. Coverage spans ATP, WTA, Challenger, ITF and the… It is listed under Data & analytics and has 49 endpoints.
Who publishes the Live Tennis API?
It is listed from Live Tennis API's public API description (an OpenAPI document), not published by Live Tennis API on Swastik Codes. Anyone who controls livetennisapi.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Live Tennis API?
Requests go to https://api.livetennisapi.com/api/public/v1. Endpoint paths are added to this base URL.
How do I authenticate with the Live Tennis API?
It accepts 2 methods: A bearer token in the Authorization header; an API key in the X-API-Key header.
How many endpoints does the Live Tennis API have?
49 operations on 48 paths (47 GET, 1 POST, 1 DELETE).
Is forking the Live Tennis API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.