SportAPI
Букмекерские платформы

Автоматический расчёт ставок: как он работает и где взять 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.

Что сделать дальше

  1. Проверьте, какие рынки и виды спорта нужны вашему проекту.
  2. Получите тестовый доступ и примите несколько ставок на live-матчи — посмотрите, как быстро приходит итог.
  3. Подключите обработчик callback с проверкой подписи и запасной опрос.

Напишите менеджеру SportAPI в Telegram, что вам нужен автоматический расчёт ставок, — вы получите доступ к Coupon API и проверите расчёт на реальных матчах.

← Все статьи