Genesis Arbitrage

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

API биржевого стакана: глубина, цена исполнения и проскальзывание по биржам

Коротко

  • API стакана отдаёт уровни заявок — цену и объём на каждом — снимком по REST или потоком изменений по WebSocket. Лучший бид и аск описывают только первые доллары сделки.
  • Цену крупного ордера задаёт глубина. В условном примере покупка на $10 000 проходит пять уровней, средняя цена уходит на 25 базисных пунктов от середины стакана, и спред между биржами сжимается с 1,20 % до 0,70 %.
  • Genesis API на тарифах Pro и Max отдаёт готовые цены исполнения на $500–10 000, «Δ по ордерам» для связок, возраст и глубину книг, историю проскальзывания и лестницу проскальзывания DEX. Только REST, книги отстают от биржи на 5–20 секунд.

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

Биржа отдаёт свой стакан снимком по REST или потоком по WebSocket, а Genesis API на тарифах Pro и Max — уже посчитанные цены исполнения, глубину и «Δ по ордерам» по многим биржам сразу.

Что отдаёт API стакана

Стакан заявок — список лимитных заявок по одной паре. Заявки на покупку (биды) идут от высокой цены к низкой, на продажу (аски) — от низкой к высокой. Уровень — одна цена и сумма заявок на ней, а разница между лучшим аском и лучшим бидом — спред стакана.

Снимок по REST — ответ на один запрос с уровнями на этот момент. Эндпоинт стакана у Binance публичный, ключ для него не нужен; запрос пяти лучших уровней BTC/USDT и ответ (числа условные):

curl "https://api.binance.com/api/v3/depth?symbol=BTCUSDT&limit=5"
{
  "lastUpdateId": 81273645120,
  "bids": [["96015.90000000", "1.25000000"], …],
  "asks": [["96016.00000000", "0.84100000"], …]
}

Уровень приходит парой строк [цена, количество], количество — в монетах: на лучшем биде 1,25 × 96 015,9 = $120 019,88. Параметр limit по умолчанию равен 100, максимум — 5000 уровней с каждой стороны (документация Binance).

Поток по WebSocket биржа присылает сама по постоянному соединению. Потоков стакана у Binance два вида: btcusdt@depth5, btcusdt@depth10 и btcusdt@depth20 присылают 5, 10 или 20 лучших уровней, btcusdt@depth — только изменения. Обновляются они раз в 1000 мс или, с суффиксом @100ms, раз в 100 мс (потоки WebSocket Binance).

Полный стакан в памяти собирают из снимка и потока изменений, сверяя lastUpdateId снимка с номерами событий; при пропуске события стакан собирают заново.

СпособЧто приходитДля чего
Снимок по RESTУровни на момент запроса, у Binance до 5000 на сторонуРазовая проверка, редкий опрос
Поток по WebSocketЛучшие уровни или изменения раз в 100–1000 мсСвой стакан в памяти, торговый бот
Расчёты Genesis API по RESTУровни [цена, сумма в USD], цена исполнения, глубина и возраст книгиСравнение бирж, проверка связки

Почему лучший бид и аск обманывают на объёме

Лучший аск — цена только первого уровня. Рыночная покупка больше этого уровня забирает следующие, более дорогие, и средняя цена сделки уходит вверх — это проскальзывание.

Условный пример: монета ABC на бирже A, лучший бид 0,9996, лучший аск 1,0004, середина стакана 1,0000. Рыночная покупка на $10 000 проходит пять уровней асков:

Цена аскаВ стакане, $Берём, $Монет
1,00041 1001 1001 099,56
1,00101 4001 4001 398,60
1,00182 6002 6002 595,33
1,00303 0003 0002 991,03
1,00506 0001 9001 890,55

Всего куплено 9 975,07 монеты. Средняя цена сделки — VWAP, цена, взвешенная по объёму: 10 000 / 9 975,07 ≈ 1,0025.

Проскальзывание от лучшего аска: (1,0025 − 1,0004) / 1,0004 × 100 ≈ 0,21 %. От середины стакана: (1,0025 − 1,0000) / 1,0000 × 10 000 = 25 базисных пунктов. Четыре из них — половина спреда стакана, её платит любая рыночная покупка, остальные 21 добавила глубина.

Глубина рынка в пределах ±X % и стенки

Глубина рынка — сумма заявок на заданном расстоянии от лучшей цены. В примере аски в пределах +0,2 % от лучшего, то есть до 1,0024, дают 1 100 + 1 400 + 2 600 = $5 100, а в пределах +0,5 %, до 1,0054, — $14 100.

Глубина работает как вместимость: ордер больше глубины в пределах +0,2 % дойдёт до уровней за этой границей. На бирже A покупка на $5 000 в неё помещается, на $10 000 — уже нет.

Стенка — крупная заявка на одном уровне, заметно больше соседних: в примере $6 000 на 1,0050. Пока стенка стоит, она держит цену, но её могут снять за секунду до того, как до неё дойдёт ваш ордер, и тогда покупка уйдёт на следующие уровни.

В Genesis API глубину отдают /orderbooks/book — стакан одного рынка — и /orderbooks/coin/{coin} — стаканы монеты на всех биржах и рынках сразу (стакан рынка, стаканы монеты). В ответе 10 лучших уровней bids и asks в виде [цена, сумма в USD], крупнейшие стенки walls_bid и walls_ask и вся глубина стороны в пределах ±50 % от лучшей цены — depth_bid_usd и depth_ask_usd. Коридор ±50 % широкий, поэтому для конкретной суммы смотрите уровни или готовую цену исполнения.

Возраст стакана: устаревание и ограниченная глубина

У каждого снимка стакана есть возраст. Если книга одной биржи старше другой на 15 секунд, часть спреда между ними может оказаться разницей во времени: цена на старой книге уже ушла.

В Genesis API книги отстают от биржи на 5–20 секунд, и возраст указан у каждой. Начало ответа /orderbooks/book из документации:

{
  "exchange": "Binance",
  "market": "spot",
  "coin": "BTC",
  "book_ts": 1794675858,
  "age_sec": 6,
  "stale": false,
  "source": "ws",
  "depth_limited": false,
  "levels_bid": 500,
  "levels_ask": 500,
  …
}

book_ts — время книги в unix-секундах, age_sec — её возраст в секундах, stale: true — книга старше 30 секунд. source показывает, как книга получена с биржи: по WebSocket (ws) или запросами REST (rest).

depth_limited: true значит, что биржа отдаёт ограниченную глубину: суммы в книге неполные, и на крупный объём стакана может не хватить. Когда заявок мало, /orderbooks/exec возвращает null вместо цены, а «Δ по ордерам» — статус exhausted.

Исполнимый спред между биржами: Δ по ордерам

Продолжим условный пример. На бирже B последняя сделка прошла по 1,0120, лучший бид — 1,0116, аск — 1,0124. В бидах B стоят $1 100 по 1,0116, $1 300 по 1,0110, $2 800 по 1,0102, $2 900 по 1,0090 и $5 000 по 1,0070.

Продажа на $10 000 в эти биды по той же формуле даёт VWAP 1,0095. До середины стакана B это (1,0120 − 1,0095) / 1,0120 × 10 000 ≈ 24,7 базисного пункта.

Как считать спредПокупка на A → продажа на BСпред
По последним сделкам, как в строке таблицы1,0000 → 1,01201,20 %
По лучшим ценам стакана1,0004 → 1,01161,12 %
После исполнения $10 0001,0025 → 1,00950,70 %

Спред строки: (1,0120 − 1,0000) / 1,0000 × 100 = 1,20 %. После исполнения: (1,0095 − 1,0025) / 1,0025 × 100 ≈ 0,70 %. Строка обещает $120 на $10 000, по стаканам остаётся около $70: 10 000 × 0,006983 ≈ 69,83.

Из потерянных 50 базисных пунктов 8 съела разница между последней сделкой и лучшими заявками, остальные 42 — глубина двух стаканов.

«Δ по ордерам» — так Genesis Arbitrage называет спред строки, пересчитанный по стаканам на заданную сумму; на сайте это колонка таблиц арбитража, например Спот – Фьючерсы. В API его отдаёт /orderbooks/spreads/{dataset}: к каждой строке одной монеты в наборе spot-spot, spot-futures, futures-futures, dex-spot или dex-futures добавляется объект order_delta (Δ по ордерам).

В order_delta приходят buy_price и sell_price на выбранный объём, spread_pct после исполнения и status: ok, no_book — книги нет, exhausted — стакана не хватило. Объём volume — 0 (лучшие цены стакана) или 500, 1000, 2500, 5000, 10000; результат не бывает выше спреда строки. У DEX-строк вместо пары цен приходят side и cex_price — сторона и цена на CEX.

Сами цены исполнения по всем рынкам отдаёт /orderbooks/exec: пара [цена покупки, цена продажи] по ключу вида Binance|spot|BTC, null — стакана не хватает (цена исполнения).

Связка целиком, с переводом монеты и проверкой сетей, — в статье «Межбиржевой арбитраж криптовалют».

Пример на Python: спред строки и спред после исполнения

Скрипт берёт связки Спот – Спот со спредом от 0,5 %, для десяти монет с наибольшим спредом запрашивает «Δ по ордерам» на $5 000 и печатает, сколько базисных пунктов съел стакан. Ключ — из переменной окружения GENESIS_API_KEY. При 429 и 503 скрипт ждёт Retry-After секунд, а если ждать больше минуты — кончилась месячная квота, — останавливается.

import os
import time
import requests

BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
VOLUME = 5000      # долларов на каждую ногу
MIN_SPREAD = 0.5   # спред строки, %


def get(path, params):
    for _ in range(3):
        r = requests.get(BASE + path, headers=HEADERS,
                         params=params, timeout=15)
        if r.status_code in (429, 503):
            wait = int(r.headers.get("Retry-After", "5"))
            if wait > 60:  # кончилась месячная квота
                break
            time.sleep(wait)
            continue
        r.raise_for_status()
        return r.json()["data"]
    raise RuntimeError("API не ответил, повторите позже")


rows = get("/arbitrage/spot-spot", {"min_spread": MIN_SPREAD})
rows.sort(key=lambda x: x["spread_pct"], reverse=True)
coins = list(dict.fromkeys(x["coin"] for x in rows))[:10]

for coin in coins:
    data = get("/orderbooks/spreads/spot-spot",
               {"coin": coin, "volume": VOLUME})
    for row in data:
        od = row["order_delta"]
        if row["spread_pct"] < MIN_SPREAD or od["status"] != "ok":
            continue  # no_book или exhausted: объём не исполнить
        lost = (row["spread_pct"] - od["spread_pct"]) * 100
        print(f'{coin} {row["exchange_buy"]}→{row["exchange_sell"]}'
              f' {row["spread_pct"]:.2f}% → {od["spread_pct"]:.2f}%,'
              f' стакан съел {lost:.0f} б. п.')
    time.sleep(0.25)  # до 4 запросов в секунду: лимит Pro — 5

Скрипт делает до 11 вызовов с паузой 0,25 с между монетами. По кругу его запускают не чаще meta.freshness_sec: 10 с на Pro и 5 с на Max (лимиты Genesis API). Как добавить к нему уведомления — в статье «Бот для арбитража криптовалют на Python».

История стоимости исполнения

Один снимок не показывает, обычное это проскальзывание для рынка или стакан сейчас тоньше. /orderbooks/exec-history отдаёт историю из Genesis Charts: сколько базисных пунктов от середины стакана стоило исполнение на $500, 1 000, 2 500, 5 000 и 10 000, отдельно для покупки и продажи (история исполнения).

На интервал приходится 360 точек: 1m покрывает 6 часов, 15m — 3,75 дня, 1h — 15 дней, 1d — около года, данные собираются с 6 сентября 2026 года. За запрос — до 8 рынков в параметре keys. У покупки значения положительные, у продажи — отрицательные, null — нет данных или стакана не хватило. Снимков самого стакана за прошлые дни в Genesis API нет.

import os
import statistics
import requests

KEY = "Binance|spot|BTC"
r = requests.get(
    "https://api.genesisarbitrage.com/v1/orderbooks/exec-history",
    headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
    params={"keys": KEY, "interval": "1h"},  # 360 часов, 15 дней
    timeout=15,
)
r.raise_for_status()
data = r.json()["data"]
series = data["series"][KEY]
if series is None:
    raise SystemExit("рынок не найден: " + KEY)
i = data["volumes_usd"].index(10000)  # ряд покупки на $10 000
buy = series["buy"][i]
known = [x for x in buy if x is not None]
if not known:
    raise SystemExit("нет данных за период")
print("медиана за 15 дней, б. п.:", statistics.median(known))
print("последняя точка, б. п.:", buy[-1])

Условно: если медиана за 15 дней — 12 базисных пунктов, а последняя точка — 25, исполнение сейчас вдвое дороже обычного, и порог спреда для этой монеты разумно поднять.

DEX: лестница проскальзывания, налоги и honeypot

У пула DEX стакана нет: цену обмена задаёт формула пула, и чем больше сделка относительно ликвидности, тем сильнее сдвиг. Поэтому DEX-ногу оценивают лестницей — проскальзыванием на ряде объёмов.

/orderbooks/dex-slippage отдаёт по контракту проскальзывание покупки и продажи на $100, 500, 1 000, 2 500, 5 000, 10 000, 20 000, 50 000 и 100 000, налоги токена и признак honeypot — как колонки DEX-таблиц сайта (проскальзывание DEX). В примере ответа из документации проскальзывание покупки на $10 000 — 0,86 %, на $50 000 — 3,12 %, на $100 000 — 6,05 %.

Отсюда предел связки: спред DEX – CEX в 2 % на $10 000 переживает проскальзывание пула, на $50 000 — уже нет, даже без комиссий. null в лестнице — ликвидности пула на этот объём не хватает, а газа сети в ответе нет: его закладывают отдельно.

tax_buy_pct и tax_sell_pct — налог токена на покупку и продажу, %; null значит, что источника нет, и считать его нулём нельзя. honeypot: no — признаков нет, suspect — источники расходятся, yes — продать токен может быть нельзя.

Ручная проверка токена — в статье «Как проверить токен перед покупкой», цены и ликвидность DEX рядом с CEX — в статье «DEX API».

Стаканы в Genesis API: эндпоинты и тарифы

ЗадачаЭндпоинт
Цена исполнения на $500–10 000 по всем рынкам/orderbooks/exec
Спред строки после исполнения/orderbooks/spreads/{dataset}
10 уровней, стенки, глубина и возраст книги/orderbooks/book
Стаканы монеты на всех биржах/orderbooks/coin/{coin}
История стоимости исполнения/orderbooks/exec-history
Проскальзывание, налоги и honeypot на DEX/orderbooks/dex-slippage

Все шесть входят в тарифы API Pro и Max. Pro стоит $100 в месяц: 5 млн вызовов, 5 запросов в секунду, свежесть 10 с. Max — $200: 10 млн вызовов, 15 запросов в секунду, 5 с; на Trial и Start эндпоинты стаканов отвечают 403 plan_restricted.

Параметры и примеры ответов — в инструкции «Эндпоинты стаканов», обзор данных API — в статье «API криптовалют» и уроке «Данные API для арбитража».

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

Почему спред в таблице больше, чем получается в сделке?

Спред строки считают по последним сделкам, а рыночный ордер проходит по заявкам стакана, и чем больше сумма, тем дальше его средняя цена от лучшей. Сверху вычитаются комиссии и движение цены за время перевода. Сколько спреда остаётся на вашу сумму, показывает «Δ по ордерам».

Как часто обновляются стаканы?

Стакан меняется с каждой заявкой и отменой, поток Binance присылает изменения раз в 100 или 1000 мс. В Genesis API книги отстают от биржи на 5–20 секунд (возраст — в age_sec), а отдача обновляется раз в 10 секунд на Pro и раз в 5 секунд на Max.

Есть ли у Genesis API WebSocket для стаканов?

Нет. Genesis API работает по REST: запрос HTTP GET, ответ в JSON. Поток изменений стакана в реальном времени дают WebSocket самих бирж — он и нужен боту, который ставит ордера через торговый API биржи.

Есть ли бесплатный API стакана?

У бирж есть публичные эндпоинты: стакан Binance /api/v3/depth отвечает без ключа, но по одной бирже, и цену исполнения вы считаете сами. Бесплатного тарифа у Genesis API нет, стаканы входят в Pro за $100 в месяц и Max за $200.