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

Live odds API: как обновляются коэффициенты в live и с какой задержкой их получает ваш сайт

Что на самом деле меняется в live odds API между двумя опросами, замер на реальном матче, из чего складывается задержка от поля до экрана и почему устаревшая цена не становится неверной ставкой.

Лента коэффициентов проходит через облако API на экран сайта с live-матчем: изменения цен и индикатор задержки на фоне стадиона

Коэффициенты в live не тикают как часы. Несколько секунд они стоят на месте, а потом треть или половина всех исходов переоценивается разом; после гола рынки блокируются и возвращаются с новыми ценами. Live odds API отдаёт снимок этого состояния на каждый запрос, а ваш сайт показывает его с задержкой из четырёх частей: от источника до API, от API до вашего сервера, от сервера до браузера и отрисовка.

При обычных настройках эта задержка составляет в среднем около шести секунд для открытого матча и около десяти в худшем случае. К неверным ставкам она не приводит, потому что цена проверяется ещё раз в момент приёма ставки. Ниже — что мы намерили на реальном матче, четыре вида изменений, которые нужно обрабатывать, бюджет задержки в цифрах и правила показа движущихся коэффициентов игроку. Примеры — на Sport Line API, линии SportAPI.

Что мы измерили

9 ноября 2026 мы опрашивали один live-матч по футболу методом event каждые 5 секунд в течение 5 минут на тестовом ключе. Это была игра резервной лиги при счёте 0:0, между 15-й и 20-й минутой, без голов за время замера — спокойное состояние, в котором матч находится бо́льшую часть времени.

ПоказательРезультат
Опросов60, раз в 5 секунд
Размер ответа52 рынка, около 390 исходов
Время ответамедиана 163 мс, 95-й перцентиль 204 мс, самый медленный 275 мс
Опросов, принёсших хотя бы одну новую цену14 из 59
Исходов переоценено за одно обновлениедо 216 из примерно 390
Изменений основного рынка 1X23
Исходов появилось / исчезло15 / 24
Заблокированных исходов0 (голов и опасных моментов не было)

Из этого следуют две вещи. Цены приходят пачками: когда линия обновляет матч, она переоценивает сразу много связанных рынков, потому что одно изменение ожидаемого счёта двигает все тоталы и форы. И большинство опросов не приносит ничего нового: 45 ответов из 59 содержали ровно те же коэффициенты, что и предыдущий.

Оговорка к цифрам. Тестовый ключ — не инструмент для оценки свежести рабочих данных: на странице продукта сказано, что тестовый доступ может содержать искусственную задержку. Замер показывает форму изменений и время ответа, а не свежесть рабочей линии. Как измерить её, сказано в конце статьи.

Четыре вида изменений в ответе live odds API

Каждый опрос возвращает полное текущее состояние матча. Сравнивая его с предыдущим, вы увидите четыре разных события:

  1. Цена изменилась. У исхода, который уже был, сменился oc_rate. Это самый частый случай, и приходит он пачками.
  2. Исход заблокирован или открыт снова. oc_block становится true вокруг голов, пенальти и других моментов, когда цена вот-вот изменится, а позже снова false, обычно уже с новой ценой. Заблокированный исход остаётся в ответе, чтобы страница не прыгала, но кнопки у него быть не должно.
  3. Исход появился или исчез. После гола основной тотал сдвигается, например с 2,5 на 3,5, рынки с привязкой ко времени закрываются, открываются новые. За пять спокойных минут у нас появилось 15 исходов и ушло 24.
  4. Сдвинулся параметр рынка. oc_size — значение тотала или форы — часть идентичности исхода. «Больше 2,5» и «больше 3,5» — разные исходы с разными указателями, а не один исход, у которого поменялась подпись.

Все четыре видны в одном сравнении по oc_pointer — устойчивому идентификатору исхода:

// превращаем ответ event/group в соответствие pointer -> { rate, blocked }
function snapshot(game) {
  const map = new Map();
  for (const market of game.game_oc_list)
    for (const column of market.oc_list)
      for (const oc of column)
        map.set(oc.oc_pointer, { rate: oc.oc_rate, blocked: oc.oc_block });
  return map;
}

function diff(prev, next) {
  const changes = [];
  for (const [pointer, now] of next) {
    const was = prev.get(pointer);
    if (!was) changes.push({ pointer, type: 'added', ...now });
    else if (was.blocked !== now.blocked)
      changes.push({ pointer, type: now.blocked ? 'blocked' : 'reopened', ...now });
    else if (was.rate !== now.rate)
      changes.push({ pointer, type: now.rate > was.rate ? 'up' : 'down', ...now });
  }
  for (const pointer of prev.keys())
    if (!next.has(pointer)) changes.push({ pointer, type: 'removed' });
  return changes; // в браузеры отправляем только это
}

Отправлять в браузеры разницу, а не весь ответ, важно под нагрузкой: полный объект матча — это сотни исходов, а типичная разница пуста или занимает несколько строк.

Бюджет задержки: от поля до экрана

Задержка, которую видит игрок, — это сумма, и больше половины в ней контролируете вы:

ЭтапСколькоКто управляет
Событие у источника → доступно в APIПримерно 2–3 секунды на рабочем ключеПоставщик
API → ваш серверОт 0 до 5 секунд для открытого матча, от 0 до 7 для списка; в среднем половинаВаш интервал опроса, вплоть до документированного минимума
Сам HTTP-запрос0,16 секунды по медиане в нашем замереСеть
Ваш сервер → браузерОт 0 до вашего интервала рассылки или обновленияВы
ОтрисовкаДесятки миллисекундВы

Для открытого матча с опросом раз в 5 секунд и обновлением браузеров раз в 2 секунды выходит примерно 2,5 + 2,5 + 0,2 + 1 ≈ 6 секунд в среднем и 3 + 5 + 0,3 + 2 ≈ 10 секунд в худшем случае. Список матчей немного медленнее: его минимальный интервал — 7 секунд.

Два последних этапа можно сжать почти до нуля: отправлять разницу в браузеры по WebSocket или server-sent events в тот момент, когда её увидел опросчик, и перерисовывать только изменившиеся ячейки. Опускаться ниже документированного минимума опроса нельзя, да и не помогло бы — это показывает следующий раздел.

Почему частый опрос не делает коэффициенты свежее

В замере 45 опросов из 59 вернули цены, идентичные предыдущему ответу. Спрашивай мы вдвое чаще — получили бы вдвое больше одинаковых ответов. Минимальные интервалы в правилах обновления данных подобраны под то, как движутся данные:

МетодLivePrematch
events (список матчей)7 с30 с
event (один матч)5 с30 с
menu20 с60 с

Три привычки делают live-интеграцию и свежей, и дешёвой:

  • Один опросчик на набор данных, а не на игрока. Тысяча игроков, которые смотрят один матч, обслуживается из одного закешированного ответа.
  • Детали только по открытым матчам. В списке уже есть основные коэффициенты каждого матча; event запрашивайте, когда матч кто-то открыл.
  • Запросы не накладываются. Если ответ идёт медленно, дождитесь его, прежде чем отправлять следующий запрос за теми же данными.

Архитектура вокруг этих правил, от кешей до доставки, описана в статье «Как Live-данные проходят путь от спортивного API до сайта».

Почему устаревшая цена не становится неверной ставкой

Несколько секунд задержки были бы проблемой, если бы ставка принималась по тому, что показывает экран. Это не так. Когда игрок подтверждает купон, ваш сервер отправляет в Coupon API указатель, в который входит коэффициент, увиденный игроком, и сервис приёма ставок сравнивает его с текущим:

Что произошло с момента, когда игрок видел ценуПри mode: rejectПри mode: accept
НичегоПринятаПринята
Коэффициент изменилсяОтказ с кодом 501, новые коэффициенты возвращаются в body.changes[]Принята по новому коэффициенту, если направление разрешено в mode_type
Исход заблокированОтказ с 503Отказ с 503
Исхода больше нетОтказ с 502Отказ с 502

mode_type равен 1, чтобы принимать только рост, 2 — только снижение, 3 — любое изменение. Обычная настройка — reject по умолчанию и переключатель «принимать изменения коэффициентов» у игрока. В любом случае задержка на экране стоит игроку максимум повторного подтверждения, но не ставки по цене, которой уже нет.

Что показывать игроку

  • Отмечайте направление. Подсвечивайте переоценённый исход на две-три секунды: зелёным рост, красным снижение — по типам up и down из сравнения.
  • Блокируйте, а не прячьте. Заблокированный исход остаётся на месте с замком и без обработчика клика. Если его скрыть, страница прыгнет в худший момент — сразу после гола.
  • Сохраняйте порядок. Рынки, колонки и исходы остаются в том порядке, в каком их отдаёт API. Не пересортировывайте при каждом обновлении.
  • Чистите купон. Если исход из купона исчез из ответа или заблокирован, сообщите об этом в купоне до того, как игрок нажмёт кнопку.
  • Ведите часы локально. Таймер матча приходит в секундах; отсчитывайте его на клиенте и синхронизируйте при каждом ответе. Не опрашивайте API ради часов.

Как измерить самому

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

import os, time, requests

BASE, KEY = os.environ["SPORTAPI_BASE_URL"], os.environ["SPORTAPI_KEY"]  # оба значения выдаёт менеджер
GAME_ID = 123456789  # game_id любого live-матча из списка событий

def rates(game_id: int) -> dict[str, float]:
    r = requests.get(f"{BASE}/v1/event/{game_id}/group/live/ru",
                     headers={"Package": KEY}, timeout=15)
    body = r.json()["body"]  # {"message": "Game id finished"}, когда матч ушёл из линии
    return {oc["oc_pointer"]: oc["oc_rate"]
            for market in body["game_oc_list"]
            for column in market["oc_list"] for oc in column}

prev, changed_polls = rates(GAME_ID), 0
for _ in range(59):
    time.sleep(5)  # минимальный интервал для live-матча
    now = rates(GAME_ID)
    moved = sum(1 for p in now if p in prev and now[p] != prev[p])
    changed_polls += moved > 0
    prev = now
print(f"{changed_polls} из 59 опросов принесли новую цену")

Со свежестью сложнее, и измерять её нужно на рабочем ключе. Записывайте момент, когда в вашем опросчике меняется score_full, и сравнивайте с источником, которому доверяете, по тем же голам. Берите десять голов, а не один, и помните, что телевизионная или потоковая картинка сама отстаёт от стадиона на секунды и десятки секунд, поэтому сравнивайте разброс, а не единичное значение.

Ошибки, из-за которых live-коэффициенты выглядят сломанными

  1. Хранить исходы, которые ушли из ответа. Собирайте рынок заново из каждого снимка. Старая линия тотала с кнопкой — гарантированный 502.
  2. Игнорировать oc_block. Цена остаётся в ответе, пока исход приостановлен. Показывайте замок.
  3. Опрашивать каждый матч из списка. Упрётесь в лимит и ничего не выиграете: основные коэффициенты есть в списке.
  4. Цикл опроса на каждую вкладку браузера. Линия у всех одна. Опрашивайте на сервере.
  5. Мерить скорость на тестовом ключе. На нём может быть искусственная задержка. Частоту изменений меряйте на тестовом, свежесть — на рабочем.
  6. Считать цену на экране ценой ставки. Цена ставки определяется при приёме. Проектируйте купон под 501.

Как это работает в SportAPI

Live входит в тот же тариф, что и prematch: от $30 в месяц за один вид спорта, с live-статистикой в том же ответе. Обновления забираются по REST с документированными интервалами; WebSocket в разработке, поэтому рабочие интеграции опрашивают API. На рабочем ключе live-данные обычно становятся доступны примерно через 2–3 секунды после изменения у источника. У каждого ключа лимит — 50 запросов в секунду в среднем, и закешированная интеграция к нему не приближается.

Тестовый ключ на два дня открывает все виды спорта с prematch и live — это правильный инструмент, чтобы собрать цикл опроса, сравнение снимков и логику купона. Для проверки скорости спросите у менеджера рабочий ключ на тот вид спорта, с которого запускаетесь.

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

Как часто обновляются live-коэффициенты?

Неравномерно. В спокойном отрезке игры цены стоят несколько секунд, а потом много исходов двигается разом; после гола всё блокируется и открывается заново. Опрос матча раз в 5 секунд ловит все состояния, которые имеют значение.

Нужен ли WebSocket для live-коэффициентов?

Между вашим сервером и API — нет: опрос по REST с документированными интервалами — так сегодня работают рабочие интеграции. Между сервером и браузером WebSocket или server-sent events стоит иметь: они убирают вашу часть задержки.

Почему коэффициенты блокируются сразу после гола?

Потому что старые цены неверны в ту секунду, когда изменился счёт. Исходы остаются в ответе с oc_block: true, пока не готовы новые цены. Показывайте их с замком.

Может ли список матчей заменить подробный запрос?

Для основных рынков — да: events раз в 7 секунд отдаёт короткий список основных коэффициентов по каждому live-матчу. Полный набор рынков матча приходит только из event.

Какая задержка допустима для ставок в live?

Та, которую покрывает проверка при приёме ставки. С повторной проверкой шесть–десять секунд на экране означают редкое сообщение «коэффициент изменился». Без проверки безопасной задержки не существует.

API отдаёт коэффициенты в американском или дробном формате?

Он возвращает десятичные коэффициенты в oc_rate. Если аудитории привычнее другой формат, пересчитывайте на своей стороне.

Что проверить на своём матче

Выберите сегодня вечером live-матч, запустите скрипт на пять минут и посмотрите на три числа: сколько опросов принесли изменение, сколько исходов сдвинулось за раз и сколько занял запрос. Затем сделайте тестовую ставку, пока коэффициенты движутся, и посмотрите на ветку 501. Эти две проверки говорят о live odds API больше, чем любая цифра задержки на лендинге. Тестовый ключ для них можно попросить у менеджера SportAPI в Telegram.

← Все статьи