SportAPI
Интеграция API

Esports odds API: CS2, Dota 2, LoL — карты, live и рынки для киберспортивных ставок

Как esports odds API описывает серию до нескольких побед: карты как подсобытия, счёт серии и карты в live, рынки по CS2, Dota 2 и LoL и запросы, которые всё это возвращают.

Узел API, связанный с панелями CS2, Dota 2 и LoL: live-матч, список рынков, карты и график live-данных

Киберспортивный матч — это серия, а не одна игра. У серии CS2 до двух побед или Dota 2 до трёх есть счёт серии, счёт на каждой карте и рынки на обоих уровнях. Esports odds API должен возвращать всё это в структуре, которую можно отрисовать: матч с основными коэффициентами, каждую карту как отдельное подсобытие со своими рынками, а в live — счёт серии рядом со счётом текущей карты.

9 ноября 2026 в киберспортивной линии SportAPI было 85 prematch-матчей в 27 турнирах: 15 по CS2, 5 по Dota 2, 2 по League of Legends, плюс Rainbow Six, Honor of Kings, WarCraft III и мобильные шутеры. Ещё 18 матчей шли в live. Ниже — как устроены данные, какие рынки с ними приходят и три запроса, которые возвращают всё. Источник — киберспортивная линия SportAPI, от $30 в месяц, с бесплатным тестовым ключом на два дня.

Что ставкам на киберспорт нужно от ленты

  • Серия и карты по отдельности. «Победа команды A в матче» и «победа команды A на второй карте» — разные ставки с разными ценами.
  • Счёт двух уровней в live. Выигранные карты в серии и раунды или убийства на карте, которая играется сейчас.
  • Рынки, которые следуют формату. Тотал карт, фора по картам и точный счёт имеют смысл в серии до двух побед и меняют форму в серии до трёх.
  • Быстрая реакция между картами. Когда карта заканчивается, её рынки закрываются, а live-рынками становятся рынки следующей.
  • Один формат для всех игр. CS2, Dota 2 и LoL должны приходить в одной структуре, чтобы один фронтенд обслуживал все дисциплины.

Что есть в киберспортивной линии

ИграPrematch-турниров на 9 ноября 2026Примеры
CS215BLAST Rivals, мейджор PGL, ESL Challenger League, серии CCT, региональные лиги
Dota 25Дивизионы DreamLeague и другие серии
League of Legends2Чемпионат мира
Другие дисциплины5Rainbow Six, Honor of Kings, WarCraft III, CrossFire Mobile, Standoff 2

Список следует за турнирным календарём: API показывает только то, где сейчас назначены матчи. Файтинги и спортивные симуляторы идут в том же киберспортивном меню отдельными разделами.

Как устроен матч

Киберспортивные данные запрашиваются с параметром cybersport=true. Объект матча выглядит как любой матч линии, с двумя особенностями в чтении полей счёта.

В live в тот же день матч CS2 на третьей карте и матч Dota 2 на второй выглядели так:

ПолеПример CS2Пример Dota 2Значение
score_full"1:1""1:0"Выигранные карты в серии
score_period"19:16;7:13;1:5""32:8;8:31"Счёт каждой карты, текущая — последняя
period_name"3rd map""2nd map"Карта, которая играется
game_desk"map""map"Тип периода
timer01838Игровое время в секундах, если оно есть в игре

На карте счёт — это раунды в CS2 и убийства в Dota 2. Форматтер для обеих игр:

// score_full: выигранные карты; score_period: счёт каждой карты, текущая — последняя
function esportsScore(match) {
  const maps = (match.score_period || '')
    .split(';')
    .filter(Boolean)
    .map((m) => m.split(':').map(Number)); // [[19, 16], [7, 13], [1, 5]]
  return { series: match.score_full, playing: match.period_name, maps };
}

В подробном объекте матча есть ещё sub_games. У матча чемпионата мира по League of Legends в тот день список был таким:

1st map · 2nd map · 3rd map · 4th map · 5th map
Special bets,1st map … Special bets,5th map
Players' stats,1st map

У каждого подсобытия свой game_id. Запросите его тем же методом event — и получите рынки только этой карты.

Рынки на матч и на карту

По тому же матчу основной объект вернул семь рынков и 26 исходов:

РынокЧто это
Победитель матчаДва исхода: ничьей в серии нет
Точный счётСчёт серии, например 3:1
Тотал картБольше или меньше заданного числа сыгранных карт
Фора по картамФора по картам для одной из команд
Тотал фраговБольше или меньше общего числа убийств
Команда выиграет хотя бы одну картуДля каждой команды

Рынки уровня карты — победитель карты и её тоталы — лежат в подсобытии карты, а подсобытия «Special bets» и «Players’ stats» содержат рынки по особенностям игры и по игрокам, когда они предлагаются. Читайте рынки, которые вернул API, а не зашивайте список в код: набор отличается по игре, турниру и времени до начала.

Три запроса, которые возвращают всё

GET https://YOUR_API_DOMAIN/v1/menu/live/ru?cybersport=true
GET https://YOUR_API_DOMAIN/v1/events/{sportId}/0/sub/50/live/ru?cybersport=true
GET https://YOUR_API_DOMAIN/v1/event/{gameId}/group/live/ru?cybersport=true

В каждом запросе передаётся заголовок Package: YOUR_API_KEY. Домен API и ключ выдаёт менеджер SportAPI. Первый запрос возвращает киберспортивное меню с текущими разделами и турнирами; {sportId} берётся из него. Второй — матчи со счётом и основными коэффициентами; для предстоящих матчей замените live на line. Третий — один матч со всеми рынками и его sub_games, которые описаны в документации по подсобытиям.

Рынки карты приходят тем же третьим запросом с game_id карты:

// карты — подсобытия с именами "1st map", "2nd map", ...
// fetchLine — ваша серверная функция: добавляет заголовок Package и кеширует ответ
const mapSubs = match.sub_games.filter((s) => /^\d(st|nd|rd|th) map$/.test(s.game_name));
for (const s of mapSubs) {
  const map = await fetchLine(`/v1/event/${s.game_id}/group/live/ru?cybersport=true`, 5_000);
  // map.game_oc_list: рынки только этой карты
}

Live: что меняется и как часто спрашивать

Список live опрашивайте не чаще раза в 7 секунд, открытый матч — раза в 5. Между опросами меняются три вещи: счёт текущей карты в score_period, коэффициенты и их флаги oc_block, а когда карта заканчивается — score_full, period_name и набор открытых рынков. Собирайте рынки заново из каждого ответа: исход, который ушёл из ответа, должен уйти и со страницы.

У матчей, которые мы смотрели, был ещё va: 1 — это значит, что по матчу доступна видеотрансляция через отдельный видеосервис. Для киберспортивной страницы это часто первое, о чём спрашивают пользователи.

От коэффициентов к принятым ставкам

Если вы принимаете ставки, указатель исхода из линии уходит в Coupon API, который перепроверяет цену при приёме и рассчитывает ставку после окончания карты или серии. Как устроен расчёт, включая возвраты при отмене матча, — в статье об автоматическом расчёте ставок. Для продукта сообщества без ставок те же данные кормят бота с расписанием и счётом; пример — в статье «Discord-бот для киберспорта».

Чего в ленте нет

  • Истории игроков и статистики команд. Лента — про матчи, счёт и коэффициенты, а не про карьерную статистику.
  • WebSocket. Обновления забираются по REST; WebSocket в разработке.
  • Фиксированного списка игр. Дисциплина есть в меню, когда по ней назначены матчи.

Сколько это стоит

Что нужноСтоимость
Киберспортивная линия: prematch и live, рынки и коэффициентыот $30 в месяц
Приём ставок и автоматический расчётот $300 в месяц
Проверка до оплатыбесплатный тестовый ключ на два дня

Частые вопросы

Какие игры покрывает esports odds API?

В день снимка: CS2, Dota 2, League of Legends, Rainbow Six, Honor of Kings, WarCraft III и мобильные шутеры, плюс файтинги и спортивные симуляторы отдельными разделами. Список следует за турнирным календарём.

Как получить коэффициенты на отдельную карту?

Каждая карта — подсобытие матча со своим game_id. Возьмите его из sub_games и запросите методом event.

Как приходит счёт в live?

score_full — счёт серии по картам, а score_period перечисляет счёт каждой карты, последней идёт текущая. period_name называет эту карту.

Есть ли ничья в киберспортивных рынках?

В серии — нет: у рынка «победитель матча» два исхода. Отдельные форматы могут отличаться, поэтому читайте исходы, которые вернул API.

Можно проверить до оплаты?

Да. Тестовый ключ действует два дня и включает киберспортивную линию с prematch и live.

Что проверить на live-серии

Откройте на тестовом ключе live-матч по CS2 или Dota 2 и дождитесь конца одной карты: score_full меняется, period_name переходит к следующей карте, а рынки сыгранной карты закрываются. Если страница переживает это без перезагрузки, самая сложная часть киберспортивного фронтенда сделана. Домен API и тестовый ключ можно попросить у менеджера SportAPI в Telegram.

← Все статьи