Данные 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-spot | withdraw_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-interest | direction, 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:
| Объём | Покупка → продажа | Δ по ордерам | На сумму |
|---|---|---|---|
0 | 0,4002 → 0,4058 | 1,3993 % | — |
| $500 | 0,4004 → 0,4055 | 1,2737 % | $6,37 |
| $2 500 | 0,4012 → 0,4041 | 0,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-traffic | direction, target, total_usd | Start, Pro, Max |
| Разлоки токенов | /onchain/unlocks | unlock_value_usd, hours_left | Start, Pro, Max |
| Открытый интерес по биржам | /market/open-interest | oi_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, $50 | 30 с | Всё из Trial, а также акции, ончейн-разделы /onchain/{section}, арбитраж прогнозов в режимах exact и dutch |
| Pro, $100 | 10 с | Все эндпоинты: стаканы и «Δ по ордерам», DEX – Спот, DEX – Фьючерсы, Кроссчейн, аналитика фандинга |
| Max, $200 | 5 с | Те же эндпоинты, что на Pro, и 15 запросов в секунду |
Эндпоинт вне тарифа отвечает 403 plan_restricted, квоту такой ответ не тратит. Квоты вызовов и лимиты запросов в секунду — на странице «Тарифы Genesis API».
Попробуйте
Возьмите связку
В документации Спот — Спот откройте форму «Проверить запрос», вставьте ключ и выберите строку со спредом от 1 %.
Пройдите пункты 1 и 2
Вычтите из
spread_pctдве условные комиссии по 0,1 %, проверьтеwithdraw_enabled_buyиdeposit_enabled_sell. Сверьтеcontractс ответом/coins/searchпо этой монете.Пройдите пункт 3
На Pro или Max запросите
/orderbooks/spreads/spot-spotс этой монетой иvolume=1000и найдите строку с той же парой бирж. На Trial и Start откройте стакан в терминале биржи.Пройдите пункт 4
Вычтите
meta.updated_atиз текущего unix-времени: в терминале его печатаетdate +%s.Запишите вердикт
Какой пункт отсеял бы связку первым и сколько осталось бы от спреда на $1 000.
Вопросы и ответы
Какие данные нужны для арбитража криптовалют?
Цены монеты на разных биржах и спред между ними, статусы ввода и вывода с сетью и контрактом, стаканы для расчёта исполнения на вашу сумму и время снимка. Для арбитража фандинга добавляются ставки, интервалы и время выплат. В Genesis API это /arbitrage/*, /orderbooks/* и /funding/*.
Можно ли через Genesis API открыть сделку?
Нет. Genesis API только читает данные и ордеров не ставит: сделки вы открываете сами на биржах.