Genesis Arbitrage

Genesis Arbitrage · · 14 мин чтения

API коэффициентов букмекеров: события, коэффициенты и вилки через API

Коротко

  • API коэффициентов отдаёт события, рынки и коэффициенты каждой букмекерской конторы со временем обновления. Вероятность исхода по коэффициенту равна 1/k, а цена контракта YES на рынке предсказаний — та же вероятность в долларах.
  • Вилка есть, если сумма 1/k лучших коэффициентов на все исходы рынка меньше 1, а ставку на исход делят пропорционально 1/k. Чаще всего ошибаются в сопоставлении: матч, рынок, период и линия должны совпадать на всех площадках.
  • Genesis API в режиме mode=sport на тарифах Pro и Max отдаёт прематч-вилки 13 площадок с долей ставки stake_unit по каждой ноге. profit_usd в них равен null, потому что лимит ставки у букмекера неизвестен.

API букмекеров, или API коэффициентов, — программный доступ к линии: событиям, рынкам и коэффициентам каждой букмекерской конторы со временем последнего обновления. По этим данным программа сравнивает цены площадок и находит вилки — ставки на все исходы матча с прибылью при любом результате, если все ставки приняты и рассчитаны по одним правилам. Готовые вилки 13 площадок отдаёт Genesis API: эндпоинт /predictions/arbitrage с параметром mode=sport.

Что отдаёт API коэффициентов

Поля у поставщиков называются по-своему, но линию в API коэффициентов описывают пять уровней. Без периода и линии два коэффициента не сравнить, без времени непонятно, действует ли ещё цена. Справа — условный пример.

УровеньЧто внутриПример
СобытиеВид спорта, турнир, команды, началоФутбол, Bundesliga, Bayern — Dortmund
РынокТип ставки, период, линияТотал 2.5, основное время
ИсходНа что ставкаБольше 2.5
ЦенаКоэффициент каждой конторыFonbet @1.95, Winline @2.02
ВремяКогда цена обновлена12 секунд назад

Коэффициенты приходят в десятичном, дробном или американском виде, а площадки прогнозов вместо коэффициента отдают цену контракта в долларах. Источник данных — открытый API самой площадки или поставщик, который собирает линии многих контор в один формат. Данные Polymarket и Kalshi разобраны в статье «API Polymarket и Kalshi».

Коэффициент, вероятность и цена в центах

Десятичный коэффициент показывает, сколько вернётся на каждый поставленный доллар вместе со ставкой: $100 по @2.25 превращаются в $225. Обратная величина — вероятность по коэффициенту: 1 / 2.25 = 0,4444, или 44,44 %. Дробные и американские коэффициенты переводят в десятичные по формулам из статьи «Коэффициенты в ставках».

ЦенаКоэффициентВероятность
@2.25 у букмекера2.2544,44 %
@3.60 у букмекера3.6027,78 %
YES за 30¢ на Polymarket1 / 0,30 = 3.3330 %

Контракт YES приносит $1, если исход сыграет, поэтому его цена в долларах и есть вероятность по оценке рынка. Контракт NO на победу команды выигрывает и при победе соперника, и при ничьей, как двойной шанс.

У одной конторы сумма вероятностей по всем исходам рынка больше 1, превышение — её маржа. Условный пример: линия Fonbet на Bayern — Dortmund 2.15 / 3.45 / 3.40 даёт 0,46512 + 0,28986 + 0,29412 = 1,04910, маржа — 4,91 %. Расчёт по шагам — в статье «Маржа букмекера».

Как найти вилку по коэффициентам

Вилку ищут по лучшим ценам разных контор: для каждого исхода рынка берут наибольший коэффициент и складывают 1/k. Условный пример: тот же матч, рынок «исход» по основному времени.

ИсходЛучший коэффициентГде1/k
П1, победа Bayern@2.25Betcity0,44444
X, ничья@3.60Marathon0,27778
П2, победа Dortmund@3.80Winline0,26316

L = 0,44444 + 0,27778 + 0,26316 = 0,98538

Сумма меньше 1 — вилка есть, прибыль 1 / 0,98538 − 1 = 1,48 %. Линии четырёх контор из кода ниже идут с маржой от 3,8 до 5,1 %, вилку даёт разница в их оценке матча.

Сумму делят пропорционально 1/k: из $1 000 на П1 идёт 1 000 × 0,44444 / 0,98538 = $451,04, остальные ставки — в таблице.

СтавкаСуммаЕсли сыграет
Betcity · П1 @2.25$451,04$1 014,84
Marathon · X @3.60$281,90$1 014,84
Winline · П2 @3.80$267,06$1 014,83

При любом исходе вернётся около 1 000 / 0,98538 = $1 014,84, прибыль в худшем исходе — $14,83 из-за округления ставок.

Та же логика в коде, на входе — линия одного рынка у четырёх контор:

# Условный пример: линия одного рынка 1X2 у четырёх контор
line = {
    "Fonbet":   {"1": 2.15, "X": 3.45, "2": 3.40},
    "Betcity":  {"1": 2.25, "X": 3.20, "2": 3.40},
    "Marathon": {"1": 2.05, "X": 3.60, "2": 3.50},
    "Winline":  {"1": 2.10, "X": 3.35, "2": 3.80},
}


def surebet(line, bank):
    outcomes = next(iter(line.values())).keys()
    # лучший коэффициент на каждый исход и контора, где он есть
    best = {o: max((odds[o], bk) for bk, odds in line.items())
            for o in outcomes}
    total = sum(1 / k for k, _ in best.values())
    if total >= 1:
        return None  # вилки нет
    for o, (k, bk) in best.items():
        print(f"{o}: {bk} @{k} — ${bank / k / total:.2f}")
    return round((1 / total - 1) * 100, 2)


print(surebet(line, 1000), "%")  # 1.48 %

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

Сопоставление: один матч, рынок, период и линия

Формула верна, только если все коэффициенты относятся к одному рынку одного матча. У контор команды записаны по-разному, время начала расходится на минуты, рынки называются по-своему. Ошибка сопоставления даёт ложную вилку: сумма 1/k меньше 1, а при одном из исходов проигрывают все ставки.

Что сверитьГде ошибаютсяПоле в mode=sport
Матч и составBayern и Bayern II, женская или молодёжная командаteams, flags
НачалоМатч перенесли у одной из конторstarts_at
Тип рынкаИсход, фора, тотал, обе забьют, точный счётmarket_type
ПериодОсновное время или матч с овертаймомperiod
ЛинияФора −1.5 и фора −1.25 — разные ставкиline
Исходы ногВместе ноги должны покрыть все исходыlegs[].covers

Основное время в футболе — 90 минут с добавленным временем. Исход, фора и тотал в футболе и хоккее у площадок ставок обычно считаются по нему, если в названии рынка не сказано «с учётом овертайма и буллитов». Рынок победителя на площадке прогнозов может учитывать овертайм, и при ничьей в основное время пара может проиграть целиком.

Фора складывается в вилку с противоположной форой той же величины: Ф1(−1.5) и Ф2(+1.5). У азиатской форы с четвертью, например −0.75, ставка делится пополам между соседними линиями, и пара Ф1(−0.75) и Ф2(+0.75) тоже покрывает любой счёт. Тотал сводят по одной линии: «больше 2.5» с «меньше 2.5».

Обратная пара, «больше 2.5» и «меньше 3.5», — уже коридор: при трёх голах выигрывают обе ставки. В Genesis API line и period заданы один раз на всю вилку, поэтому ноги с разными линиями в одну строку не попадают.

Вилки через Genesis API: режим mode=sport

Эндпоинт /predictions/arbitrage с mode=sport отдаёт вилки, в которых эта работа уже сделана: матчи сопоставлены, лучшие цены подобраны, ноги площадок прогнозов пройдены по стакану с комиссией. Площадок 13: Polymarket, Kalshi, Predict.fun и 10 площадок ставок — Fonbet, Betcity, Olimpbet, Marathon, 5051X, Melbet, Winline, BC.Game, EGB и Dafa Sports. Только прематч: с началом матча вилка уходит из ответа.

Режим входит в тарифы Pro ($100 в месяц, новый снимок раз в 10 с) и Max ($200, раз в 5 с), на Trial и Start запрос вернёт 403 plan_restricted. Полную линию каждой конторы API не отдаёт: в ответе только найденные вилки, по каждой ноге — площадка, исход и цена.

curl -G "https://api.genesisarbitrage.com/v1/predictions/arbitrage" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
  -d mode=sport -d sport=soccer -d min_profit_pct=1.5

Условный пример — строка mode=sport из документации с пересчитанными ценами:

{
  "id": "s:8812:RT:TOT:2.5:",
  "kind": "sport",
  "match": "sport",
  "title": "Arsenal — Chelsea",
  "category": "sports",
  "sport": "soccer",
  "league": "Premier League",
  "teams": ["Arsenal", "Chelsea"],
  "market_type": "TOT",
  "period": "RT",
  "line": 2.5,
  "score": null,
  "starts_at": 1794700800,
  "size_usd": 1000,
  "profit_usd": null,
  "profit_pct": 2.39,
  "legs": [
    {
      "platform": "polymarket",
      "side": "yes",
      "outcome": "Over 2.5",
      "covers": ["O"],
      "price_avg": 0.505,
      "odds": null,
      "stake_unit": 0.505,
      "currency": "USD"
    },
    {
      "platform": "fonbet",
      "side": "bet",
      "outcome": "Under 2.5",
      "covers": ["U"],
      "odds": 2.12,
      "stake_unit": 0.471698,
      "currency": "RUB"
    }
  ]
}

Пять уровней линии — в полях строки:

УровеньПоляВ примере
Событиеtitle, sport, league, teams, starts_atArsenal — Chelsea, soccer, Premier League
Рынокmarket_type, period, line, scoreTOT, FT, 2.5
Ногаplatform, side, outcome, coversfonbet, bet, Under 2.5, U
Ценаodds, price_avg, stake_unit, currency2.12, 0.471698, RUB
Итогsize_usd, profit_pct, profit_usd1000, 2.39, null

market_type — тип рынка: WIN — исход, HCP — фора, TOT — тотал, BTTS — обе забьют, CS — точный счёт со счётом в score. В side у покупки контракта стоит yes или no, у ставки по коэффициенту — bet. covers — исходы, которые покрывает нога: здесь O — больше, U — меньше.

Как разложить ставку по stake_unit

stake_unit — сколько вложить в ногу, чтобы она принесла $1, если сыграет. У ставки по коэффициенту это 1 / odds: 1 / 2.12 = 0,471698. У покупки YES или NO — средняя цена по стакану вместе с комиссией; в условном примере комиссия не начислена, поэтому stake_unit равен price_avg.

Сумма долей — 0,505 + 0,471698 = 0,976698, прибыль — 1 / 0,976698 − 1 = 2,39 %. Свою сумму S делят по формуле вилки: ставка ноги = S × stake_unit / Σ stake_unit. Для $500:

НогаСтавкаЕсли сыграет
Polymarket · YES «больше 2.5» по 50,5¢$258,52511,92 акции — $511,92
Fonbet · «меньше 2.5» @2.12$241,48$511,94

При любом исходе вы получите около $511,93, прибыль в худшем исходе — $11,92. size_usd — сумма покупок на площадках прогнозов, которую стакан выдерживает по этим ценам. Здесь это $1 000: 1 000 / 0,505 ≈ 1 980,2 акции, и ставка на Fonbet может дойти до 1 980,2 × 0,471698 ≈ $934,06, если контора её примет.

profit_usd = null, потому что прибыль в долларах зависит от суммы, которую примет Fonbet, а лимит ставки контора не публикует. Поэтому фильтр min_profit_usd отсекает все вилки с ногой у букмекера — отбирайте их по min_profit_pct.

Ставка на Fonbet — в рублях (currency = RUB). При условном курсе 80 ₽ за $1 это 241,48 × 80 = 19 318,40 ₽, а при «меньше 2.5» вернётся 19 318,40 × 2.12 = 40 955,01 ₽. Разница курсов при обмене в profit_pct не входит.

Python: вилки по футболу с min_profit_pct

Скрипт запрашивает вилки по футболу с прибылью от 1,5 %, печатает каждую со временем до начала матча и делит на ноги сумму BANK по stake_unit. Ключ — из переменной окружения GENESIS_API_KEY, как его получить — в быстром старте.

import os
import time

import requests

API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
PARAMS = {"mode": "sport", "sport": "soccer", "min_profit_pct": 1.5}
BANK = 500  # сумма на всю вилку, $


def fetch():
    while True:
        r = requests.get(f"{API}/predictions/arbitrage",
                         headers=HEADERS, params=PARAMS, timeout=10)
        if r.status_code in (429, 503):
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        if r.status_code == 403:
            raise SystemExit("mode=sport — только на тарифах Pro и Max")
        r.raise_for_status()
        return r.json()["data"]


def unit(leg):  # цена $1 выигрыша: stake_unit, иначе 1/odds или цена
    if leg.get("stake_unit"):
        return leg["stake_unit"]
    return 1 / leg["odds"] if leg.get("odds") else leg["price_avg"]


for row in fetch():
    mkt = [row["market_type"], row["line"], row["period"]]
    mkt = " ".join(str(v) for v in mkt if v is not None)
    hours = (row["starts_at"] - time.time()) / 3600
    print(f"{row['profit_pct']}% · {row['title']} · {mkt} · "
          f"начало через {hours:.1f} ч")
    total = sum(unit(leg) for leg in row["legs"])
    for leg in row["legs"]:
        price = leg.get("odds") or leg.get("price_avg")
        print(f"   {leg['platform']}: {leg['outcome']} по {price} — "
              f"${BANK * unit(leg) / total:.2f} ({leg['currency']})")

Сумма ноги — в долларах, рядом валюта площадки: ставку в рублях пересчитайте по своему курсу. Если в ноге нет stake_unit, функция unit берёт 1 / odds или price_avg без комиссии, и прибыль выйдет чуть выше настоящей.

Чтобы следить за новыми вилками, повторяйте запрос раз в meta.freshness_sec и сверяйте id: он постоянный у каждой вилки. Ответ с фильтрами приходит без ETag, поэтому экономят интервалом: раз в 10 с на Pro — это 86 400 / 10 = 8 640 вызовов в сутки и 8 640 × 30 = 259 200 за 30 дней при квоте 5 млн, подробнее — в инструкции «Лимиты Genesis API». Фильтры league, platform (например fonbet) и max_days описаны в инструкции по эндпоинтам рынков предсказаний.

Риски: что API не проверит

API считает вилку по ценам снимка, а ставки на двух-трёх площадках делаете вы, и каждая может сломать расчёт.

Ставки регулируются по-разному в разных странах: проверьте законы своей страны и правила каждой площадки. Порядок действий и все риски собраны в уроке «Риски вилок и правила работы», устройство поиска — в статье «Сканер вилок».

Колонки, фильтры и метки таблицы описаны в инструкции «Режим Sport».

Вопросы и ответы

Есть ли бесплатный API коэффициентов букмекеров?

Зависит от поставщика: число запросов, список контор и рынков у каждого свои, а бесплатный доступ, если он есть, ограничен по объёму. Рыночные данные Polymarket и Kalshi официальные API отдают без ключа (Polymarket, Kalshi), но это цены контрактов YES и NO без коэффициентов контор. Бесплатного тарифа у Genesis API нет: mode=sport открыт на Pro ($100 в месяц) и Max ($200), сравнение — на странице «Тарифы Genesis API».

Есть ли в API лайв-коэффициенты?

В Genesis API — нет: режим sport ищет только прематч, и вилка уходит из ответа с началом матча. Почему лайв-вилки ломаются чаще, разобрано в статье «Прематч и лайв».

Почему у вилки profit_usd равен null?

Хотя бы одна нога — ставка у букмекера, а лимит ставки на ваш аккаунт контора не публикует. Процент profit_pct известен, суммы ног считают по stake_unit.

Можно ли сделать ставку через Genesis API?

Нет. Genesis API только читает данные: ставки и покупки вы делаете сами на площадках по ссылкам из legs[].url.