Рынки предсказаний и букмекерские вилки в Genesis API: эндпоинты, фильтры и поля
Коротко
- Шесть эндпоинтов: арбитраж прогнозов и состояние площадок открыты с тарифа Start, аналитика, умные деньги, крупные сделки и рейтинг трейдеров — на Pro и Max.
- Связки арбитража уже посчитаны по стаканам с комиссиями: размер сделки, прибыль в $ и %, APR, срок до итогов и коды рисков.
- Режим sport — букмекерские вилки 13 площадок, только прематч. Если одна из ног — ставка по коэффициенту, profit_usd = null, потому что лимит такой ставки неизвестен.
Genesis API отдаёт данные рынков предсказаний шестью GET-эндпоинтами: связки арбитража между Polymarket, Kalshi, Limitless, Predict.fun и Opinion, букмекерские вилки по 13 площадкам, состояние площадок, аналитику, умные деньги, крупные сделки и рейтинг трейдеров. Это данные страниц «Арбитраж прогнозов», «Аналитика» и «Умные деньги» в JSON. На них строят бота, дашборд или уведомления, а сделки и ставки делают сами на площадках.
Эндпоинты и тарифы
| Эндпоинт | Что отдаёт | Тарифы API |
|---|---|---|
/predictions/arbitrage | Связки арбитража и вилки | Start, Pro, Max; режимы llm и sport — Pro, Max |
/predictions/platforms | Состояние площадок | Start, Pro, Max |
/predictions/analytics | KPI, движения цен, потоки денег | Pro, Max |
/predictions/smart-money | Крупные сделки, киты, insider-паттерны | Pro, Max |
/predictions/trades | Лента сделок Polymarket | Pro, Max |
/predictions/traders | Топ-300 трейдеров Polymarket по PnL | Pro, Max |
На Trial все шесть отвечают 403 plan_restricted, на Start — запросы с mode=llm и mode=sport. Формат ответа — в инструкции об ответах и ошибках, квота — в инструкции о лимитах.
Арбитраж прогнозов: режимы
Параметр mode выбирает, какие связки вернёт /predictions/arbitrage.
mode | Что в выдаче | kind | Тарифы |
|---|---|---|---|
exact | Одинаковые события на двух площадках, режим по умолчанию | cross | Start, Pro, Max |
dutch | Набор исходов одного события на одной площадке | dutch | Start, Pro, Max |
llm | Пары событий, сверенные ИИ | cross | Pro, Max |
sport | Букмекерские вилки по матчам | sport | Pro, Max |
Прибыль уже посчитана по стаканам площадок с комиссиями. Запрос exact с прибылью от 1 % и итогами в ближайшие 30 дней:
curl -G "https://api.genesisarbitrage.com/v1/predictions/arbitrage" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
-d mode=exact -d min_profit_pct=1 -d max_days=30
Фильтры
| Параметр | Тип | Что делает |
|---|---|---|
mode | string | exact (по умолчанию), dutch, llm или sport |
category | string | Категория — как в поле category |
platform | string | Хотя бы одна нога на этой площадке; несколько — через запятую |
min_profit_pct | number | Прибыль не меньше, % |
min_profit_usd | number | Прибыль не меньше, $; строки с profit_usd = null отсекаются |
min_apr | number | Годовая доходность не меньше, % |
max_days | number | Не больше стольких дней до итогов |
sport, league | string | Вид спорта и лига, для mode=sport |
Фильтры необязательны и сочетаются. Площадку пишут как в поле legs[].platform: polymarket, kalshi, fonbet. Неизвестный mode даёт 400 bad_request.
Связка и её ноги
Условный пример — строка mode=exact из документации, сокращённая:
{
"id": "x:exact:kalshi:KXFRENCHPRES-27-JCAS~polymarket:0x8c1f…",
"kind": "cross",
"match": "exact",
"title": "Will Jean Castex win the 2027 French presidential…",
"category": "Elections",
"ends_at": 1843308000,
"days_left": 562.87,
"size_usd": 107175.08,
"fees_usd": 28.08,
"profit_usd": 153.69,
"profit_pct": 0.14,
"apr_pct": 0.1,
"shares": 107356.85,
"risks": ["rules_differ", "end_mismatch"],
"legs": [
{
"platform": "polymarket",
"side": "yes",
"outcome": "Jean Castex",
"price_avg": 0.0013,
"cost_usd": 140.3,
"fee_usd": 5.6,
"url": "https://polymarket.com/event/next-french-presidential-…"
},
{
"platform": "kalshi",
"side": "no",
"outcome": "No",
"price_avg": 0.997,
"cost_usd": 107034.78,
"fee_usd": 22.48,
"url": "https://kalshi.com/events/KXFRENCHPRES-27"
}
]
}
| Поле | Что значит |
|---|---|
id, first_seen, updated_at | Постоянный идентификатор, время появления и обновления |
kind, match | cross, dutch или sport; match — exact, llm или sport |
title, category | Событие или рынок и категория |
ends_at, days_left, starts_at | Время итогов, дней до итогов, начало матча |
size_usd, fees_usd, shares | Размер сделки и комиссии в $, число акций |
profit_usd, profit_pct, apr_pct | Прибыль в $ и %, APR; apr_pct = null при сроке меньше суток |
edge_cents, risks | Запас по цене в центах на акцию, коды рисков |
legs[].platform, market, outcome | Площадка, рынок и исход ноги |
legs[].side | yes или no — что купить, bet — ставка по коэффициенту |
legs[].price_best, price_avg, price_worst | Лучшая, средняя и худшая цена при проходе по стакану |
legs[].shares, cost_usd, fee_usd, url | Акции, стоимость, комиссия ноги и ссылка на рынок |
Цена ноги — доля доллара: акция принесёт $1, если её исход сыграет, так что 0.997 — это 99,7¢. Если площадки подведут итоги одинаково, одна из ног сыграет при любом исходе, и shares — сумма, которую вы получите. rules_differ — правила итогов на площадках могут отличаться, end_mismatch — расходятся даты итогов.
В примере 107 356,85 − 107 175,08 − 28,08 = $153,69 прибыли, или 153,69 / 107 203,16 = 0,14 %. Деньги заморожены на 562,87 дня до итогов, и годовых выходит 0,14 × 365 / 562,87 ≈ 0,1 %. Такие связки отсекает фильтр max_days.
Режим sport: букмекерские вилки
Строка sport — один рынок одного матча: 2 или 3 ноги на разных площадках, которые вместе покрывают все его исходы. Площадок 13: Polymarket, Kalshi, Predict.fun и 10 площадок ставок — Fonbet, Betcity, Olimpbet, Marathon, 5051X, Melbet, Winline, BC.Game, EGB и Dafa Sports. Только прематч: с началом матча вилка уходит из выдачи.
Условный пример — строка mode=sport из документации с пересчитанными ценами:
{
"id": "s:8812:RT:TOT:2.5:",
"kind": "sport",
"title": "Arsenal — Chelsea",
"sport": "soccer",
"league": "Premier League",
"teams": ["Arsenal", "Chelsea"],
"market_type": "TOT",
"period": "RT",
"line": 2.5,
"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"
}
]
}
| Поле | Что значит |
|---|---|
sport, league, teams, flags | Вид спорта, лига, команды, метки матча |
market_type | WIN — исход, HCP — фора, TOT — тотал, BTTS — обе забьют, CS — точный счёт |
period, line, score | Период расчёта, линия форы или тотала, счёт для CS |
legs[].covers | Исходы, которые покрывает нога: O — больше, U — меньше |
legs[].odds | Десятичный коэффициент; у покупки YES или NO — null |
legs[].stake_unit | Доля ставки: сколько вложить в ногу ради $1, если она сыграет, с комиссией |
legs[].currency | Валюта площадки |
У ставки по коэффициенту stake_unit = 1 / odds: 1 / 2,12 = 0,471698. Сумма долей по ногам — 0,505 + 0,471698 = 0,976698, она меньше 1, отсюда прибыль 1 / 0,976698 − 1 = 2,39 %. Свою сумму раскладывают по формуле ставка ноги = сумма × stake_unit / Σ stake_unit.
size_usd — сумма покупок на площадках прогнозов, которую выдерживает их стакан. На $1 000 по 0,505 покупается 1 000 / 0,505 ≈ 1 980,2 акции YES «больше 2,5». Чтобы «меньше 2,5» принесло столько же, на Fonbet ставят 1 980,2 × 0,471698 ≈ $934,06.
Ставки на Fonbet — в рублях (currency = RUB): сумму переводите по своему курсу, обмен в profit_pct не входит. profit_usd здесь null, потому что площадка ставок не публикует лимит ставки.
Состояние площадок
/predictions/platforms показывает, насколько свежи данные арбитража. Параметров нет, в data — два списка:
{
"platforms": [
{
"platform": "kalshi",
"mode": "rest",
"quotes_at": 1794675858,
"full_scan_at": 1794675012,
"markets": 26187,
"hot_markets": 188
}
],
"bookmakers": [
{
"bookmaker": "fonbet",
"title": "Fonbet",
"ok": true,
"events": 1840,
"matched_events": 212,
"updated_at": 1794675855,
"currency": "RUB"
}
]
}
platforms[].mode— режим потока площадки прогнозов:ws,restилиdown, если поток не работает.quotes_atиfull_scan_at— время последних котировок и полного обхода рынков;marketsиhot_markets— рынков всего и горячих.bookmakers[]— площадки ставок:ok— идёт ли сбор,eventsиmatched_events— событий всего и сведённых с другими площадками,currency— валюта ставок.
Связки с площадкой в down или с ok = false лучше пропустить: цены в них могли уйти.
Аналитика, умные деньги, сделки и трейдеры
Четыре эндпоинта на Pro и Max повторяют экраны из инструкций «Аналитика» и «Умные деньги».
| Эндпоинт | Параметры | Что внутри |
|---|---|---|
/predictions/analytics | нет | KPI, движения цен за 1 ч и 24 ч, потоки денег, рынки с близкими итогами, новые рынки |
/predictions/smart-money | нет | KPI, потоки денег, insiders, concentration, smart_vs_price |
/predictions/trades | period, wallet, category, side, min_usd, insider | Сделки Polymarket, новые сверху |
/predictions/traders | period: 30d (по умолчанию), 7d, all | Топ-300 трейдеров Polymarket по PnL |
Метка insider описывает паттерн поведения кошелька и ничего не доказывает: так может торговать и новый адрес опытного игрока.
Параметры ленты сделок, порог задаёт period:
| Параметр | Тип | Что делает |
|---|---|---|
period | string | live (по умолчанию) — сделки от $1 000 и умных кошельков от $100; today и 7d — тейкеры от $5 000 |
wallet | string | Сделки одного кошелька |
category | string | Категория рынка |
side | string | buy или sell |
min_usd | number | Сумма сделки не меньше, $ |
insider | boolean | true — только сделки с меткой insider |
curl -G "https://api.genesisarbitrage.com/v1/predictions/trades" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
-d period=today -d side=buy -d min_usd=10000
{
"ts": 1794675812,
"wallet": "0x3a1c…f09e",
"tags": ["whale", "smart"],
"title": "Will Bitcoin reach $150k in 2026?",
"outcome": "No",
"side": "buy",
"price": 0.82,
"shares": 30487.8,
"usd": 25000,
"role": "taker",
"insider": false,
"bid_now": 0.81,
"ask_now": 0.83
}
usd = price × shares: 0,82 × 30 487,8 ≈ 25 000. bid_now и ask_now — текущие цены исхода: купить вслед можно уже по 0,83, на 1¢ дороже трейдера.
В /predictions/traders — PnL за всё время, 30 и 7 дней (pnl_usd), roi_pct, won из resolved и мини-график pnl_series. Адрес из рейтинга подставьте в wallet ленты сделок.
Как пользоваться
Проверьте тариф и площадки
/account/usageпокажет тариф,/predictions/platforms— свежесть котировок.Запросите связки с фильтрами
min_profit_pctиmax_daysотсекают лишнее и долгие связки.Проверьте риски и правила
При
rules_differпрочитайте правила итогов обеих площадок.Опрашивайте не чаще свежести тарифа
Интервал — от
meta.freshness_sec,ETagверните вIf-None-Match: ответ304квоту не тратит.Сделайте сделку сами
Откройте рынок по
legs[].urlи сверьте цену в стакане.
Тот же запрос exact на Python:
import os
from datetime import datetime, timezone
import requests
API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
params = {"mode": "exact", "min_profit_pct": 1, "max_days": 30}
r = requests.get(f"{API}/predictions/arbitrage", headers=HEADERS,
params=params, timeout=10)
if r.status_code == 403:
raise SystemExit("Эндпоинт или режим не входит в тариф API")
r.raise_for_status()
body = r.json()
ts = datetime.fromtimestamp(body["meta"]["updated_at"], timezone.utc)
print(f"Связок: {body['meta']['count']}, данные на {ts:%H:%M:%S} UTC")
for b in body["data"]:
print(f"{b['profit_pct']:.2f}% · ${b['profit_usd']:.2f} · "
f"{b['days_left']:.0f} дн. · {b['title'][:40]}")
for leg in b["legs"]:
print(f" {leg['platform']}: {leg['side']} "
f"{leg['outcome']} по {leg['price_avg']}")
if b["risks"]:
print(" риски:", ", ".join(b["risks"]))
На сайте те же связки разобраны в инструкциях «Арбитраж прогнозов» и «Режим Sport», официальные API площадок — в статьях «API Polymarket и Kalshi» и о коэффициентах площадок ставок.
Вопросы и ответы
Можно ли через Genesis API покупать контракты и делать ставки?
Нет. Genesis API только читает данные и ордеров не ставит: сделки и ставки вы делаете сами на площадках.
Почему у вилки profit_usd равен null?
Хотя бы одна нога — ставка по коэффициенту, а лимит такой ставки площадка не публикует. Процент прибыли известен, суммы ног считайте по stake_unit.
Есть ли в API лайв-вилки?
Нет, только прематч. Чем опасен лайв, разобрано в статье о прематче и лайве.
Какой тариф нужен для букмекерских вилок?
Pro или Max: на Start mode=sport отвечает 403 plan_restricted. Цены — на странице «Тарифы Genesis API».