Genesis Arbitrage

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

Рынки предсказаний и букмекерские вилки в 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/analyticsKPI, движения цен, потоки денегPro, Max
/predictions/smart-moneyКрупные сделки, киты, insider-паттерныPro, Max
/predictions/tradesЛента сделок PolymarketPro, Max
/predictions/tradersТоп-300 трейдеров Polymarket по PnLPro, Max

На Trial все шесть отвечают 403 plan_restricted, на Start — запросы с mode=llm и mode=sport. Формат ответа — в инструкции об ответах и ошибках, квота — в инструкции о лимитах.

Арбитраж прогнозов: режимы

Параметр mode выбирает, какие связки вернёт /predictions/arbitrage.

modeЧто в выдачеkindТарифы
exactОдинаковые события на двух площадках, режим по умолчаниюcrossStart, Pro, Max
dutchНабор исходов одного события на одной площадкеdutchStart, Pro, Max
llmПары событий, сверенные ИИcrossPro, Max
sportБукмекерские вилки по матчамsportPro, 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

Фильтры

ПараметрТипЧто делает
modestringexact (по умолчанию), dutch, llm или sport
categorystringКатегория — как в поле category
platformstringХотя бы одна нога на этой площадке; несколько — через запятую
min_profit_pctnumberПрибыль не меньше, %
min_profit_usdnumberПрибыль не меньше, $; строки с profit_usd = null отсекаются
min_aprnumberГодовая доходность не меньше, %
max_daysnumberНе больше стольких дней до итогов
sport, leaguestringВид спорта и лига, для 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, matchcross, 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[].sideyes или 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_typeWIN — исход, 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"
    }
  ]
}

Связки с площадкой в down или с ok = false лучше пропустить: цены в них могли уйти.

Аналитика, умные деньги, сделки и трейдеры

Четыре эндпоинта на Pro и Max повторяют экраны из инструкций «Аналитика» и «Умные деньги».

ЭндпоинтПараметрыЧто внутри
/predictions/analyticsнетKPI, движения цен за 1 ч и 24 ч, потоки денег, рынки с близкими итогами, новые рынки
/predictions/smart-moneyнетKPI, потоки денег, insiders, concentration, smart_vs_price
/predictions/tradesperiod, wallet, category, side, min_usd, insiderСделки Polymarket, новые сверху
/predictions/tradersperiod: 30d (по умолчанию), 7d, allТоп-300 трейдеров Polymarket по PnL

Метка insider описывает паттерн поведения кошелька и ничего не доказывает: так может торговать и новый адрес опытного игрока.

Параметры ленты сделок, порог задаёт period:

ПараметрТипЧто делает
periodstringlive (по умолчанию) — сделки от $1 000 и умных кошельков от $100; today и 7d — тейкеры от $5 000
walletstringСделки одного кошелька
categorystringКатегория рынка
sidestringbuy или sell
min_usdnumberСумма сделки не меньше, $
insiderbooleantrue — только сделки с меткой 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 ленты сделок.

Как пользоваться

  1. Проверьте тариф и площадки

    /account/usage покажет тариф, /predictions/platforms — свежесть котировок.

  2. Запросите связки с фильтрами

    min_profit_pct и max_days отсекают лишнее и долгие связки.

  3. Проверьте риски и правила

    При rules_differ прочитайте правила итогов обеих площадок.

  4. Опрашивайте не чаще свежести тарифа

    Интервал — от meta.freshness_sec, ETag верните в If-None-Match: ответ 304 квоту не тратит.

  5. Сделайте сделку сами

    Откройте рынок по 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».