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,0004 | 1 100 | 1 100 | 1 099,56 |
| 1,0010 | 1 400 | 1 400 | 1 398,60 |
| 1,0018 | 2 600 | 2 600 | 2 595,33 |
| 1,0030 | 3 000 | 3 000 | 2 991,03 |
| 1,0050 | 6 000 | 1 900 | 1 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,0120 | 1,20 % |
| По лучшим ценам стакана | 1,0004 → 1,0116 | 1,12 % |
| После исполнения $10 000 | 1,0025 → 1,0095 | 0,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.