Статистика тенниса в JSON: эйсы, двойные ошибки и брейк-пойнты из live API
Что отдаёт live API по теннису в JSON: счёт по сетам, геймам и очкам, восемь показателей подачи на каждого игрока и подсобытия по эйсам, двойным ошибкам и брейкам, с кодом для разбора.

Live API по теннису отдаёт сразу три уровня счёта — сеты, геймы и очки — и короткий блок статистики подачи на каждого игрока: эйсы, двойные ошибки, процент первой подачи, очки на первой и второй подаче, реализация брейк-пойнтов, брейки. Всё это приходит в JSON в том же объекте матча, что и коэффициенты, так что один запрос кормит и табло, и панель статистики, и купон.
Мы проверили это 4 ноября 2026 на тестовом ключе во время матча ATP Paris Александр Зверев — Лоренцо Музетти. Список events по теннису вернул 54 live-матча, а в объекте матча были score_full: "0:0" для сетов, score_period: "1:1" для геймов, score_extra: "40:0" для очков, period_name: "1st set" и stat_list из восьми показателей. У того же матча были подсобытия «Эйсы», «Двойные ошибки» и «Брейки» со своими рынками. Ниже — что означает каждое поле, как читать его в коде и чего в линии нет.
Данные идут из Sport Line API — линии и live-данных SportAPI; теннис в ней — вид спорта 4. Страница продукта по этому виду спорта — API коэффициентов на теннис.
Почему теннис показывать сложнее, чем счёт в футболе
У футбольного матча один счёт и часы. У теннисного — счёт внутри счёта внутри счёта, а часов нет вовсе:
| Уровень | Как часто меняется | Поле в API | Пример |
|---|---|---|---|
| Сеты | Раз в 30–60 минут | score_full | "1:0" |
| Геймы в текущем сете | Каждые несколько минут | score_period | "5:1" |
| Очки в текущем гейме | Каждый розыгрыш | score_extra | "40:0" |
| Какой сет идёт | В конце сета | period_name | "2nd set" |
Поле timer у тенниса равно 0: матчевых часов нет, и интерфейс с «сыграно минут» ошибается по построению. Подача переходит каждый гейм, сет может закончиться тай-брейком, матчи бывают до двух и до трёх выигранных сетов, игрок может сняться посреди сета. Линия, которая отдаёт только «1:0», бесполезна для live-страницы; линия, которая отдаёт все три уровня, но без устойчивой структуры, превращает разбор в мучение. Структура ниже одинакова от матча к матчу: те же три поля, тот же формат строки.
Откуда берётся live-статистика по теннису
Статистика лежит в массиве stat_list live-матча, и приходит она в двух местах: внутри каждого матча в live-списке и внутри подробного объекта матча.
GET /v1/events/4/0/sub/50/live/en
GET /v1/event/{gameId}/group/live/en
Пути указаны относительно домена API, который вместе с ключом выдаёт менеджер; ключ передаётся в заголовке Package. Первый запрос возвращает все live-матчи по теннису, сгруппированные по турнирам. Если коэффициенты не нужны, добавьте ?odds=false — ответ станет в 2–5 раз меньше, что важно при опросе раз в 7 секунд. Второй запрос возвращает один матч с полным списком рынков и подсобытиями.
Это реальный stat_list из матча Зверев — Музетти в начале первого сета (язык ответа ru):
"stat_list": [
{ "id": 1, "name": "Эйсы", "opp1": "1", "opp2": "1" },
{ "id": 2, "name": "% выигранных очков на первой подаче", "opp1": "100", "opp2": "67" },
{ "id": 3, "name": "Реализация брейкпоинтов %", "opp1": "0", "opp2": "0" },
{ "id": 4, "name": "Двойные ошибки", "opp1": "0", "opp2": "1" },
{ "id": 7, "name": "% выигранных очков на второй подаче", "opp1": "100", "opp2": "67" },
{ "id": 8, "name": "Реализовано первых подач", "opp1": "50", "opp2": "50" },
{ "id": 30, "name": "Очки на своей подаче", "opp1": "4", "opp2": "4" },
{ "id": 98, "name": "Брейки", "opp1": "0", "opp2": "0" }
]
Три правила чтения. Значения — строки, даже числа, поэтому перед сравнением и отрисовкой полосок их нужно привести к числу. opp1 всегда относится к opp_1_name, opp2 — к opp_2_name: если интерфейс меняет игроков местами, значения меняются вместе с ними. Для логики используйте id, потому что name зависит от языка: запросите матч на английском, и «Эйсы» станут Aces, а id: 1 останется.
id | Показатель | Тип | Как показывать |
|---|---|---|---|
1 | Эйсы | счётчик | число на игрока |
4 | Двойные ошибки | счётчик | число на игрока |
8 | Реализовано первых подач | процент | полоска, попадание первой подачи |
2 | Выигранные очки на первой подаче | процент | полоска |
7 | Выигранные очки на второй подаче | процент | полоска |
30 | Очки на своей подаче | счётчик | число на игрока |
3 | Реализация брейк-пойнтов | процент | полоска |
98 | Брейки | счётчик | число на игрока |
Статистика есть только пока матч идёт. В prematch-объектах stat_list нет, а когда матч уходит из live-линии, статистика уходит вместе с ним. Если итоговые цифры нужны после матча, сохраните их из последнего live-ответа сами. И не у каждого live-матча статистика есть: в сохранённом снимке из документации она была у 16 матчей из 39 по всем видам спорта, так что пустой stat_list: [] — это «по матчу статистики нет», а не ошибка.
Разбираем счёт: сеты, геймы и очки в коде
Все три строки счёта одного формата, "слева:справа", поэтому форматтер умещается в несколько строк:
// score_full: сеты, score_period: геймы текущего сета, score_extra: очки текущего гейма
function tennisScore(match) {
const [sets1, sets2] = match.score_full.split(':');
const [games1, games2] = (match.score_period || '0:0').split(':');
const points = match.score_extra || ''; // "40:0" во время гейма, "0:0" или "" между геймами
return {
sets: `${sets1}-${sets2}`,
games: `${games1}-${games2}`,
points,
set: match.period_name, // "1st set", "2nd set", ...
stats: Object.fromEntries(
(match.stat_list || []).map((s) => [s.id, [Number(s.opp1), Number(s.opp2)]]),
),
};
}
// { sets: "0-0", games: "1-1", points: "40:0", set: "1st set", stats: { 1: [1, 1], 4: [0, 1], ... } }
Двух вещей в ответе нет, и выдумывать их не стоит. Нет поля «кто подаёт»: если макету нужен маркер подачи, придётся вести его самим по счёту геймов, а тай-брейк это правило ломает. И нет раскладки по завершённым сетам: score_full — это счёт по сетам, а не геймы каждого сыгранного сета. Геймы по сетам приходят после матча в линии результатов (об этом ниже).
Список live опрашивайте не чаще раза в 7 секунд, один матч — раз в 5. Между запросами счёт по очкам меняется быстрее, и это нормально: показывайте то, что пришло в последнем ответе, и не анимируйте таймер, потому что его нет.
Эйсы, двойные ошибки и брейки как подсобытия
В подробном объекте матча есть массив sub_games. У матча, который мы проверяли, в нём было 11 подсобытий, у каждого свой game_id:
1st set · 2nd set · Quick events · Quick events,1st set
Aces · Aces,1st set · Double Faults · Double Faults,1st set
Breaks · Breaks,1st set · Breaks,2nd set
Подсобытие в API — отдельный объект матча. Запросите его тем же методом event, и получите его собственные рынки и собственный счёт. У подсобытия «Эйсы» счёт — это и есть число эйсов: в тот момент score_full был "1:1", по одному эйсу у каждого, а рынки — тоталы на матч и на каждого игрока: больше 4,5, 9,5 и 14,5, плюс Total 1 и Total 2 по игрокам:
// подсобытия по статистике ищем по имени; каждое запрашивается как матч
const statSubs = match.sub_games.filter((s) =>
/^(Aces|Double Faults|Breaks)$/.test(s.game_name),
);
for (const s of statSubs) {
const sub = await fetchLine(`/v1/event/${s.game_id}/group/live/en`, 5_000);
// sub.score_full: текущий счётчик, например "1:1" эйсов
// sub.game_oc_list: тоталы на матч и на игрока
// sub.game_mid: ссылка на основной матч
}
Здесь статистика и ставки встречаются. Число из stat_list говорит читателю, сколько эйсов уже подано; рынок подсобытия — чего линия ждёт от всего матча. Страница статистики тенниса, где рядом стоят «Эйсы: 7 / больше 14,5 за 1,36», собирается ровно из этих двух объектов. Поле game_mid у подсобытия указывает на основной матч, так что всё группируется на одной странице.
Что собрать на live-данных по теннису
Панель live-статистики для теннисного сайта. Опрашивайте events по виду спорта 4 с ?odds=false раз в 7 секунд, рисуйте три уровня счёта и восемь показателей полосками. Один опросчик на сервере обслуживает всех посетителей из кеша; ключ API остаётся на сервере. Виджет трекера матчей поддерживает теннис и доступен для матча, когда заполнено поле zp; у матча в Париже оно было заполнено.
Входные данные для модели вероятности победы. Люди ищут «tennis win probability API», а вероятностей линия не отдаёт. Она отдаёт две вещи, которые нужны модели: live-статистику подачи и текущие коэффициенты. Двухисходный рынок без маржи даёт базовую оценку, а модель корректирует её по статистике:
def implied_probability(k1: float, k2: float) -> tuple[float, float]:
"""Рынок с двумя исходами: убираем маржу букмекера пропорционально."""
p1, p2 = 1 / k1, 1 / k2
total = p1 + p2 # больше 1 из-за маржи
return p1 / total, p2 / total
implied_probability(1.304, 3.57) # (0.73, 0.27): Зверев — Музетти при 1-1 в первом сете
Коэффициенты 1.304 и 3.57 — это исходы W1 и W2 рынка 1x2 из того же ответа; ничьей в теннисе нет, поэтому у рынка две колонки. Как от базовой оценки перейти к обученной модели, рассказано в статье о прогнозной модели на Python; для тенниса подход тот же, признаки — статистика подачи.
Алерты. Брейк, тай-брейк, третий сет — всё это изменения полей, которые вы и так опрашиваете. Breaks сменился с 0 на 1, score_period дошёл до 6:6, period_name стал 3rd set. Цикл опроса и доставка в Telegram описаны в статье про бота live-сигналов; теннисная часть — только условие.
Расписание до матча и результаты после
Live-линия — один из трёх источников, и они не пересекаются:
| Когда | Что получаете | Где |
|---|---|---|
| До матча | Турниры, участники, время начала, prematch-рынки | events с типом line; календарь матчей /v1/events/4/0/sub/50/line/{hours}/{days}/ru — на сегодня, завтра или ближайшие часы |
| Во время матча | Счёт по сетам, геймам и очкам, stat_list, live-рынки, подсобытия | events и event с типом live |
| После матча | Итоговый счёт по сетам и геймы каждого сета | API результатов матчей, от $25 в месяц за один вид спорта, +$10 за каждый дополнительный язык |
Две детали для расписания. Парные матчи приходят с массивами opp_1_ids и opp_2_ids — по два ID участников на сторону, а имена остаются в opp_1_name и opp_2_name. И при переходе из prematch в live матч получает новый game_id, поэтому связывайте prematch- и live-записи по участникам и времени начала, а не по ID.
Подробной исторической статистики игроков, личных встреч и средних по сезону нет ни в live-линии, ни в результатах. Отдельный API статистики для этого в разработке; спросите о нём у менеджера вместо того, чтобы парсить сайты рейтингов.
Чего в линии нет
- Статистики по prematch и завершённым матчам.
stat_listесть только в live. Сохраняйте последние live-значения, если они нужны потом. - Маркера подачи. Поля «кто подаёт» нет.
- Матчевых часов.
timerу тенниса равен0. - Вероятностей победы. Считайте их из коэффициентов и статистики у себя.
- Гарантированной статистики по каждому матчу. Турниры низшего уровня могут идти без
stat_list; проверяйте длину массива перед отрисовкой. - Push-канала. WebSocket в разработке; production-интеграции опрашивают API с документированными интервалами.
Ошибки, которые ломают теннисные страницы
- Принять
score_fullза геймы. Это сеты. Геймы — вscore_period. - Сравнивать
opp1как строки."100" > "67"— сравнение строк; сначала приведите к числу. - Искать показатели по
name. Имена зависят от языка. Ищите поid. - Опрашивать
eventпо всем 54 матчам. Детали нужны только по открытому матчу;stat_listесть уже в списке. - Связывать prematch и live по
game_id. Это разные ID. Связывайте по участникам и времени начала. - Показывать таймер. Он всегда
0.
Как проверить на сегодняшних матчах с SportAPI
Тестовый ключ даёт два дня доступа ко всем видам спорта, prematch и live, так что вся проверка укладывается в один вечер:
GET /v1/menu/live/ru— убедитесь, что вид спорта4в списке и счётчик матчей не нулевой.GET /v1/events/4/0/sub/50/live/ru?odds=false— выберите матч с непустымstat_list.GET /v1/event/{gameId}/group/live/ru— прочитайте три поля счёта, статистику иsub_games.- Запросите подсобытие «Эйсы» по его
game_idи сравните егоscore_fullс показателемid: 1вstat_list. - Поопрашивайте матч несколько минут и посмотрите, как меняется
score_extra.
Live-статистика, подсобытия и теннисная линия входят в тариф на один вид спорта — от $30 в месяц. На странице API коэффициентов на теннис перечислены рынки; модель данных live-статистики в документации описывает stat_list для всех видов спорта.
Частые вопросы
Есть ли бесплатный API статистики тенниса?
Как постоянный тариф — нет. SportAPI даёт бесплатный тестовый ключ на два дня со всеми видами спорта и live-данными; этого хватает, чтобы собрать и проверить теннисную страницу. Дальше тариф на один вид спорта — от $30 в месяц.
API говорит, кто подаёт?
Нет. В live-объекте есть счёт трёх уровней и статистика, но маркера подачи нет. Если он нужен, выводите его из счёта геймов, а тай-брейк обрабатывайте отдельно.
Можно получить эйсы и двойные ошибки по завершённому матчу?
Из линии результатов — нет, она отдаёт счёт по сетам и геймам. Статистика доступна, пока матч идёт, поэтому сохраняйте последние live-значения, если они понадобятся после. Подробная историческая статистика — отдельный продукт, он в разработке.
Какие турниры есть в линии?
В наших проверках в live-списке были турниры ATP, WTA и Challenger. Покрытие меняется вместе с календарём, поэтому нужный турнир проверьте через menu на тестовом ключе, прежде чем обещать его пользователям.
Линия отдаёт вероятность победы?
Нет. Она отдаёт коэффициенты, из которых считается подразумеваемая вероятность, и live-статистику, которую можно подать в собственную модель.
Данные по теннису есть на других языках?
Да. Код языка в URL меняет name в stat_list, названия периодов и рынков. ID показателей и строки счёта остаются теми же.
Что проверить перед подключением
Откройте сегодня live-матч на тестовом ключе и посмотрите на четыре вещи: три поля счёта меняются по ходу розыгрышей, в stat_list восемь показателей, счёт подсобытия «Эйсы» совпадает с числом эйсов, а нужный турнир есть в menu. Если все четыре проверки прошли, теннисная страница — это день работы над фронтендом поверх цикла опроса. Попросите ключ у менеджера SportAPI в Telegram и прогоните проверку на вечерних матчах.