Эндпоинты арбитража Genesis API: CEX, DEX, кроссчейн и акции
Коротко
- Семь эндпоинтов отдают связки таблиц сайта: три CEX-набора есть на всех тарифах, акции — с тарифа Start, DEX – Спот, DEX – Фьючерсы и Кроссчейн — на Pro и Max.
- Строка CEX-набора содержит цены и лучшие заявки обеих бирж, сеть, контракт, статусы ввода и вывода и объёмы — по ним отбирают связки, которые можно исполнить.
- Спред в ответе — расхождение цен на момент снимка: комиссии, перевод и проскальзывание из него не вычтены.
Эндпоинты арбитража Genesis API отдают те же связки, что таблицы Genesis Arbitrage: спреды между спотовыми и фьючерсными рынками CEX-бирж, между DEX и CEX, между сетями и по токенизированным акциям. Каждый элемент data — одна связка: где купить, где продать, спред — разница цен в процентах — и поля для проверки: статусы ввода и вывода, объёмы, ликвидность, ссылки. Все семь эндпоинтов — GET с ключом в заголовке X-API-Key.
Семь эндпоинтов и тарифы
| Эндпоинт | Что отдаёт | Тарифы |
|---|---|---|
/arbitrage/spot-spot | Спреды между спотовыми рынками CEX | Trial, Start, Pro, Max |
/arbitrage/spot-futures | Спот против фьючерса на CEX | Trial, Start, Pro, Max |
/arbitrage/futures-futures | Фьючерсы разных CEX | Trial, Start, Pro, Max |
/arbitrage/dex-spot | Цена на DEX против спота CEX | Pro, Max |
/arbitrage/dex-futures | Цена на DEX против фьючерса CEX | Pro, Max |
/arbitrage/crosschain | Один токен на DEX в разных сетях | Pro, Max |
/arbitrage/stocks | Токенизированные акции, металлы, индексы и сырьё на CEX | Start, Pro, Max |
Эндпоинт вне тарифа отвечает 403 plan_restricted; коды ошибок — в инструкции «Ответы и ошибки Genesis API», цены — на странице «Тарифы Genesis API».
CEX: Спот – Спот, Спот – Фьючерсы, Фьючерсы – Фьючерсы
Три CEX-эндпоинта принимают одни параметры и отдают строки одного формата. Рынки сторон видны в полях market_buy и market_sell: spot и spot, spot и futures или futures и futures.
| Параметр | Тип | Что делает | Пример |
|---|---|---|---|
coin | string | Фильтр по тикеру монеты | coin=BTC |
exchange | string | Фильтр по бирже; несколько — через запятую | exchange=Binance,OKX |
min_spread | number | Минимальный спред, % | min_spread=1 |
min_volume | number | Минимальный суточный объём обеих сторон, USD | min_volume=50000 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/spot-spot" \
-d min_spread=1 -d min_volume=50000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/spot-futures" \
-d coin=BTC -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/futures-futures" \
-d exchange=Binance,OKX -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Строка ответа из документации Спот — Спот, сокращённо:
{
"coin": "FUEL",
"exchange_buy": "ByBit",
"exchange_sell": "Gate",
"market_buy": "spot",
"market_sell": "spot",
"price_buy": 0.0007029,
"price_sell": 0.0007037,
"ask_buy": 0.0007029,
"bid_sell": 0.0007021,
"spread_pct": 0.11,
"network": "ETH",
"contract": "0x675B68AA4d9c2d3BB3F0397048e62E6B7192079c",
"withdraw_enabled_buy": true,
"deposit_enabled_sell": true,
"volume_24h_buy": 17652.64,
"volume_24h_sell": 12512.51,
"trade_url_buy": "https://www.bybit.com/trade/spot/FUEL/USDT",
…
}
| Поле | Тип | Что содержит |
|---|---|---|
exchange_buy, exchange_sell | string | Биржа покупки и биржа продажи |
market_buy, market_sell | string | Рынок стороны: spot или futures |
price_buy, price_sell | number | Цены, по которым считается спред |
bid_*, ask_* | number или null | Лучшие бид и аск каждой стороны |
spread_pct | number | Спред, % |
network, contract | string; string или null | Сеть и адрес контракта токена |
deposit_enabled_*, withdraw_enabled_* | boolean | Открыты ли ввод и вывод на каждой бирже |
volume_24h_buy, volume_24h_sell | number или null | Объём за 24 часа, USD |
trade_url_buy, trade_url_sell | string | Ссылки на торговые терминалы |
spread_pct считается по price_buy и price_sell — на сайте это колонка «Цена», последняя сделка. Сделка же пройдёт по стакану: покупка — по ask_buy, продажа — по bid_sell. В примере bid_sell ниже ask_buy, и по лучшим заявкам связка в минусе:
(0,0007021 − 0,0007029) / 0,0007029 × 100 ≈ −0,11 %
Точную разницу на нужный объём даёт «Δ по ордерам» — GET /orderbooks/spreads/{dataset} из инструкции «Эндпоинты стаканов».
Переводимые связки Спот – Спот
Межбиржевая связка на споте исполнима, только если монету можно перевести: купить на одной бирже, вывести и зачислить на другой. Для этого вывод должен быть открыт на бирже покупки (withdraw_enabled_buy), а ввод — на бирже продажи (deposit_enabled_sell). Параметров для этих флагов в запросе нет: отбор по ним делается в коде, а неликвид отсекает min_volume на сервере.
import os
import requests
r = requests.get(
"https://api.genesisarbitrage.com/v1/arbitrage/spot-spot",
headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
params={"min_spread": 1, "min_volume": 50000},
timeout=15,
)
r.raise_for_status()
rows = r.json()["data"]
# Перевод возможен, если вывод открыт на бирже покупки,
# а ввод — на бирже продажи
ok = [x for x in rows
if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
ok.sort(key=lambda x: x["spread_pct"], reverse=True)
for x in ok[:10]:
print(f'{x["coin"]:<8} {x["exchange_buy"]} → '
f'{x["exchange_sell"]} {x["spread_pct"]} % '
f'сеть {x["network"]}')
Повторы при 429 и 503 добавляет функция get_json из инструкции «Ответы и ошибки». Бот с уведомлениями в Telegram на этих данных собран в статье «Бот для арбитража криптовалют на Python».
DEX – Спот и DEX – Фьючерсы
DEX-наборы сравнивают цену токена на DEX — децентрализованной бирже — с ценой на CEX: в DEX – Спот со спотом, в DEX – Фьючерсы с фьючерсом. Оба эндпоинта работают на тарифах Pro и Max.
| Параметр | Тип | Что делает | Пример |
|---|---|---|---|
coin | string | Фильтр по тикеру монеты | coin=SCR |
exchange | string | CEX-биржа; несколько — через запятую | exchange=MEXC |
min_spread | number | Минимальный спред, % | min_spread=2 |
min_liquidity | number | Минимальная ликвидность, USD | min_liquidity=50000 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/dex-spot" \
-d min_spread=2 -d min_liquidity=50000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/dex-futures" \
-d min_spread=1 -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Строка DEX – Спот из документации, сокращённо:
{
"coin": "SCR",
"exchange": "MEXC",
"cex_price": 0.02691,
"dex_price": 0.02679,
"spread_pct": 0.45,
"network": "SCROLL",
"liquidity_usd": 10544.15,
"market_cap": 5091835.0,
"deposit_enabled": true,
"withdraw_enabled": true,
"dexscreener_url": "https://dexscreener.com/scroll/0xd296…",
"dextools_url": null,
"gmgn_url": null,
…
}
Цена на MEXC выше цены в пуле, поэтому спред положительный. Знак spread_pct задаёт направление: плюс — токен дешевле на DEX, его покупают там и продают на CEX; минус — наоборот.
| Поле | Тип | Что содержит |
|---|---|---|
exchange | string | CEX-биржа |
cex_price, dex_price | number | Цена на CEX и на DEX |
liquidity_usd | number | Ликвидность пула, USD |
market_cap, dex_volume_24h | number или null | Капитализация и объём DEX за 24 часа (DEX – Спот) |
ticker, max_position_usd | string; number или null | Пара на бирже и максимальная позиция, USD (DEX – Фьючерсы) |
deposit_enabled, withdraw_enabled | boolean | Открыты ли ввод и вывод на CEX |
dexscreener_url, dextools_url, gmgn_url | string или null | Ссылки на DexScreener, DEXTools и GMGN |
Ликвидность пула в примере — $10 544, и крупная покупка сдвинет цену. Проскальзывание на суммах от $100 до $100 000, налоги токена и признак honeypot по контракту отдаёт GET /orderbooks/dex-slippage на тарифах Pro и Max.
Кроссчейн: один токен в разных сетях
GET /arbitrage/crosschain сравнивает цену одного токена на DEX в разных блокчейнах на тарифах Pro и Max. Строка состоит из coin, spread_pct и двух объектов с одинаковыми полями: buy — сторона, где токен дешевле, и sell — где дороже. Токен между сетями переводят через кроссчейн-мост.
| Параметр | Тип | Что делает | Пример |
|---|---|---|---|
coin | string | Фильтр по тикеру токена | coin=WLD |
chain | string | Фильтр по сети | chain=ethereum |
min_spread | number | Минимальный спред, % | min_spread=1 |
min_liquidity | number | Минимальная ликвидность, USD | min_liquidity=20000 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/crosschain" \
-d coin=WLD -d min_liquidity=20000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Строка из документации Кроссчейна, сокращённо:
{
"coin": "WLD",
"spread_pct": 0.59,
"buy": {
"chain": "optimism",
"pair": "WLD/USDC",
"price_usd": 0.4048,
"liquidity_usd": 48747,
"volume_24h_usd": 2484,
"pool_created_at": "2023-07-24 08:44:19 UTC",
…
},
"sell": {
"chain": "ethereum",
"pair": "WLD/WETH",
"price_usd": 0.4072,
"liquidity_usd": 421426,
…
}
}
| Поле | Тип | Что содержит |
|---|---|---|
buy.chain | string | Сеть стороны |
buy.pair | string | Пара на DEX, например WLD/USDC |
buy.contract | string | Адрес контракта в этой сети |
buy.price_usd, buy.liquidity_usd, buy.volume_24h_usd | number | Цена, ликвидность пула и объём за 24 часа, USD |
buy.pool_created_at | string или null | Дата создания пула |
buy.dexscreener_url, dextools_url, gmgn_url | string или null | Ссылки на DexScreener, DEXTools и GMGN |
У sell те же поля. pool_created_at — строка с датой в UTC, а не unix-секунды, как большинство времён в API; бывает null. Пул, созданный на днях, — повод сверить контракты обеих сторон: в новой сети под тем же тикером может оказаться другой токен.
Фондовый арбитраж: акции, металлы, индексы, сырьё
GET /arbitrage/stocks отдаёт спреды по токенизированным акциям, металлам, индексам и сырью между CEX-биржами и доступен с тарифа Start.
| Параметр | Тип | Что делает | Пример |
|---|---|---|---|
symbol | string | Фильтр по тикеру инструмента | symbol=BRENT |
category | string | Категория: Stock, Metal, Index или Commodity | category=Commodity |
exchange | string | Фильтр по бирже; несколько — через запятую | exchange=MEXC |
min_spread | number | Минимальный спред, % | min_spread=0.3 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/stocks" \
-d category=Commodity -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Строка из документации фондового арбитража, сокращённо:
{
"symbol": "BRENT",
"category": "Commodity",
"exchange_buy": "MEXC",
"exchange_sell": "Ourbit",
"symbol_on_buy": "UKOIL",
"symbol_on_sell": "BRENTOIL",
"price_buy": 76.68,
"price_sell": 76.82,
"spread_pct": 0.18,
…
}
symbol — общий тикер инструмента, а symbol_on_buy и symbol_on_sell — его названия на биржах: в примере нефть Brent на MEXC торгуется как UKOIL, на Ourbit — как BRENTOIL. Ищите инструмент на бирже по symbol_on_*. Полей сети, контракта и ввода-вывода в строке нет: на CEX эти инструменты торгуются как бессрочные фьючерсы, и связку открывают позициями Long и Short (инструкция к таблице).
Ответы API и таблицы сайта
Колонки таблиц сайта разобраны в инструкциях:
| Эндпоинт | Таблица сайта и инструкция к ней |
|---|---|
/arbitrage/spot-spot | Спот – Спот |
/arbitrage/spot-futures | Спот – Фьючерсы |
/arbitrage/futures-futures | Арбитраж фьючерсов |
/arbitrage/dex-spot | DEX – Спот |
/arbitrage/dex-futures | DEX – Фьючерсы |
/arbitrage/crosschain | Кроссчейн |
/arbitrage/stocks | Фондовый арбитраж |
Как собрать монитор связок
Выберите эндпоинт под тариф
Сверьтесь с таблицей тарифов выше: DEX-наборы и Кроссчейн есть только на Pro и Max.
Сузьте выборку на сервере
Задайте
min_spreadвыше суммы комиссий, аmin_volumeилиmin_liquidity— чтобы отсечь неликвид.Отберите исполнимые строки в коде
Спот – Спот —
withdraw_enabled_buyиdeposit_enabled_sell. DEX – Спот при плюсовом спреде —deposit_enabled, при минусовом —withdraw_enabled. Акции — ищите поsymbol_on_buyиsymbol_on_sell.Проверьте токен и стакан
Сверьте
contractиnetwork, посчитайте исполнение на свою сумму через эндпоинты стаканов.Опрашивайте с частотой тарифа
Не чаще
meta.freshness_sec. Бот присылает уведомление, сделку вы открываете на бирже сами.
Вопросы и ответы
Можно ли через эти эндпоинты открыть сделку?
Нет. Genesis API только отдаёт данные и ордеров не ставит. Бот на Genesis API находит связку и присылает уведомление, а сделку вы открываете на бирже сами.
Почему в строке нет колонок «Стакан» и «Орд.»?
Они считаются по стаканам и приходят отдельно: «Δ по ордерам» — GET /orderbooks/spreads/{dataset}, стакан рынка — GET /orderbooks/book, оба на тарифах Pro и Max.
Какой тариф нужен для DEX и Кроссчейна?
Pro или Max. На Trial доступны три CEX-набора, на Start к ним добавляется фондовый арбитраж.