Где брать результаты матчей в JSON для расчёта ставок

Итоговые результаты матчей в JSON берут из API результатов — но для расчёта ставок одного счёта мало. Поэтому самый надёжный вариант — вообще не рассчитывать ставки по результатам самостоятельно, а передавать купоны в систему расчёта. SportAPI Coupon API принимает ставку по исходу из спортивной линии, сам отслеживает результат матча и присылает готовый итог в JSON: статус ставки, счёт, по которому она рассчитана, коэффициент и выплату.

Если вам нужны только итоги матчей — для сайта, ленты результатов или проверки прогнозов, — подойдёт API результатов SportAPI: от $25 в месяц за вид спорта, +$10 за каждый дополнительный язык. Результат появляется в течение 1–20 минут после окончания матча, топ-матчи — сразу.

Ниже разберём, почему счёт не равен расчёту, чем опасны ИИ-агенты и парсинг, как выглядит результат расчёта в JSON и как получать его автоматически.

Почему итогового счёта недостаточно для расчёта ставки

Финальный счёт отвечает на вопрос «кто выиграл». Ставка задаёт другие вопросы: сыграл ли тотал, как считать фору, что делать с отменённым матчем. Вот что нужно знать кроме счёта:

Тип ставки	Что нужно кроме итогового счёта	Возможный итог
Победа, ничья, двойной шанс	Только основное время или с овертаймом	Выигрыш или проигрыш
Тотал больше или меньше 2	Точная граница: при ровно 2 голах	Возврат ставки
Азиатская фора −0,25	Ставка делится на две половины	Половинный выигрыш или проигрыш
Ставки на тайм или сет	Счёт отдельного периода	Выигрыш или проигрыш
Угловые, карточки	Статистика матча, а не голы	Выигрыш или проигрыш
Матч отменён или перенесён	Правила возврата	Возврат
Результат исправлен после матча	Повторный расчёт	Перерасчёт и новый итог

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

Если рассчитывать всё это самостоятельно, вам нужны не только результаты, но и правила расчёта каждого рынка — и их поддержка при каждом новом типе ставки.

Откуда обычно берут результаты и почему это рискованно

ИИ-агент с поиском

Всё чаще результаты матчей пытаются получать через ИИ-агентов: «найди итоговый счёт этого матча и верни только валидный JSON». Мы видим такие запросы в собственной статистике поиска — почти тысячу за год.

Проблема в том, что языковая модель не является источником данных. Она может:

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

Для расчёта денежных ставок даже редкая ошибка обходится дорого: неверная выплата, спор с игроком, ручной перерасчёт.

Парсинг сайтов с результатами

Скрипт, который собирает счёт с сайта лайв-результатов, работает до первого обновления этого сайта. Плюс блокировки, капча и отсутствие прав на использование данных.

Бесплатные API

Подходят для прототипа, но часто дают результаты с задержкой, только по популярным лигам и без дополнительных показателей — угловых, карточек, счёта по таймам.

Ручной ввод

Работает при десятке матчей в день и превращается в отдельную работу с ошибками, когда матчей сотни.

Вариант 1: API результатов — когда нужны итоги матчей

Если вы публикуете результаты на сайте, в приложении или Telegram-канале либо проверяете прогнозы, достаточно API результатов SportAPI:

итоговый счёт, основное время, таймы и сеты;
дополнительные показатели: угловые, карточки, фолы, удары в створ;
группировка по видам спорта, странам и чемпионатам;
результаты по спорту и киберспорту — Counter-Strike, Dota и другим дисциплинам;
больше 100 000 событий в месяц и история за 20 лет;
результат появляется через 1–20 минут после окончания матча, топ-матчи — сразу.

Стоимость — от $25 в месяц за вид спорта, +$10 за каждый дополнительный язык. Проверить данные можно на тестовом доступе за 2 дня.

Вариант 2: расчёт ставок под ключ — когда нужен итог ставки

Если вы принимаете ставки, проводите конкурсы прогнозов с призами или считаете выигрыши, правильнее передать расчёт системе, которая уже знает правила всех рынков. Так работает API приёма и расчёта ставок SportAPI:

Игрок выбирает исход в вашем интерфейсе. Из спортивной линии вы получаете указатель этого исхода (oc_pointer).
Вы создаёте купон — ординар или экспресс — запросом POST /api/partner/coupons/place.
Система расчёта проверяет, что событие и исход существуют, исход открыт для ставок, а коэффициент не изменился.
После матча система сама определяет результат каждой ставки и обновляет купон.
Вы получаете итог через callback на свой сервер или запросом к API.

Вам не нужно ни собирать результаты, ни сопоставлять матчи между источниками, ни описывать правила расчёта фор и тоталов. Подробно процесс описан в документации «Жизненный цикл расчёта».

Какие итоги бывают у ставки

Статус ставки	Что означает	Расчётный множитель
`WIN`	Полный выигрыш	Исходный коэффициент
`LOSE`	Полный проигрыш	0
`RETURN`	Возврат ставки	1
`HALF_WIN`	Половинный выигрыш	(коэффициент + 1) / 2
`HALF_LOSE`	Половинный проигрыш	0,5
`PUSH`	Возврат при равном результате	1
`RECALCULATE`	Исход возвращён на перерасчёт	—

Купон целиком получает итоговый статус — выигрыш, проигрыш или возврат, — когда рассчитаны все его ставки; проигравший экспресс закрывается уже после первого проигравшего исхода. Полный список статусов и правила выплат — в разделе «Статусы и выплаты».

Как выглядит результат расчёта в JSON

Когда меняется расчётное состояние купона, система отправляет на ваш сервер callback. Вот сокращённый пример из документации — экспресс, в котором первая ставка уже рассчитана, а вторая ещё ждёт своего матча:

{
  "event": "coupons.settled",
  "batchId": "d407e986f3a64d9d36a77bf532322ef8",
  "couponCount": 1,
  "coupons": [
    {
      "coupon_code": "000000000272",
      "realWin": 0,
      "calculate_coefficient": 0,
      "status": 0,
      "events_data": [
        {
          "uuid": "912",
          "status": 1,
          "calculate_coefficient": 2,
          "calculate_score": "2:1",
          "settlement_reason_code": "REMOTE_WIN",
          "settlement_reason": "Win"
        },
        {
          "uuid": "913",
          "status": 0,
          "calculate_coefficient": null,
          "calculate_score": "",
          "settlement_reason_code": null,
          "settlement_reason": null
        }
      ]
    }
  ]
}

Что здесь важно:

calculate_score: "2:1" — счёт, по которому рассчитана ставка. Это и есть итоговый результат в JSON, но уже привязанный к конкретной ставке.
status: 1 у первой ставки — выигрыш; status: 0 у второй — ставка ещё не рассчитана.
status: 0 у купона и realWin: 0 — экспресс ещё не завершён, выплаты пока нет.
settlement_reason_code объясняет причину расчёта — это удобно для поддержки и споров с игроками.

Когда рассчитается вторая ставка, придёт новый callback с итоговым статусом купона и суммой выплаты.

Callback или запросы к API

Получать результат можно двумя способами — и лучше использовать оба:

Callback. Система сама присылает подписанный HTTP-запрос при каждом изменении расчёта. Подпись проверяется по HMAC, поэтому поддельный запрос не пройдёт.
Запросы к API. Ваш сервер запрашивает купон по коду, список купонов за период или недавно рассчитанные купоны. Это резервный канал, если ваш сервер был недоступен и пропустил callback.

Правила проверки подписи и повторной доставки описаны в документации callback результатов.

Ошибки при самостоятельном расчёте ставок

Рассчитывать по одному итоговому счёту. Форы, тоталы с целой границей и ставки на периоды требуют больше данных и отдельных правил.
Не предусмотреть перерасчёт. Результаты иногда исправляют после матча — система должна уметь отменить выплату или доплатить.
Ждать все матчи экспресса. Проигравший экспресс можно закрыть сразу после первого проигрыша.
Хранить код купона как число. Код может начинаться с нулей — храните его строкой.
Доверять одному каналу доставки. Если callback не дошёл, без резервных запросов купон «зависнет».

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

Где взять результаты матчей в JSON бесплатно?

Бесплатные источники подходят для прототипа, но обычно ограничены по лигам, задержке и набору показателей. Для расчёта денежных ставок нужен источник с договором и поддержкой. Тестовый доступ к SportAPI на 2 дня позволяет проверить данные до оплаты.

Можно ли использовать ChatGPT или другой ИИ-агент для получения результатов матчей?

Для заметок и черновиков — да, для расчёта ставок — нет. Языковая модель может перепутать матч или выдать неподтверждённый счёт, а ошибка в расчёте означает неверную выплату.

Как быстро появляются результаты после окончания матча?

В API результатов SportAPI — в течение 1–20 минут после окончания матча, топ-матчи появляются сразу. Задержка зависит от официальных источников конкретного турнира.

Нужно ли мне самому рассчитывать форы и тоталы?

Нет, если вы используете расчёт ставок SportAPI. Система сама определяет выигрыш, половинный выигрыш, возврат и другие статусы и присылает готовый итог купона.

Что будет, если результат матча исправят после расчёта?

Купон возвращается на перерасчёт, ставка получает статус перерасчёта, а после нового расчёта вы получаете новый итог и новый callback.

Что выбрать

Нужны итоги матчей для сайта, канала или проверки прогнозов — API результатов SportAPI, от $25 в месяц за вид спорта.
Нужно рассчитывать ставки, купоны и выплаты — расчёт ставок под ключ через Coupon API: результаты, правила рынков и перерасчёты уже внутри.
Сейчас результаты подтягивает ИИ-агент или парсер — переведите расчёт на источник с договором до того, как ошибка обойдётся в реальные выплаты.

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