Genesis Arbitrage

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

Данные API для арбитража: спреды, стаканы и фандинг

Коротко

  • На каждый вопрос трейдера отвечает свой эндпоинт: разницу цен — spread_pct в /arbitrage/*, перевод монеты — флаги ввода и вывода, network и contract, исполнение на сумму — /orderbooks/*, выгоду фандинга — /funding/*.
  • Спред строки считается по последним сделкам. В условном примере 1,5 % на $2 500 после прохода по стаканам превращаются в 0,72 %, а после двух комиссий тейкера по 0,1 % — примерно в 0,52 %, около $13.
  • Время данных есть в каждом ответе: meta.updated_at — когда собран снимок, meta.freshness_sec — шаг обновления на тарифе, age_sec и stale — возраст стакана.
  • Связку проверяют по четырём пунктам: разница цен, перевод, стакан и свежесть. Провал любого пункта отменяет вход.
  • CEX-арбитраж, фандинг и открытый интерес есть на всех тарифах Genesis API, ончейн-разделы — с Start, стаканы и DEX — на Pro и Max.

Данные для арбитража криптовалют — ответы на пять вопросов: есть ли разница цен, можно ли перевести монету, хватит ли стакана на вашу сумму, выгоден ли фандинг и что делают крупные игроки. В Genesis API на каждый вопрос отвечает свой эндпоинт и несколько полей ответа. Первый запрос и конверт success, data, meta разобраны в уроке 2, здесь — какие поля смотреть и в каком порядке.

Вопрос трейдера → эндпоинт → поля

ВопросЭндпоинтПоля
Есть ли разница цен/arbitrage/*spread_pct, price_buy, price_sell
Можно ли перевести монетута же строка /arbitrage/spot-spotwithdraw_enabled_buy, deposit_enabled_sell, network, contract
Хватит ли стакана/orderbooks/*order_delta.spread_pct, order_delta.status
Выгоден ли фандинг/funding/*spread_pct, interval_1, interval_2, next_payout_1
Что делают крупные игроки/onchain/*, /market/open-interestdirection, total_usd, oi_change_1h

Звёздочка обозначает группу: в /arbitrage/* семь эндпоинтов, от Спот – Спот до акций, в /orderbooks/* и /funding/* — по шесть. Разделы ниже идут в порядке проверки связки.

Есть ли разница цен: spread_pct

Строка из документации Спот — Спот: FUEL, покупка на ByBit по 0,0007029, продажа на Gate по 0,0007037, spread_pct 0,11. Проверка: (0,0007037 − 0,0007029) / 0,0007029 × 100 ≈ 0,11 %. Спред строки считается по price_buy и price_sell — ценам последних сделок, на сайте это колонка «Цена».

В наборах DEX – Спот и DEX – Фьючерсы важен знак: плюс — токен дешевле на DEX, минус — дороже. Параметры и поля всех семи наборов — в инструкции «Эндпоинты арбитража».

spread_pct отвечает только на первый вопрос: комиссий, перевода и стакана в нём нет.

Можно ли перевести монету: ввод, вывод, сеть и контракт

Межбиржевая связка на споте требует перевода: монету покупают на одной бирже, выводят и зачисляют на другой. Поэтому в строке смотрят два флага: withdraw_enabled_buy — открыт ли вывод на бирже покупки, и deposit_enabled_sell — открыт ли ввод на бирже продажи. Параметров для них в запросе нет, строки отбирает код.

network и contract отвечают на вопрос, тот ли это токен. Под одним тикером на разных биржах торгуются разные монеты, поэтому адрес контракта сверяют со страницами вывода и пополнения обеих бирж. Контракты монеты по сетям и биржи, которые их используют, отдаёт /coins/search на любом тарифе (поиск монет).

В DEX-наборах флаги относятся к стороне CEX: deposit_enabled и withdraw_enabled. В Кроссчейне токен переводят мостом между сетями buy.chain и sell.chain, флагов бирж там нет.

Хватит ли стакана: спред строки и спред после исполнения

Рыночный ордер проходит по стакану заявок: покупка забирает аски от лучшего вверх, продажа — биды от лучшего вниз. Чем больше сумма, тем хуже средняя цена и тем меньше остаётся от спреда строки. Остаток на вашу сумму отдаёт «Δ по ордерам» — /orderbooks/spreads/{dataset} на тарифах Pro и Max (документация).

Условный пример: монета LMN, покупка на OKX по 0,4000, продажа на Bitget по 0,4060. Спред строки: (0,4060 − 0,4000) / 0,4000 × 100 = 1,5 %. Запрос /orderbooks/spreads/spot-spot с coin=LMN и разными volume:

ОбъёмПокупка → продажаΔ по ордерамНа сумму
00,4002 → 0,40581,3993 %—
$5000,4004 → 0,40551,2737 %$6,37
$2 5000,4012 → 0,40410,7228 %$18,07
$10 000—exhausted—

volume=0 считает по лучшему аску OKX и лучшему биду Bitget: лучшие заявки хуже последних сделок, и 0,1 п. п. теряются уже на минимальной сумме. На $2 500 средняя цена покупки — 0,4012, продажи — 0,4041: (0,4041 − 0,4012) / 0,4012 × 100 ≈ 0,7228 %. На $10 000 бидов Bitget не хватило, и order_delta.status равен exhausted.

Комиссию тейкера берёт каждая биржа, в примере — условные 0,1 % (мейкер и тейкер). На $2 500 остаётся 0,7228 − 2 × 0,1 = 0,5228 %, или 2 500 × 0,5228 / 100 ≈ $13,07. Комиссии вывода монеты в ответах нет: её смотрят на странице вывода биржи и вычитают отдельно.

На Trial и Start эндпоинты стаканов отвечают 403 plan_restricted, и стакан смотрят в терминале биржи. Цена исполнения и проскальзывание разобраны в статье «API биржевых стаканов», все шесть эндпоинтов — в инструкции «Эндпоинты стаканов».

Выгоден ли фандинг: спред, интервалы и выплаты

Арбитраж фандинга — шорт там, где ставка финансирования выше, и лонг там, где ниже: движение цены почти не меняет результат, а разница ставок начисляется. Кандидатов отдаёт /funding/spread на любом тарифе: лучшая пара бирж в best и её spread_pct (спред фандинга).

Спред пары не говорит, когда и как часто платят. interval_1 и interval_2 — интервалы начисления двух бирж, next_payout_1 и next_payout_2 — время ближайших выплат в UTC: фандинг получает только позиция, открытая в момент начисления. Ставки с разными интервалами сравнивают после приведения к 8 часам — это поле funding_8h_pct в /funding/rates.

Условный пример: спред 0,03 % за 8 часов, позиция $5 000 на каждой ноге. Начисление приносит 5 000 × 0,03 / 100 = $1,5. Четыре сделки — открыть и закрыть обе ноги — при комиссии тейкера 0,1 % стоят 4 × 5 000 × 0,1 / 100 = $20. Комиссии окупятся за 20 / 1,5 ≈ 13,3 начисления: это 14 начислений по 8 часов, почти пять суток, если ставки не изменятся.

Держится ли разница, показывает история: на Pro и Max /funding/analytics/summary с coin отдаёт по каждой бирже sum — накопленный фандинг, cov — покрытие и flips — смены знака за период. Подробно — в статье «API ставок фандинга» и инструкции «Эндпоинты фандинга».

Что делают крупные игроки: ончейн и открытый интерес

Ончейн-данные и открытый интерес объясняют, почему связка может закрыться раньше, чем вы её исполните. Поток монеты на биржу продажи — продавцы, которые придут раньше вашего перевода. Рост открытого интереса — новые позиции с плечом, и резкое движение против них запускает ликвидации.

Что видноЗапросПоляТарифы
Потоки монеты на биржи и с бирж/onchain/coin-trafficdirection, target, total_usdStart, Pro, Max
Разлоки токенов/onchain/unlocksunlock_value_usd, hours_leftStart, Pro, Max
Открытый интерес по биржам/market/open-interestoi_usd, oi_change_1h, price_change_1hВсе

В примере ответа из документации Genesis Onchain — 18 переводов LAB на Gate на $573 796,98 за 5,69 часа, direction равен deposit. Если в этот момент у LAB есть связка с продажей на Gate, такой поток — повод уменьшить сумму или пропустить вход. Подробно — в статьях «API ончейн-данных» и «API открытого интереса».

Свежесть и время данных

Каждый ответ несёт время: meta.updated_at — unix-время сборки снимка, meta.freshness_sec — шаг обновления на вашем тарифе: 60 секунд на Trial, 30 на Start, 10 на Pro и 5 на Max. Возраст снимка — текущее время минус updated_at (свежесть данных).

Условный пример: тариф Trial, ответ пришёл в 1783802455, updated_at — 1783802410. Снимку 1783802455 − 1783802410 = 45 секунд: связки в нём посчитаны по ценам почти минутной давности, и часть из них на биржах могла уже закрыться.

У стаканов своё время: в /orderbooks/book и /orderbooks/coin/{coin} у каждой книги есть book_ts, age_sec — возраст в секундах — и stale: true, если книга старше 30 секунд. Книги отстают от биржи на 5–20 секунд, поэтому смотрят возраст обеих ног: разница цен свежей и старой книги бывает разницей во времени.

Почему одно поле не решает: проверка по четырём пунктам

Каждое поле закрывает один вопрос, а входить можно, когда закрыты все. Спред 3 % при закрытом выводе — монета застрянет на бирже покупки. При exhausted сумма не исполнится. Снимку 50 секунд — связки уже может не быть.

ПунктПоляСвязка не проходит, если
1. Разница ценspread_pctспред минус две комиссии ниже порога
2. Переводwithdraw_enabled_buy, deposit_enabled_sell, contractвывод или ввод закрыт, контракт не совпал
3. Стаканorder_delta.status, order_delta.spread_pctстатус не ok или остаток ниже порога
4. Свежестьmeta.updated_at, age_sec, staleснимок или книга старше порога

Функция принимает строку data из /arbitrage/spot-spot, объект order_delta той же пары бирж (None на Trial и Start) и meta ответа. Пороги условные: подберите их под свои комиссии и тариф.

import time

FEE = 0.1      # условная комиссия тейкера на ногу, %
MIN_NET = 0.3  # остаток после комиссий — не меньше 0,3 %
MAX_AGE = 60   # снимок — не старше 60 секунд


def check(row, od, meta):
    """Пункты, которые не прошла связка Спот – Спот."""
    fails = []
    if row["spread_pct"] - 2 * FEE < MIN_NET:
        fails.append("1: спред не покрывает комиссии")
    if not row["withdraw_enabled_buy"]:
        fails.append("2: вывод на бирже покупки закрыт")
    if not row["deposit_enabled_sell"]:
        fails.append("2: ввод на бирже продажи закрыт")
    if od is None:
        fails.append("3: стакан не проверен (Trial или Start)")
    elif od["status"] != "ok":
        fails.append("3: стакан — " + od["status"])
    elif od["spread_pct"] - 2 * FEE < MIN_NET:
        fails.append("3: после стакана остаток ниже порога")
    if time.time() - meta["updated_at"] > MAX_AGE:
        fails.append("4: снимок старше MAX_AGE секунд")
    return fails

Пустой список значит, что связка прошла все четыре пункта. Связка LMN на $2 500 проходит: по строке 1,5 − 0,2 = 1,3 %, по стакану 0,7228 − 0,2 = 0,5228 %, снимку 45 секунд. На $10 000 функция вернёт «3: стакан — exhausted». Контракт код не сверит: адрес на страницах вывода и пополнения бирж проверяете вы, а возраст книг обеих ног берут из /orderbooks/book.

Та же проверка по таблице сайта, без кода, — в уроке «Спред, глубина, объём — как читать таблицу», опрос API по кругу — в уроке 4.

Какие данные на каком тарифе

ТарифСвежестьДанные для арбитража
Trial, $20 в месяц60 сСпот – Спот, Спот – Фьючерсы, Фьючерсы – Фьючерсы, ставки и спред фандинга, открытый интерес, Fair – Last, пампы, поиск монет
Start, $5030 сВсё из Trial, а также акции, ончейн-разделы /onchain/{section}, арбитраж прогнозов в режимах exact и dutch
Pro, $10010 сВсе эндпоинты: стаканы и «Δ по ордерам», DEX – Спот, DEX – Фьючерсы, Кроссчейн, аналитика фандинга
Max, $2005 сТе же эндпоинты, что на Pro, и 15 запросов в секунду

Эндпоинт вне тарифа отвечает 403 plan_restricted, квоту такой ответ не тратит. Квоты вызовов и лимиты запросов в секунду — на странице «Тарифы Genesis API».

Попробуйте

  1. Возьмите связку

    В документации Спот — Спот откройте форму «Проверить запрос», вставьте ключ и выберите строку со спредом от 1 %.

  2. Пройдите пункты 1 и 2

    Вычтите из spread_pct две условные комиссии по 0,1 %, проверьте withdraw_enabled_buy и deposit_enabled_sell. Сверьте contract с ответом /coins/search по этой монете.

  3. Пройдите пункт 3

    На Pro или Max запросите /orderbooks/spreads/spot-spot с этой монетой и volume=1000 и найдите строку с той же парой бирж. На Trial и Start откройте стакан в терминале биржи.

  4. Пройдите пункт 4

    Вычтите meta.updated_at из текущего unix-времени: в терминале его печатает date +%s.

  5. Запишите вердикт

    Какой пункт отсеял бы связку первым и сколько осталось бы от спреда на $1 000.

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

Какие данные нужны для арбитража криптовалют?

Цены монеты на разных биржах и спред между ними, статусы ввода и вывода с сетью и контрактом, стаканы для расчёта исполнения на вашу сумму и время снимка. Для арбитража фандинга добавляются ставки, интервалы и время выплат. В Genesis API это /arbitrage/*, /orderbooks/* и /funding/*.

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

Нет. Genesis API только читает данные и ордеров не ставит: сделки вы открываете сами на биржах.