Live, pre-match, and historical tennis odds in one API.
Query active live prices, upcoming ATP/WTA/Challenger/ITF markets, tick-by-tick price history back to November 2024, and real-time WebSocket frames (`odds:{matchId}`) matched 1:1 to canonical match IDs and 1968+ surface Elo.
- Live & upcoming market prices
- Tick history back to Nov 2024
- WebSocket odds:{matchId} (Scale/Business or Pro +$15)
{ "success": true, "items": [ { "match_id": "m_2026_4893994", "tour": "ATP", "tournament": "ATP World Tour Finals, John McEnroe Group", "home": { "id": "atp_210097", "name": "Ben Shelton" }, "away": { "id": "atp_209950", "name": "Arthur Fils" }, "live": true, "market_status": "open", "h2h": { "player1_prob": 0.965, "player1_odds": 1.04, "player2_prob": 0.035, "player2_odds": 28.57 }, "liquidity_usd": 214342.38, "volume_usd": 308203.09 } ]}Seamless Integration with our MCP Server
Give Claude, Cursor, and ChatGPT the tennis data. One command configures the MCP server so agents call real player IDs, surface Elo, live odds, and match logs instead of hallucinating them.
MCPInstall the Cito MCP serverBuilt for execution and backtesting
Stop stitching brittle odds scrapers to third-party player tables. Scores, serve stats, Elo, and market prices share one canonical ID.
Five dedicated odds routes
/tennis/odds/live, /upcoming, /{match_id}, /{match_id}/live, and /{match_id}/history out of the box.
Multi-market depth
H2H match winner, set winner, set handicap, game spreads, and match/set totals where traded.
Sub-second WebSocket ticks
Subscribe to odds:{matchId} for tennis.odds.snapshot and tennis.odds.updated (Scale $100, Business $299, or Pro +$15/mo).
Tick-by-tick backtests
Replay price movement with live score and timestamp tags via /tennis/odds/{match_id}/history back to Nov 2024.
Inline with ?include=odds,elo
Join current market odds and point-in-time surface Elo directly inside /tennis/matches calls.
3-day free trial
Every new Free API key gets 3 days of live odds and Elo access before picking Pro ($59/mo) or Business CSV ($299/mo).
Which endpoints serve tennis odds and ticks?
Every route uses the canonical match_id returned by /tennis/matches/live and /tennis/matches/upcoming. No separate odds mapping table is needed.
| Endpoint | Purpose | Access |
|---|---|---|
| GET /api/v1/tennis/odds/live | Active in-play prediction-market prices, spreads, totals & USD liquidity | Pro ($59+) & 3-day Free trial |
| GET /api/v1/tennis/odds/upcoming | Upcoming scheduled matches with pre-match & opening prices | Pro ($59+) & 3-day Free trial |
| GET /api/v1/tennis/odds/{match_id} | Full market breakdown for one match (h2h, set_winner, spreads, totals) | Pro ($59+) & 3-day Free trial |
| GET /api/v1/tennis/odds/{match_id}/live | Latest live price snapshot for an in-play match | Pro ($59+) & 3-day Free trial |
| GET /api/v1/tennis/odds/{match_id}/history | Historical tick series with live score context since Nov 2024 | Pro ($59+) & 3-day Free trial |
| WSS /api/v1/tennis/live/ws (odds:{matchId}) | Real-time tennis.odds.snapshot & tennis.odds.updated push frames | Scale ($100), Business ($299), or Pro +$15/mo |
Endpoints you can ship with
Inspect live odds, upcoming odds, tick history, and surface Elo endpoints directly.
Odds & tick history
Live and upcoming prediction-market implied probabilities, decimal odds, volume metrics, and tick-by-tick price history back to November 2024.
- GET
/api/v1/tennis/odds/liveLive in-play prediction-market odds and volume.
- GET
/api/v1/tennis/odds/upcomingUpcoming matches with market odds and liquidity.
- GET
/api/v1/tennis/odds/{match_id}Current prediction-market odds for one match.
- GET
/api/v1/tennis/odds/{match_id}/liveReal-time live market snapshot for one match.
- GET
/api/v1/tennis/odds/{match_id}/historyTick-by-tick historical price series since Nov 2024.
Surface Elo
Point-in-time overall, Hard, Clay, and Grass Elo ratings and pre-match win probabilities across 2.1M+ matches back to 1968.
- GET
/api/v1/tennis/rankings/eloSurface and overall Elo leaderboard by tour and surface.
- GET
/api/v1/tennis/players/{player_id}/eloSingle player's surface Elo trajectory and recent match probabilities.
- GET
/api/v1/tennis/matches?include=stats,elo,oddsJoin serve stats, Elo ratings, and odds in one match list call.
Live scores
Every match in progress with the set scores, the game score, who is serving, and live match stats. Open one match for its full state.
- GET
/api/v1/tennis/matches/liveMatches in progress: sets, game score, server, and live stats.
- GET
/api/v1/tennis/matches/live/{match_id}One live match: every set, the current game, and both players' stats.
- GET
/api/v1/tennis/matches/{match_id}/statusScheduled, in progress, or finished, with the result once decided.
- GET
/api/v1/tennis/scheduleThe day's order of play across tours.
- GET
/api/v1/tennis/matches/upcomingScheduled matches, soonest first.
Results
Finished matches with the score of every set, the winner and loser, and the serve and return box score behind them.
- GET
/api/v1/tennis/matches/recentFinished matches, newest first, with set scores.
- GET
/api/v1/tennis/matches/completedEvery match completed on a given day.
- GET
/api/v1/tennis/matches/{match_id}One match: tournament, round, surface, score, and box score.
- GET
/api/v1/tennis/matches/{match_id}/statsAces, double faults, first-serve %, points won, break points.
- GET
/api/v1/tennis/matches?player_id=&year=&surface=The archive, filtered by player, opponent, year, surface, level or round.
Players
Player profiles with country, hand and birth date, career serve and return stats, recent form, and every match played.
- GET
/api/v1/tennis/players/search?q={name}Find a player by name and get their id.
- GET
/api/v1/tennis/players/{player_id}Name, country, hand, height, birth date and ranking.
- GET
/api/v1/tennis/players/{player_id}/statsCareer and season serve, return and win-loss stats.
- GET
/api/v1/tennis/players/{player_id}/formRecent results and win rate.
- GET
/api/v1/tennis/players/{player_id}/matchesThe player's match log, newest first.
Head-to-head
The full record between two players, split by surface and level, or a grid of records across a group of players.
- GET
/api/v1/tennis/h2h?player1_id=&player2_id=Wins, losses and every meeting between two players.
- GET
/api/v1/tennis/h2h/{player1_id}/{player2_id}The same record in path form.
- GET
/api/v1/tennis/h2h/matrix?player_ids=A head-to-head grid for several players at once.
Rankings
Weekly ATP and WTA singles rankings with points and movement, back through the decades, and any player's ranking history.
- GET
/api/v1/tennis/rankingsA full weekly ranking table for ATP or WTA.
- GET
/api/v1/tennis/rankings/topThe top N players of the latest list.
- GET
/api/v1/tennis/rankings/moversBiggest risers and fallers between two lists.
- GET
/api/v1/tennis/rankings/history/{player_id}One player's ranking, week by week.
- GET
/api/v1/tennis/rankings/datesEvery ranking date on file.
Tournaments
Tournaments from Grand Slams to ITF events, the season calendar, and the draw of any edition as a bracket.
- GET
/api/v1/tennis/tournamentsTournaments filtered by tour, level, surface and year.
- GET
/api/v1/tennis/tournaments/calendar?year=2026One season's tournament calendar.
- GET
/api/v1/tennis/tournaments/{tournament_id}One tournament: level, surface, location and editions.
- GET
/api/v1/tennis/tournaments/{tournament_id}/drawThe draw of the latest edition.
- GET
/api/v1/tennis/tournaments/{tournament_id}/editions/{year}/drawThe draw of any past edition.
Leaderboards
Season leaders for the stats that decide matches, computed from every match box score.
- GET
/api/v1/tennis/leaderboards/acesMost aces in the season.
- GET
/api/v1/tennis/leaderboards/1st-serve-wonBest first-serve points won %.
- GET
/api/v1/tennis/leaderboards/break-conversionBest break-point conversion.
- GET
/api/v1/tennis/leaderboards/tiebreak-win-pctBest tiebreak record.
- GET
/api/v1/tennis/leaderboards/comeback-winsMost wins after losing the first set.
Coverage
What the dataset holds: tours, levels, ITF and junior coverage, and the years on file.
- GET
/api/v1/tennis/coverageTours, levels, year range, ITF and junior event counts.
- GET
/api/v1/tennis/competitionsEvery competition with its tour and level.
Figures on this page were checked against the live API on 2026-11-15.
FAQs
Access tiers, tick history, WebSockets, and trials
Can't find what you're looking for? Contact our customer support team
More for tennis pricing & models
- Tennis Elo ratings APIOverall and Hard/Clay/Grass Elo since 1968 with win probabilities.
- Tennis CSV datasetDownload 2.1M+ matches, surface Elo and odds on Business ($299/mo).
- Tennis prediction dataPoint-in-time Elo, surface splits, form and odds for models.
- Cito vs BetsAPIUnified IDs, 1968+ surface Elo and tick history vs basic feeds.
- Cito vs GoalserveTransparent self-serve pricing ($59-$299) vs enterprise contracts.
- Flashscore scraper alternativeZero proxy maintenance with clean JSON and live WebSockets.
- Tennis APILive scores, odds, surface Elo, rankings and stats on one key.
- Tennis API docsEvery endpoint, its parameters, and a real response.
Trade and backtest onย live implied probs
Test live odds right now with a free 3-day trial key, or go straight to Pro ($59/mo) or Business CSV ($299/mo).