Автоматический расчёт ставок: как он работает и где взять API, который считает все рынки за 1–2 минуты
Что должен уметь сервис автоматического расчёта ставок, какие рынки сложнее всего рассчитать и как SportAPI считает все исходы — от таймов и угловых до статистики игроков — за 1–2 минуты, а в live сразу.

Автоматический расчёт ставок (automated bet settlement) — это когда итог каждой ставки определяет сервис, а не человек. Bet Settlement API решает, выиграла ставка, проиграла, вернулась или сыграла наполовину, и сообщает итог вашему серверу. Без такого сервиса букмекерскому проекту приходится держать собственную команду расчётчиков или писать движок расчёта, который разбирается в сотнях рынков, правилах отмен и азиатских форах.
В SportAPI эту работу делает Coupon API — сервис приёма и расчёта ставок. Он рассчитывает автоматически все исходы: основные рынки, таймы и периоды, угловые, карточки, статистику игроков, азиатские тоталы и форы. Prematch-ставка получает итог через 1–2 минуты после окончания события, а live-рынок рассчитывается сразу, как только событие свершилось. Результат приходит на ваш сервер обратным вызовом, а запросить его через API можно в любой момент. Стоимость — от $300 в месяц.
Почему расчёт ставки сложнее, чем сравнить счёт
Если бы все ставки были на победителя матча, расчёт уместился бы в одну строку кода. На практике итог ставки зависит от рынка, правил и того, что случилось с матчем:
- Тотал 2,25 при счёте 1:1 — это не проигрыш и не выигрыш, а половина проигрыша: половина ставки возвращается.
- Угловые в первом тайме рассчитываются по статистике тайма, а не по итоговому счёту.
- Ставки на игроков — голы, удары, передачи — требуют статистики конкретного игрока.
- Отменённый или перенесённый матч даёт возврат, а не проигрыш, и игрок должен понимать причину.
- Исправленный результат — например, после пересмотра — требует пересчитать уже рассчитанный купон.
- Экспресс проигрывает, как только проиграло одно событие, даже если остальные матчи ещё идут.
Каждый такой случай — отдельное правило, которое нужно реализовать, проверить и поддерживать. Готовый Bet Settlement API забирает все эти правила на себя.
Какие ставки рассчитываются автоматически
| Тип рынка | Пример | Что нужно для расчёта | В SportAPI |
|---|---|---|---|
| Исход матча | П1, Х, П2, двойной шанс | Итоговый счёт | Автоматически |
| Тоталы и форы | Тотал больше 2,5, фора −1,5 | Счёт и правила рынка | Автоматически |
| Азиатские рынки | Тотал 2,25, фора −0,75 | Деление ставки на две части | Автоматически, с половиной выигрыша и проигрыша |
| Таймы, периоды, сеты | Победа в первом тайме, тотал третьего периода | Счёт по периодам | Автоматически |
| Статистика матча | Угловые, карточки, фолы | Статистика по матчу и таймам | Автоматически |
| Ставки на игроков | Гол игрока, раны игрока, эйсы | Статистика игрока | Автоматически |
| Live-рынки | Следующий гол | Момент события | Сразу, как только событие свершилось |
| Экспрессы | До 15 событий в купоне | Итог каждого события | Автоматически, ранний проигрыш — сразу |
Ставки принимаются и рассчитываются по линии SportAPI — это 322 вида спорта, prematch и live. Поэтому для расчёта не нужно сопоставлять названия команд и рынков между разными системами: исход однозначно определяется указателем из линии, а коэффициент проверяется ещё при приёме ставки.
Как быстро приходит итог ставки
- Prematch-ставки и итог матча — через 1–2 минуты после окончания события.
- Live-рынки — сразу, как только событие свершилось: забит гол, подан угловой, закончился тайм.
- Подсобытия — тайм, период, сет, угловые — рассчитываются по мере завершения, не дожидаясь конца всего матча.
- Экспресс — как только одно событие проиграло, купон получает статус проигрыша. Это видно сразу, хотя остальные матчи ещё идут.
Для игрока скорость расчёта — это скорость, с которой выигрыш появляется на балансе. Чем быстрее, тем раньше деньги снова в игре и тем меньше обращений в поддержку «где мой выигрыш».
Статусы и выплаты
У каждой ставки внутри купона свой статус и свой множитель расчёта:
| Статус ставки | Что значит | Множитель |
|---|---|---|
1 WIN | Выигрыш | Коэффициент ставки |
2 LOSE | Проигрыш | 0 |
3 RETURN | Возврат | 1 |
21 HALF_WIN | Половина выигрыша | (коэффициент + 1) / 2 |
22 HALF_LOSE | Половина проигрыша | 0,5 |
23 PUSH | Возврат при равном результате | 1 |
Итоговый множитель купона — произведение множителей его ставок, а сумму выплаты API отдаёт готовой в поле real_win. Пример: ставка 10 на тотал больше 2,25 по коэффициенту 1,90, матч закончился 1:1. Половина ставки сыграла на «больше 2» и вернулась, половина — на «больше 2,5» и проиграла. Статус — HALF_LOSE, выплата — 5.
У купона статусы свои: 0 — активен, 2 — выиграл, 4 — проиграл, 8 — полный возврат, 15 — возвращён на пересчёт. Как считается выигрыш в ординаре и экспрессе, мы подробно разбирали в статье про ординары и экспрессы, а весь путь купона описан в документации по расчёту.
Причины возврата и пересчёт
Каждая рассчитанная ставка получает код причины — settlement_reason_code — и текст объяснения. Например: матч отменён (MATCH_CANCELLED), перенесён (MATCH_POSTPONED), рынок рассчитан как возврат при равном результате (MARKET_PUSH). По коду вы показываете игроку понятное сообщение на его языке вместо безликого «возврат».
Если результат матча исправили после расчёта, купон получает статус 15 и затем новый итог. Ваш сервер получает обе версии и корректирует выплату. Без такой схемы исправленный результат приходится разбирать вручную.
Игроки часто хотят сами проверить, почему ставка сыграла именно так: сколько было угловых в первом тайме, кто получил карточку. Дайте им ссылку на SportAPI.net Stats — там live-счёт, результаты, составы, личные встречи и статистика матчей по 20 видам спорта. Меньше вопросов в поддержку — меньше спорных расчётов.
Как результат попадает на ваш сервер
Есть два способа, и их можно использовать вместе.
Обратный вызов (callback). Как только купон рассчитан, система отправляет на ваш адрес POST-запрос с результатом. В одном запросе — до 100 купонов. Каждый запрос подписан HMAC-SHA256, поэтому подделать результат нельзя. Для экспресса приходят промежуточные состояния: какие события уже рассчитаны, какие ещё нет.
Запрос через API — когда захотите. Состояние любого купона можно получить в любой момент: один купон по коду, список до 100 купонов, все активные купоны или все, рассчитанные за последние N минут. Это удобно для поддержки, сверки и восстановления после сбоя.
Обработчик обратного вызова на Node.js:
import crypto from 'node:crypto';
import express from 'express';
const app = express();
app.post('/coupon-result', express.raw({ type: 'application/json' }), async (req, res) => {
const signature = Buffer.from(req.get('X-Coupon-Signature') || '');
const expected = Buffer.from(
'sha256=' + crypto.createHmac('sha256', process.env.CALLBACK_SECRET).update(req.body).digest('hex'),
);
if (signature.length !== expected.length || !crypto.timingSafeEqual(signature, expected)) {
return res.sendStatus(401); // подпись не совпала — не трогаем балансы
}
const batch = JSON.parse(req.body.toString('utf8'));
await db.transaction(async (tx) => {
if (!(await tx.saveBatchOnce(batch.batchId))) return; // этот пакет уже обработан
for (const coupon of batch.coupons) {
await tx.upsertCoupon(coupon); // ищем купон по coupon_code
if ([2, 4, 8].includes(coupon.status)) {
await tx.payOnce(coupon.coupon_code, coupon.realWin); // выплата строго один раз
}
}
});
res.sendStatus(200);
});
Три правила, без которых интеграция расчёта ломается: проверять подпись по исходным байтам тела запроса, не парсить JSON до проверки; отличать повторную доставку того же пакета (одинаковый batchId) от нового состояния купона (новый batchId); начислять выплату один раз, даже если итог купона пришёл несколько раз.
Как выбрать Bet Settlement API: вопросы поставщику
| Вопрос | Почему важен | Ответ SportAPI |
|---|---|---|
| Какие рынки рассчитываются автоматически? | Каждый рынок вручную — это расходы и ошибки | Все исходы линии, включая таймы, угловые, игроков |
| Как быстро приходит итог? | От этого зависит, когда игрок получит выигрыш | 1–2 минуты, live — сразу |
| Есть ли азиатские рынки с половиной выигрыша? | Иначе тоталы 2,25 и форы 0,75 считаются неверно | Да, статусы HALF_WIN и HALF_LOSE |
| Указывается ли причина возврата? | Игрок должен понимать, почему ставка вернулась | Да, код и текст причины |
| Что будет при исправлении результата? | Без пересчёта ошибка остаётся навсегда | Статус пересчёта и новый итог |
| Как защищены уведомления о результате? | Поддельный callback — это поддельная выплата | Подпись HMAC-SHA256 |
| Можно ли запросить результат самому? | Callback может не дойти | Да, в любой момент через API |
| Где хранится баланс игроков? | Деньги должны оставаться у оператора | В вашей системе |
Ошибки при подключении расчёта ставок
- Начисление выигрыша по
potential_win. Это возможный выигрыш до расчёта. Начисляйтеreal_winпосле итогового статуса. - Проигрыш, принятый по промежуточному состоянию. В промежуточном callback экспресса выплата равна 0, но купон ещё активен. Смотрите статус купона.
- Защита от повторов по
coupon_code. Один купон может прийти несколько раз с разными состояниями. Повторы отсекайте поbatchId. - Нет запасного опроса. Если ваш сервер был недоступен, часть callback-ов может задержаться. Раз в несколько минут запрашивайте купоны, рассчитанные за последние 10 минут.
- Секрет подписи в коде приложения. Он должен быть только на сервере.
Чем это отличается от сервиса «пришлите ставку — получите итог»
Некоторые сервисы рассчитывают ставки, принятые где угодно: вы присылаете матч, рынок и линию, а сервис ищет результат. Такой подход удобен, если ставки уже приняты в чужой системе, но в нём легко ошибиться на сопоставлении: название команды, турнира или рынка не совпало — и ставка зависла.
В SportAPI ставка принимается и рассчитывается в одной системе вместе с линией. Исход определяется точным указателем из линии, коэффициент проверяется в момент приёма, а при расчёте не бывает ситуации «такой рынок не найден». Если вы только запускаете приём ставок или переходите на новую линию, это надёжнее.
Если же вам нужны не итоги ставок, а итоги матчей — для сайта, статистики или проверки прогнозов, — смотрите статью про результаты матчей в JSON.
Сколько стоит
| Что нужно | Стоимость |
|---|---|
| Приём и автоматический расчёт ставок (Coupon API) | от $300 в месяц, оплата по рассчитанным исходам |
| Линия и коэффициенты одного вида спорта | от $30 в месяц |
| Баланс игроков, платежи | в вашей системе |
Частые вопросы
Что такое Bet Settlement API?
Это сервис, который автоматически определяет итог каждой ставки — выигрыш, проигрыш, возврат или половину выигрыша — и передаёт его в вашу систему. Ваш сервер по этому итогу начисляет выплату игроку.
Как быстро рассчитываются ставки?
Prematch-ставки — через 1–2 минуты после окончания события. Live-рынки рассчитываются сразу, как только событие свершилось. Экспресс получает статус проигрыша, как только проиграло одно из событий.
Рассчитываются ли угловые, карточки и ставки на игроков?
Да. Автоматически рассчитываются все исходы линии: таймы и периоды, угловые, карточки, фолы, статистика игроков, азиатские тоталы и форы.
Как получить результат: callback или запрос?
Как удобно. Callback приходит сам, как только купон рассчитан. Через API результат можно запросить в любой момент — по коду купона, списком или за последние минуты. Надёжнее всего использовать оба способа.
Можно ли рассчитывать ставки, принятые в другой системе?
Coupon API рассчитывает ставки, принятые по линии SportAPI: исход и коэффициент проверяются при приёме. Если вы переходите с другой системы, новые ставки принимайте через Coupon API — тогда расчёт будет полностью автоматическим.
Где хранится баланс игроков?
В вашей системе. SportAPI принимает и рассчитывает ставки, а пополнения, выводы и начисление выигрышей ведёт ваш сервер по итогу из API.
Что сделать дальше
- Проверьте, какие рынки и виды спорта нужны вашему проекту.
- Получите тестовый доступ и примите несколько ставок на live-матчи — посмотрите, как быстро приходит итог.
- Подключите обработчик callback с проверкой подписи и запасной опрос.
Напишите менеджеру SportAPI в Telegram, что вам нужен автоматический расчёт ставок, — вы получите доступ к Coupon API и проверите расчёт на реальных матчах.