Документация Genesis API
Всё, что нужно для интеграции: аутентификация, лимиты, эндпоинты и схемы ответов.
Арбитраж прогнозов
Арбитраж между площадками прогнозов, как на странице «Арбитраж прогнозов»: связка проходит по стаканам с комиссиями и показывает размер сделки, прибыль в $ и %, годовую доходность и риски. Режимы: exact — точные пары событий и dutch — набор исходов на одной площадке (Start, Pro, Max); llm — пары, сверенные ИИ, и sport — букмекерские вилки (Pro и Max). Если нога — букмекерская контора, profit_usd = null: лимиты ставок конторы неизвестны.
https://api.genesisarbitrage.com/v1/predictions/arbitrage?mode=exact/v1/predictions/arbitrage?mode=exactКлюч хранится только в вашем браузере и никуда, кроме API, не отправляется.
Вставьте ключ и отправьте запрос — покажем сокращённый ответ.
Параметры запроса
Все параметры необязательны: без фильтров эндпоинт вернёт полный набор данных.
| Параметр | Тип | Описание |
|---|---|---|
mode | string | exact (по умолчанию) и dutch — Start, Pro, Max; llm и sport — Pro и Max |
category | string | Фильтр по категории |
platform | string | Хотя бы одна нога на этой площадке или в конторе; несколько — через запятую |
min_profit_pct | number | Минимальная прибыль, % |
min_profit_usd | number | Минимальная прибыль, USD (строки с profit_usd = null не проходят) |
min_apr | number | Минимальная годовая доходность, % |
max_days | number | Не больше этого числа дней до итога |
sport / league | string | Вид спорта и лига для mode=sport, точное совпадение. Коды видов спорта: soccer, basketball, hockey, american_football, baseball, tennis, mma, boxing, volleyball, handball, table_tennis, cricket, rugby, darts, snooker, futsal, esports_cs2, esports_dota2, esports_lol, esports_valorant, esports_other |
Пример запроса
curl "https://api.genesisarbitrage.com/v1/predictions/arbitrage?mode=exact" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Пример ответа
Пример ответа — одна запись data, длинные значения сокращены:
{
"id": "x:exact:kalshi:KXFRENCHPRES-27-JCAS~polymarket:0x8c1f…a93a",
"kind": "cross",
"match": "exact",
"title": "Will Jean Castex win the 2027 French presidential election?",
"category": "Elections",
"event_id": null,
"group_id": "g:cd2ffb419bd1",
"ends_at": 1843308000,
"days_left": 562.87,
"starts_at": null,
"size_usd": 107175.08,
"fees_usd": 28.08,
"profit_usd": 153.69,
"profit_pct": 0.14,
"apr_pct": 0.1,
"edge_cents": 0.18,
"shares": 107356.85,
"risks": ["rules_differ", "end_mismatch"],
"first_seen": 1794526832,
"updated_at": 1794675861,
"legs": [
{
"market": "polymarket:0x8c1f…a93a",
"platform": "polymarket",
"side": "yes",
"outcome": "Jean Castex",
"price_best": 0.001,
"price_avg": 0.0013,
"price_worst": 0.002,
"shares": 107356.85,
"cost_usd": 140.3,
"fee_usd": 5.6,
"url": "https://polymarket.com/event/next-french-presidential-election"
},
{
"market": "kalshi:KXFRENCHPRES-27-JCAS",
"platform": "kalshi",
"side": "no",
"outcome": "No",
"price_best": 0.997,
"price_avg": 0.997,
"price_worst": 0.997,
"shares": 107356.85,
"cost_usd": 107034.78,
"fee_usd": 22.48,
"url": "https://kalshi.com/events/KXFRENCHPRES-27"
}
]
}Пример строки 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", "url": "https://polymarket.com/…" },
{ "platform": "fonbet", "side": "bet", "outcome": "Under 2.5", "covers": ["U"],
"odds": 2.12, "stake_unit": 0.471698, "currency": "RUB", "url": "https://www.fon.bet/…" }
]
}Поля ответа
| Поле | Тип | Описание |
|---|---|---|
id | string | Постоянный идентификатор связки |
kind | string | cross — пара площадок, dutch — набор исходов, sport — букмекерская вилка |
match | string | exact, llm или sport |
title / category | string | Название события или рынка и категория |
event_id / group_id | string | null | Идентификаторы события и группы пар |
ends_at / days_left / starts_at | number | null | Время итога, дней до итога и начало матча (unix-секунды) |
size_usd / fees_usd | number | Размер сделки и комиссии, USD |
profit_usd / profit_pct | number | null | Прибыль в USD и % к вложенному; profit_usd = null — нога в конторе |
apr_pct | number | null | Годовая доходность, % (null при сроке меньше суток) |
edge_cents | number | Запас по цене, центов на акцию |
shares | number | Число акций в связке |
risks | string[] | Коды рисков: разные правила, разные даты итога и т. п. |
first_seen / updated_at | number | Когда связка появилась и когда обновлена |
legs[].market / platform | string | Рынок ноги и площадка или контора |
legs[].side / outcome | string | Что купить — yes, no или bet (ставка в конторе) — и исход |
legs[].price_best / price_avg / price_worst | number | Лучшая, средняя и худшая цена при проходе по стакану |
legs[].shares / cost_usd / fee_usd / url | mixed | Акции, стоимость, комиссия ноги и ссылка |
sport / league / teams / flags | mixed | Для sport: вид спорта, лига, команды, метки |
market_type / period / line / score | mixed | Для sport: тип рынка (WIN, HCP, TOT, BTTS, CS), период, линия, счёт |
legs[].covers / odds / stake_unit / currency | mixed | Для sport: какие исходы покрывает нога, коэффициент, доля ставки и валюта конторы |