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.25 | 44,44 % |
| @3.60 у букмекера | 3.60 | 27,78 % |
| YES за 30¢ на Polymarket | 1 / 0,30 = 3.33 | 30 % |
Контракт 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.25 | Betcity | 0,44444 |
| X, ничья | @3.60 | Marathon | 0,27778 |
| П2, победа Dortmund | @3.80 | Winline | 0,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_at | Arsenal — Chelsea, soccer, Premier League |
| Рынок | market_type, period, line, score | TOT, FT, 2.5 |
| Нога | platform, side, outcome, covers | fonbet, bet, Under 2.5, U |
| Цена | odds, price_avg, stake_unit, currency | 2.12, 0.471698, RUB |
| Итог | size_usd, profit_pct, profit_usd | 1000, 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,52 | 511,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 считает вилку по ценам снимка, а ставки на двух-трёх площадках делаете вы, и каждая может сломать расчёт.
- Коэффициент меняется. Между снимком и ставкой проходят секунды или минуты: контора снижает коэффициент, в стакане выкупают дешёвые заявки.
- Лимит и порезка. Контора может принять меньше запрошенного или урезать лимит аккаунту, причины — в статье «Почему букмекеры режут вилочников». Ставку по коэффициенту делайте первой, YES или NO покупайте под принятую сумму.
- Возврат ставки. При отмене или переносе матча ставка у букмекера обычно возвращается по коэффициенту 1, а рынок YES/NO рассчитывается по своим правилам, и вилка может закрыться в минус.
- Валюта. Обмен рублей и долларов в прибыль строки не входит.
- Ошибка в линии. Коэффициент намного выше, чем у других контор, бывает ошибкой, и контора вправе пересчитать ставку.
Ставки регулируются по-разному в разных странах: проверьте законы своей страны и правила каждой площадки. Порядок действий и все риски собраны в уроке «Риски вилок и правила работы», устройство поиска — в статье «Сканер вилок».
Колонки, фильтры и метки таблицы описаны в инструкции «Режим 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.