Метод events — список матчей

Для чего нужен метод

Метод events возвращает список матчей выбранного вида спорта. При необходимости список можно ограничить одним турниром.

Ответ содержит:

• информацию о турнире;
• основные данные матчей;
• команды или участников;
• время начала;
• текущий счёт и период для Live;
• краткий набор групп ставок и коэффициентов;
• доступные Live-статистику, видео и ID трекера.

Для получения полного набора ставок одного матча используется метод event.

Полное описание всех полей собрано отдельно: «Единый справочник полей Sport Line API».

Перед запросом

Для запроса нужен sportId. Его можно получить через метод menu или sports.

Если нужны матчи конкретного турнира, также потребуется tournamentId. Его можно получить из menu или tournaments.

Не используйте статически записанные sportId и tournamentId без проверки текущей навигации. Эти ID должны присутствовать в актуальном menu либо быть получены по цепочке sports → countries → tournaments для того же типа live или line.

API показывает только разделы, в которых сейчас есть матчи. Если завершился или исчез единственный матч турнира, турнир пропадёт из следующего навигационного ответа. Если это был единственный матч вида спорта, из ответа исчезнет и сам вид спорта.

Даже при tournamentId=0 значение sportId нужно брать из актуального ответа API.

Запрос

GET https://YOUR_API_DOMAIN/v1/events/{sportId}/{tournamentId}/{format}/{count}/{type}/{lang}

API-ключ необходимо передавать в HTTP-заголовке:

Package: YOUR_API_KEY

Параметры пути

Значения параметра type:

Параметр format

Для списка матчей events используется только формат sub. Он группирует матчи по турнирам:

body
└── турнир
    └── events_list
        └── матчи

Параметр count

Параметр создавался для ограничения количества возвращаемых данных, но это ограничение было отменено. Сегмент остался обязательной частью URL для совместимости.

Всегда передавайте 50. Независимо от этого значения API возвращает все доступные матчи выбранного спорта или турнира. Параметр нельзя использовать для пагинации или ограничения размера ответа.

Необязательный query-параметр

Пример:

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

Сохранённые в этой документации полные ответы получены без query-параметров, то есть при cybersport=false.

Пример запроса Live

В примере запрашиваются все Live-матчи всех доступных футбольных турниров:

curl --request GET \
  --url 'https://YOUR_API_DOMAIN/v1/events/1/0/sub/50/live/ru' \
  --header 'Package: YOUR_API_KEY'

Пример запроса Prematch

В примере запрашиваются все Prematch-матчи всех доступных футбольных турниров:

curl --request GET \
  --url 'https://YOUR_API_DOMAIN/v1/events/1/0/sub/50/line/ru' \
  --header 'Package: YOUR_API_KEY'

Чтобы получить матчи только одного турнира, замените 0 на его tournamentId:

curl --request GET \
  --url 'https://YOUR_API_DOMAIN/v1/events/1/2916716/sub/50/live/ru' \
  --header 'Package: YOUR_API_KEY'

Сокращённый пример ответа Live

Ниже показан фрагмент реального ответа. Для компактности оставлены один матч, одна группа ставок, три исхода и одна строка статистики.

{
  "status": 1,
  "page": "/v1/events",
  "body": [
    {
      "tournament_id": 2916716,
      "tournament_name": "Чемпионат России. Молодежное первенство. Дивизион А",
      "events_list": [
        {
          "sgame_id": "6a5a35d05e99bd05c64f543a",
          "stat_id": "69a27d775e99bd05c6eec890",
          "game_id": 746049368,
          "game_start": 1787313600,
          "country_id": 1,
          "country_name": "Россия",
          "tournament_id": 2916716,
          "tournament_name": "Чемпионат России. Молодежное первенство. Дивизион А",
          "opp_1_name": "Акрон-Академия Коноплева (мол)",
          "opp_2_name": "Зенит (мол)",
          "game_oc_counter": 425,
          "game_oc_list": [
            {
              "group_id": 1,
              "group_name": "1X2",
              "columns": 3,
              "oc_list": [
                {
                  "oc_group_name": "1X2",
                  "oc_name": "П2",
                  "oc_rate": 2.505,
                  "oc_size": 0,
                  "oc_pointer": "746049368|1|3|0",
                  "oc_block": false,
                  "op_id": null
                },
                {
                  "oc_group_name": "1X2",
                  "oc_name": "П1",
                  "oc_rate": 2.605,
                  "oc_size": 0,
                  "oc_pointer": "746049368|1|1|0",
                  "oc_block": false,
                  "op_id": null
                },
                {
                  "oc_group_name": "1X2",
                  "oc_name": "Ничья",
                  "oc_rate": 3.49,
                  "oc_size": 0,
                  "oc_pointer": "746049368|1|2|0",
                  "oc_block": false,
                  "op_id": null
                }
              ]
            }
          ],
          "sport_id": 1,
          "sport_name": "Футбол",
          "timer": 2192,
          "score_full": "1:0",
          "score_period": "1:0",
          "stat_list": [
            {
              "id": 45,
              "name": "Атаки",
              "opp1": "29",
              "opp2": "30"
            }
          ],
          "period_name": "1-й тайм",
          "vi": "20064614",
          "zp": null
        }
      ]
    }
  ]
}

Это сокращённый фрагмент, а не полный объект матча. Полные ответы доступны в конце документа.

Структура ответа

Верхний уровень

Объект турнира

Основные поля матча

game_id Prematch-матча не сохраняется при переходе в Live. Для Live формируется новый game_id, поэтому нельзя связывать Prematch- и Live-матчи по этому полю.

Не используйте поля sgame_id, stat_id, game_num, stat_list_extra и game_plan как обязательную часть интеграции. Они являются старыми, тестовыми или зарезервированными. game_num планируется удалить из API.

Команды или участники

Массивы opp_1_ids и opp_2_ids нужны, когда одна сторона матча состоит из нескольких участников. Например, это могут быть теннисные пары или групповой матч, в котором на каждой стороне участвует несколько игроков или команд.

Готовые иконки команд и участников

Для команд и участников можно использовать стандартные иконки SportAPI:

https://cdn.sportapi.net/opp/v1/color/{iconName}.webp

Значение iconName берётся из opp_1_icon или opp_2_icon. В реальных ответах имя может приходить с расширением .png. Перед созданием CDN-ссылки исходное расширение нужно убрать, после чего добавить .webp через шаблон URL.

Например:

opp_1_icon: 8bd073a686a067e6732d8d1688a517c0.png
iconName:    8bd073a686a067e6732d8d1688a517c0

Готовая ссылка:

https://cdn.sportapi.net/opp/v1/color/8bd073a686a067e6732d8d1688a517c0.webp

Для opp_2_icon используется то же правило.

Счёт, период и Live-данные

В Prematch многие Live-поля возвращаются со стандартными значениями: 0, пустой строкой, пустым массивом или null. Клиент должен корректно обрабатывать все эти варианты.

Объект в stat_list

Объект в sub_games

sub_games предназначен для ссылок на отдельные типы субматча: угловые, карточки, фолы, только первый тайм, статистику игроков и другие доступные варианты.

В списке матчей events поле возвращается как пустой массив:

"sub_games": []

Метод events не использует sub_games: здесь поле возвращается только как []. Список субматчей доступен при запросе конкретного матча через event. Каждый элемент содержит ID субматча, но не его коэффициенты. Для коэффициентов нужно выполнить отдельный запрос event по game_id выбранного субматча.

Метод events не использует event_plan: в списке матчей поле возвращается как []. Заполненный состав доступен только при запросе конкретного матча через event.

Ставки и коэффициенты

Значение game_oc_counter может быть значительно больше количества элементов, фактически находящихся в game_oc_list. Для полного набора ставок выбранного матча используйте метод event.

Краткий список зависит от вида спорта

Нельзя рассчитывать, что game_oc_list у всех видов спорта содержит одинаковые группы, названия и количество исходов.

Например:

• в футболе краткий список может содержать группу 1X2 с победой первой команды, ничьёй и победой второй команды;
• в баскетболе вместо 1X2 часто возвращаются исходы победы первой и победы второй команды;
• в теннисе нет исхода на ничью.

При интеграции необходимо обрабатывать массив динамически:

1. Не привязывать интерфейс только к группе 1X2.
2. Не ожидать обязательного наличия ничьей.
3. Читать фактические group_name, columns и oc_list из ответа.
4. Не полагаться на одинаковый порядок групп и исходов у разных видов спорта.
5. Для открытия всех доступных исходов выполнять запрос event по game_id выбранного матча.

Группа ставок в game_oc_list

Исход в oc_list

Коэффициенты и состояние oc_block могут измениться при каждом обновлении ответа.

Видео и Live 3D Tracker

Если zp равно null, Live 3D Tracker для этого матча недоступен. Сам трекер работает только для Live-матчей и поддерживаемых видов спорта.

Подробнее:

• Live 3D Tracker в Sport Line API;
• видеотрансляции в Sport Line API;
• полная инструкция по подключению Live 3D Tracker.

Отличия Live и Prematch

Структура объекта матча одинаковая, но заполнение полей отличается:

• в Live обновляются таймер, счёт, период и статистика;
• в Prematch эти поля обычно содержат начальные или пустые значения;
• vi и zp относятся к дополнительным возможностям Live и могут быть null;
• коэффициенты и блокировка исходов обновляются независимо для Live и Prematch;
• при переходе матча из Prematch в Live создаётся новый game_id.

Live и Prematch необходимо запрашивать и хранить отдельно.

Снимок сохранённых ответов

Для Live и Prematch использованы футбол (sportId=1) и tournamentId=0, поэтому каждый файл содержит все матчи всех доступных футбольных турниров. Формат — sub, техническое значение count — 50.

Это статистика конкретных ответов от 21 августа 2026 года, а не постоянный состав API.

Полные ответы без сокращений:

• Live, русский язык
• Prematch, русский язык
• Live, английский язык
• Prematch, английский язык

Файлы содержат только тело ответа API. API-ключ в них не сохраняется.

Частота обновления

Рекомендуется запрашивать events:

• Live — не чаще одного раза в 7 секунд;
• Prematch (line) — не чаще одного раза в 30 секунд.

Подробнее: «Рекомендации по обновлению данных».

Ошибки ключа, тарифа и параметров описаны в документе «Обработка ошибок».