Every change to the API, newest first. Nothing is removed or renamed without notice here first.
/v1/rankings for a date before our full lists now says how old the list given is (meta.list_age_days: a list stays in force until the next is published). For a date from 16 March 2020 to 10 January 2021 it also carries meta.frozen: the world ranking was frozen then and no new list was published, so the list given is the one that stood through the freeze./v1/predict and the win_chance MCP tool now weigh age in singles. Our rating trails a rising player: since 2010 the side younger by 5 years or more won 5.8 points in 100 more often than its rating said. A shift for the side younger by 5 to 9 years and by 10 or more, fitted on 2010 to 2019, lowered the Brier score on 11,261 singles from 2020 on that it never saw, from 0.1826 to 0.1810. It applies when both players' birth dates are known; age_gap_years gives the gap and meta.model.age the shifts./v1/predict and the win_chance MCP tool now use a scale of their own when the lower-rated side is rated 1512.9 or more. Tested first on 18,751 such matches from 2022 on that it was not fitted on, it lowered the Brier score there from 0.1945 to 0.1939, and on the 3,704 priced among them from 0.193 to 0.192. meta.model.top_level gives the bar and the scale./v1/predict and the win_chance MCP tool take games, the first two games at one game all (21-15,18-21), and add decider: each side's chance of the third game. It starts from the match chance and adds the second game's margin: a second game won by 6 or more carries into the third, and one won by 2 runs slightly the other way. Tested first on 10,597 deciders from 2020 on that it was not fitted on, it scored better there than the match chance alone (Brier 0.2258 against 0.2263). meta.model.decider gives the fit./v1/matches, /v1/tournaments/{id}/draw, player records and our rating, and 150 more results matches are now tied to their draw match./v1/predict and the win_chance MCP tool now add a fitted offset per continent. A rating earned mostly against players from the same region ran high against the strongest: at neutral venues Asian players beat their ratings by about 12 points in 100 and African players fell about 32 short. Tested first on matches from 2020 on that it was not fitted on, the offset lowered the Brier score there from 0.172 to 0.161. Each side now gives its continent, and meta.model.continent_offset the offsets./v1/players/{id}/stats, /v1/h2h, /v1/analysis/records and our rating no longer count them double. Results matches are also tied to their draw match by the edition's dates, which linked 134 more./v1/live, /v1/live/stream and the webhooks: matches in play are now read four times a minute, so a point is here in about 15 seconds. meta.poll_seconds is 15./v1/live/stream on the Live plan: live scores pushed as Server-Sent Events. Every match in play on connect, then each match the moment its score, status or prices change, a heartbeat every 15 seconds, and a fresh connection every 5 minutes (one call each). Two streams at a time per key; filter with discipline. The Python client has live_stream(), a generator of events that reconnects by itself./v1/predict and the win_chance MCP tool now use two fitted scales: one for matches where every player has 10 or more rated matches in the event, and one, fitted on its own, when anyone on court has fewer. Both are fitted to every match since 2010, and meta.model gives both (chance_scale and chance_scale_newcomer)./v1/results, /v1/results/yesterday, /v1/events/{id}, /v1/live and the webhooks now give duration_min: how long a finished match lasted, in minutes, from its start to its final point./v1/events/{id}/points and the match_points MCP tool: every rally of a match, game by game, with the score after it, who won it and who served it, and each side's points won on and against serve and longest run. Rallies are read while a match is in play (Live plan) and again once it has finished (Archive plan)./v1/live is now read twice a minute while a match is in play: meta.poll_seconds is 30./v1/events/{id}; each delivery is signed in X-BDA-Signature and tried 8 times over about 3 days./v1/venues, /v1/venues/{id} and /v1/calendar now give elevation_m: the height above sea level of the venue, or of its host city where the venue has none, with elevation_from saying which./v1/analysis/market now also gives favourite_by_round and favourite_by_seeding: how often the closing favourite won against how often the market expected, round by round and by whether each side was seeded./v1/players/{id}/schedule and the player_schedule MCP tool: every event a player played with its dates, matches, furthest round and the rest days before it, and in meta the days since their last event, events and matches in the last 30, 60 and 90 days and back-to-back weeks, as they stood on any day you name./v1/players/{id} now fills hand and height_cm from the player's own page where the open knowledge base has none, and adds coach./v1/rankings with a date before September 2026 now answers with that week's top list (about 20 to 25 places), back to 2013 (women's singles from 2012); meta.full is false for these and meta.depth says how deep./v1/players/{id}/rankings now includes every week the player was in those top lists./v1/rankings/number-ones and the world_number_ones MCP tool: every world number one in each discipline since the computer ranking began on 1 October 2009, reign by reign, with dates and weeks; on a date, or for one player./v1/players/{id} now gives number_one: weeks at world number one in each discipline, with reigns and dates./v1/odds/{id} and the match_odds MCP tool now carry lines: every handicap and total line priced before play, in games or points, with each bookmaker's opening and closing price and the average close./v1/players/{id} also gives born, hand and height_cm where known./v1/players/{id} now gives career_high: the player's best world ranking with its event, date and doubles partner, for over 2,300 players./v1/tournaments/{id} now gives podium: gold, silver and both bronzes in each event, for editions with a medal table./v1/tournaments/{id}/ties and each player's record./v1/tournaments/{id}/draw takes sport_class, /v1/series/{slug}/champions keys para finals by class ("MS WH1"), /v1/players/{id}/titles gives each final's class, and level=para lists the editions./v1/rankings: each entry names its players as we hold them, with their player ids and, in doubles, both partners./v1/results, /v1/fixtures and /v1/live: tournaments under our own names, and players under ours wherever the match is in a draw./v1/venues and /v1/venues/{id}: meta.source is no longer sent./v1/ratings: an Elo-style rating for every player on any date, with each player's history./v1/predict: the chance each side wins, with a fair price and their head-to-head./v1/analysis/upsets, seeds, deciders, records and market./v1/series/{slug}/champions: the roll of honour of every series./v1/players/{id}/partners, opponents, titles, form, stats and rankings./v1/search: players, pairs, tournaments, series, countries, venues and cities in one call, on every plan./v1/countries and /v1/countries/{code}./v1/calendar: a season in date order with venue, dates and prize money./v1/venues, /v1/venues/{id} and /v1/locations.