Genesis Arbitrage

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

Эндпоинты арбитража 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Спреды между спотовыми рынками CEXTrial, Start, Pro, Max
/arbitrage/spot-futuresСпот против фьючерса на CEXTrial, Start, Pro, Max
/arbitrage/futures-futuresФьючерсы разных CEXTrial, Start, Pro, Max
/arbitrage/dex-spotЦена на DEX против спота CEXPro, Max
/arbitrage/dex-futuresЦена на DEX против фьючерса CEXPro, Max
/arbitrage/crosschainОдин токен на DEX в разных сетяхPro, Max
/arbitrage/stocksТокенизированные акции, металлы, индексы и сырьё на CEXStart, Pro, Max

Эндпоинт вне тарифа отвечает 403 plan_restricted; коды ошибок — в инструкции «Ответы и ошибки Genesis API», цены — на странице «Тарифы Genesis API».

CEX: Спот – Спот, Спот – Фьючерсы, Фьючерсы – Фьючерсы

Три CEX-эндпоинта принимают одни параметры и отдают строки одного формата. Рынки сторон видны в полях market_buy и market_sell: spot и spot, spot и futures или futures и futures.

ПараметрТипЧто делаетПример
coinstringФильтр по тикеру монетыcoin=BTC
exchangestringФильтр по бирже; несколько — через запятуюexchange=Binance,OKX
min_spreadnumberМинимальный спред, %min_spread=1
min_volumenumberМинимальный суточный объём обеих сторон, USDmin_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_sellstringБиржа покупки и биржа продажи
market_buy, market_sellstringРынок стороны: spot или futures
price_buy, price_sellnumberЦены, по которым считается спред
bid_*, ask_*number или nullЛучшие бид и аск каждой стороны
spread_pctnumberСпред, %
network, contractstring; string или nullСеть и адрес контракта токена
deposit_enabled_*, withdraw_enabled_*booleanОткрыты ли ввод и вывод на каждой бирже
volume_24h_buy, volume_24h_sellnumber или nullОбъём за 24 часа, USD
trade_url_buy, trade_url_sellstringСсылки на торговые терминалы

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.

ПараметрТипЧто делаетПример
coinstringФильтр по тикеру монетыcoin=SCR
exchangestringCEX-биржа; несколько — через запятуюexchange=MEXC
min_spreadnumberМинимальный спред, %min_spread=2
min_liquiditynumberМинимальная ликвидность, USDmin_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; минус — наоборот.

ПолеТипЧто содержит
exchangestringCEX-биржа
cex_price, dex_pricenumberЦена на CEX и на DEX
liquidity_usdnumberЛиквидность пула, USD
market_cap, dex_volume_24hnumber или nullКапитализация и объём DEX за 24 часа (DEX – Спот)
ticker, max_position_usdstring; number или nullПара на бирже и максимальная позиция, USD (DEX – Фьючерсы)
deposit_enabled, withdraw_enabledbooleanОткрыты ли ввод и вывод на CEX
dexscreener_url, dextools_url, gmgn_urlstring или 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 — где дороже. Токен между сетями переводят через кроссчейн-мост.

ПараметрТипЧто делаетПример
coinstringФильтр по тикеру токенаcoin=WLD
chainstringФильтр по сетиchain=ethereum
min_spreadnumberМинимальный спред, %min_spread=1
min_liquiditynumberМинимальная ликвидность, USDmin_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.chainstringСеть стороны
buy.pairstringПара на DEX, например WLD/USDC
buy.contractstringАдрес контракта в этой сети
buy.price_usd, buy.liquidity_usd, buy.volume_24h_usdnumberЦена, ликвидность пула и объём за 24 часа, USD
buy.pool_created_atstring или nullДата создания пула
buy.dexscreener_url, dextools_url, gmgn_urlstring или nullСсылки на DexScreener, DEXTools и GMGN

У sell те же поля. pool_created_at — строка с датой в UTC, а не unix-секунды, как большинство времён в API; бывает null. Пул, созданный на днях, — повод сверить контракты обеих сторон: в новой сети под тем же тикером может оказаться другой токен.

Фондовый арбитраж: акции, металлы, индексы, сырьё

GET /arbitrage/stocks отдаёт спреды по токенизированным акциям, металлам, индексам и сырью между CEX-биржами и доступен с тарифа Start.

ПараметрТипЧто делаетПример
symbolstringФильтр по тикеру инструментаsymbol=BRENT
categorystringКатегория: Stock, Metal, Index или Commoditycategory=Commodity
exchangestringФильтр по бирже; несколько — через запятуюexchange=MEXC
min_spreadnumberМинимальный спред, %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-spotDEX – Спот
/arbitrage/dex-futuresDEX – Фьючерсы
/arbitrage/crosschainКроссчейн
/arbitrage/stocksФондовый арбитраж

Как собрать монитор связок

  1. Выберите эндпоинт под тариф

    Сверьтесь с таблицей тарифов выше: DEX-наборы и Кроссчейн есть только на Pro и Max.

  2. Сузьте выборку на сервере

    Задайте min_spread выше суммы комиссий, а min_volume или min_liquidity — чтобы отсечь неликвид.

  3. Отберите исполнимые строки в коде

    Спот – Спот — withdraw_enabled_buy и deposit_enabled_sell. DEX – Спот при плюсовом спреде — deposit_enabled, при минусовом — withdraw_enabled. Акции — ищите по symbol_on_buy и symbol_on_sell.

  4. Проверьте токен и стакан

    Сверьте contract и network, посчитайте исполнение на свою сумму через эндпоинты стаканов.

  5. Опрашивайте с частотой тарифа

    Не чаще meta.freshness_sec. Бот присылает уведомление, сделку вы открываете на бирже сами.

Вопросы и ответы

Можно ли через эти эндпоинты открыть сделку?

Нет. Genesis API только отдаёт данные и ордеров не ставит. Бот на Genesis API находит связку и присылает уведомление, а сделку вы открываете на бирже сами.

Почему в строке нет колонок «Стакан» и «Орд.»?

Они считаются по стаканам и приходят отдельно: «Δ по ордерам» — GET /orderbooks/spreads/{dataset}, стакан рынка — GET /orderbooks/book, оба на тарифах Pro и Max.

Какой тариф нужен для DEX и Кроссчейна?

Pro или Max. На Trial доступны три CEX-набора, на Start к ним добавляется фондовый арбитраж.