Live Tennis API — API Reference

# Live Tennis API — API Reference > Complete endpoint reference for the Live Tennis API. Real-time tennis scores, > players, rankings, match-winner market prices and model win-probability for ATP, > WTA, Challenger and ITF, over REST and WebSocket — plus the point-by-point tape > (2023→now) and the results archive (1968–2022) of deep historical results. Base URL: https://api.livetennisapi.com/api/public/v1 Full text reference: https://docs.livetennisapi.com/reference.html OpenAPI spec: https://docs.livetennisapi.com/openapi.yaml Website: https://livetennisapi.com ## Quickstart (no code required) Open this in a browser — no install, no headers: https://api.livetennisapi.com/api/public/v1/matches?status=live&token=YOUR_KEY Reading a score: every array is PLAYER-MAJOR — first list is player 1, second is player 2. "sets": [1,0] = p1 leads one set to nil. "games": [[6,3],[4,4]] = 6-4 in the first set, 3-4 in the second. "points": ["0","0"] = the game in progress. "server": 1 = player 1 serving. ## Authentication Send the API key as `Authorization: Bearer <key>`, `X-API-Key: <key>`, or `?token=<key>` in the query string. The query form is browser-friendly (clickable links, phones); prefer a header for anything automated, since URLs leak into logs, history and referrers. The /health endpoint requires no key. ## Plans Every plan includes the plans below it. The concrete deltas: - FREE ($0, no card) — live & upcoming matches, current scores, players, fixtures, usage stats. 30 req/min, 100 req/day. No history, no market prices, no model fields, no WebSocket. - BASIC ($9.99/mo) — adds history, in two continuous halves: the point-by-point tape (2023→now) — the completed-match listing and the per-match tape with the model win-probability at every point — and the results archive (1968–2022): deep results, archive player bios, career aggregates and head-to-head (/h2h). 60 req/min, 1,000 req/day. - PRO ($29.99/mo) — adds match events

openapi: 3.1.0 info: title: Live Tennis API version: "1.3.1" contact: name: Live Tennis API url: https://livetennisapi.com license: name: MIT url: https://github.com/livetennisapi/openapi/blob/main/LICENSE termsOfService: https://livetennisapi.com/terms description: | Real-time tennis scores, player data, match-winner market prices, and model-driven match analysis. Read-only. Coverage is every tour equally: ATP, WTA, Challenger, ITF and juniors (the boys'