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

Коэффициенты в 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 |
| Изменений основного рынка 1X2 | 3 |
| Исходов появилось / исчезло | 15 / 24 |
| Заблокированных исходов | 0 (голов и опасных моментов не было) |
Из этого следуют две вещи. Цены приходят пачками: когда линия обновляет матч, она переоценивает сразу много связанных рынков, потому что одно изменение ожидаемого счёта двигает все тоталы и форы. И большинство опросов не приносит ничего нового: 45 ответов из 59 содержали ровно те же коэффициенты, что и предыдущий.
Оговорка к цифрам. Тестовый ключ — не инструмент для оценки свежести рабочих данных: на странице продукта сказано, что тестовый доступ может содержать искусственную задержку. Замер показывает форму изменений и время ответа, а не свежесть рабочей линии. Как измерить её, сказано в конце статьи.
Четыре вида изменений в ответе live odds API
Каждый опрос возвращает полное текущее состояние матча. Сравнивая его с предыдущим, вы увидите четыре разных события:
- Цена изменилась. У исхода, который уже был, сменился
oc_rate. Это самый частый случай, и приходит он пачками. - Исход заблокирован или открыт снова.
oc_blockстановитсяtrueвокруг голов, пенальти и других моментов, когда цена вот-вот изменится, а позже сноваfalse, обычно уже с новой ценой. Заблокированный исход остаётся в ответе, чтобы страница не прыгала, но кнопки у него быть не должно. - Исход появился или исчез. После гола основной тотал сдвигается, например с 2,5 на 3,5, рынки с привязкой ко времени закрываются, открываются новые. За пять спокойных минут у нас появилось 15 исходов и ушло 24.
- Сдвинулся параметр рынка.
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 вернули цены, идентичные предыдущему ответу. Спрашивай мы вдвое чаще — получили бы вдвое больше одинаковых ответов. Минимальные интервалы в правилах обновления данных подобраны под то, как движутся данные:
| Метод | Live | Prematch |
|---|---|---|
events (список матчей) | 7 с | 30 с |
event (один матч) | 5 с | 30 с |
menu | 20 с | 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-коэффициенты выглядят сломанными
- Хранить исходы, которые ушли из ответа. Собирайте рынок заново из каждого снимка. Старая линия тотала с кнопкой — гарантированный
502. - Игнорировать
oc_block. Цена остаётся в ответе, пока исход приостановлен. Показывайте замок. - Опрашивать каждый матч из списка. Упрётесь в лимит и ничего не выиграете: основные коэффициенты есть в списке.
- Цикл опроса на каждую вкладку браузера. Линия у всех одна. Опрашивайте на сервере.
- Мерить скорость на тестовом ключе. На нём может быть искусственная задержка. Частоту изменений меряйте на тестовом, свежесть — на рабочем.
- Считать цену на экране ценой ставки. Цена ставки определяется при приёме. Проектируйте купон под
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.