Эндпоинты стаканов Genesis API: цена исполнения, Δ по ордерам, стакан, история и DEX
Коротко
- Шесть эндпоинтов стаканов на тарифах API Pro и Max отдают те же данные, что сайт показывает в колонке «Δ по ордерам», окне «Стакан» и Genesis Charts.
- Цена исполнения — средняя цена рыночной сделки на $500, $1 000, $2 500, $5 000 или $10 000;
nullзначит, что стакана на этот объём не хватает. - Стаканы отстают от биржи на 5–20 секунд: проверяйте
age_secиstale, а перед сделкой смотрите стакан в терминале биржи.
API стаканов в Genesis API — шесть эндпоинтов, которые показывают, сколько спреда останется в сделке на конкретную сумму. Они отдают цену исполнения на объём, «Δ по ордерам» для строк арбитража, стакан заявок с глубиной, историю проскальзывания и проскальзывание DEX — те же данные, что на сайте в колонке «Δ по ордерам» и Genesis Charts.
Шесть эндпоинтов стаканов
| Эндпоинт | Что возвращает | Обязательно | Документация |
|---|---|---|---|
/orderbooks/exec | Цены покупки и продажи на объём по всем рынкам | volume | Цена исполнения |
/orderbooks/spreads/{dataset} | «Δ по ордерам» для строк одной монеты в наборе арбитража | coin | Δ по ордерам |
/orderbooks/book | Стакан рынка: 10 уровней, стенки, глубина, возраст | exchange, market, coin | Стакан рынка |
/orderbooks/coin/{coin} | Стаканы монеты на всех биржах и рынках | монета в пути | Стаканы монеты |
/orderbooks/exec-history | История проскальзывания, до 8 рынков за запрос | keys, interval | История исполнения |
/orderbooks/dex-slippage | Проскальзывание, налоги и honeypot по контракту | — | Проскальзывание DEX |
Все шесть входят в тарифы API Pro ($100 в месяц) и Max ($200), на Trial и Start они отвечают 403 plan_restricted. В /orderbooks/exec и в параметре keys истории рынок записан ключом Биржа|рынок|МОНЕТА, например Binance|spot|BTC. Примеры ответов ниже — сокращённое содержимое поля data.
Обзор API стаканов — в статье «API биржевых стаканов».
Цена исполнения на объём
Цена исполнения — средняя цена, по которой рыночный ордер на заданную сумму пройдёт по стакану: покупка собирает аски, продажа — биды, то есть VWAP съеденных заявок. /orderbooks/exec отдаёт её по всем рынкам для одного объёма сетки.
| Параметр | Тип | Что делает |
|---|---|---|
volume | number | Объём в USD: 500, 1000, 2500, 5000 или 10000, обязательный |
exchange | string | Фильтр по бирже, несколько — через запятую |
market | string | spot или futures |
coin | string | Тикер монеты, например BTC |
curl "https://api.genesisarbitrage.com/v1/orderbooks/exec?volume=1000" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"volume": 1000,
"markets": {
"Binance|spot|BTC": [96021.5, 96010.2],
"ByBit|futures|BTC": [96030.1, 96018.7],
"Ourbit|spot|SHELL": [0.10418, null],
…
}
}
Значение по ключу рынка — [цена покупки, цена продажи]. null вместо цены — стакана на этот объём не хватает: в примере бидов SHELL на Ourbit не хватит на продажу на $1 000. Без фильтров в ответе все рынки — для одной монеты передавайте coin.
Δ по ордерам: спред после прохода по стакану
«Δ по ордерам» — спред строки арбитража, пересчитанный по стаканам на заданный объём. /orderbooks/spreads/{dataset} берёт все строки одной монеты в выбранном наборе и добавляет к каждой объект order_delta — по тем же формулам, что и колонка на сайте.
| Параметр | Тип | Что делает |
|---|---|---|
{dataset} | string, в пути | spot-spot, spot-futures, futures-futures, dex-spot или dex-futures |
coin | string | Тикер монеты, обязательный |
volume | number | 0 по умолчанию — лучшие цены стакана; или 500, 1000, 2500, 5000, 10000 |
Для CEX-пар покупка идёт по аскам биржи exchange_buy, продажа — в биды биржи exchange_sell. В order_delta приходят buy_price и sell_price, а результат не превышает spread_pct строки.
Для DEX-строк сторону на CEX задаёт знак спреда: при spread_pct ≥ 0 токен продают в биды CEX, при отрицательном — покупают из асков. В order_delta приходят side и cex_price — цена исполнения на CEX; если знак после прохода по стакану меняется, Δ равна 0.
Поле status: ok — посчитано, no_book — стакана нет, exhausted — стакана не хватило на объём.
Условный пример: монета XYZ, покупка на MEXC по 2,000, продажа на Gate по 2,016, спред строки 0,8 %. Запрос «Δ по ордерам» на $5 000:
curl -G \
"https://api.genesisarbitrage.com/v1/orderbooks/spreads/spot-spot" \
-d coin=XYZ -d volume=5000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"coin": "XYZ",
"exchange_buy": "MEXC",
"exchange_sell": "Gate",
"market_buy": "spot",
"market_sell": "spot",
"price_buy": 2.0,
"price_sell": 2.016,
"ask_buy": 2.001,
"bid_sell": 2.015,
"spread_pct": 0.8,
"order_delta": {
"volume": 5000,
"buy_price": 2.004,
"sell_price": 2.01,
"spread_pct": 0.2994,
"status": "ok"
}
}
Остальные поля строки — как в /arbitrage/spot-spot. Спред строки: (2,016 − 2,000) / 2,000 × 100 = 0,8 %.
На $5 000 покупка по стакану MEXC обходится в среднем в 2,004, продажа в стакан Gate даёт 2,010: (2,010 − 2,004) / 2,004 × 100 ≈ 0,2994 %. Из 0,8 % на этом объёме остаётся около 0,3 % — примерно $15 до комиссий и перевода: 5 000 × 0,002994 ≈ 14,97.
Пример на Python: спред до и после стакана
Скрипт печатает спред строки и спред после стакана для BTC в Спот – Спот на $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"]}
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):
# лимит запросов или пересборка данных
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
return r.json()["data"]
raise RuntimeError("API занят, повторите позже")
rows = get("/orderbooks/spreads/spot-spot",
{"coin": "BTC", "volume": 5000})
for row in rows:
od = row["order_delta"]
if od["status"] == "ok":
after = f'{od["spread_pct"]:.4f}%'
else:
after = od["status"] # no_book или exhausted
print(f'{row["exchange_buy"]} → {row["exchange_sell"]}: '
f'{row["spread_pct"]}% → {after}')
В цикле опрашивайте не чаще раза в meta.freshness_sec секунд: 10 с на Pro, 5 с на Max. Квота и лимиты — в инструкции «Лимиты Genesis API».
Стакан рынка и стаканы монеты
/orderbooks/book возвращает стакан одного рынка — как окно «Стакан» на сайте. Рынок задают три обязательных параметра: exchange (регистр не важен), market (spot или futures) и coin. /orderbooks/coin/{coin} отдаёт массив таких же объектов по всем биржам и рынкам монеты.
curl -G "https://api.genesisarbitrage.com/v1/orderbooks/book" \
-d exchange=Binance -d market=spot -d coin=BTC \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"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,
"best_bid": 96015.9,
"best_ask": 96016,
"bids": [[96015.9, 412300.5], [96015.8, 51020.3], …],
"asks": [[96016, 388120.2], [96016.1, 20410.7], …],
"walls_bid": [[95900, 2410000]],
"walls_ask": [[96500, 1980000]],
"depth_bid_usd": 61234567,
"depth_ask_usd": 58765432
}
| Поле | Что значит |
|---|---|
best_bid, best_ask | Лучший бид и аск |
bids, asks | 10 лучших уровней: [цена, сумма в USD] |
walls_bid, walls_ask | Крупнейшие стенки: [цена, сумма в USD] |
depth_bid_usd, depth_ask_usd | Глубина стороны в пределах ±50 % от лучшей цены, USD |
book_ts, age_sec, stale | Время книги и её возраст в секундах; stale — старше 30 с |
source, depth_limited | Источник книги (ws или rest) и признак ограниченной глубины |
Глубина рынка в depth_bid_usd и depth_ask_usd — сколько долларов заявок стоит по одну сторону стакана: в примере до +50 % от лучшего аска BTC на Binance — около $58,8 млн.
При depth_limited: true биржа отдаёт неполный стакан, и крупный объём может не исполниться. Если стакана для этой биржи, рынка и монеты нет, придёт 404.
История исполнения
/orderbooks/exec-history — история проскальзывания из Genesis Charts: сколько стоило исполнение на каждом объёме сетки, в базисных пунктах от середины стакана (1 б. п. = 0,01 %). За запрос — до 8 рынков в keys через запятую, interval обязателен.
interval | Шаг точки | 360 точек покрывают |
|---|---|---|
1m | 1 минута | 6 часов |
15m | 15 минут | 3,75 дня |
1h | 1 час | 15 дней |
1d | 1 день | около года |
Данные собираются с 6 сентября 2026 года: дневной ряд заполнен только с этой даты.
curl -G "https://api.genesisarbitrage.com/v1/orderbooks/exec-history" \
--data-urlencode "keys=Binance|spot|BTC,ByBit|futures|BTC" \
-d interval=1h \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"interval": "1h",
"step_sec": 3600,
"points": 360,
"volumes_usd": [500, 1000, 2500, 5000, 10000],
"last_bucket_ts": 1794672000,
"series": {
"Binance|spot|BTC": {
"buy": [[1, 1, 2, …], [1, 2, 2, …], [2, 3, 4, …],
[3, 4, 6, …], [5, 7, 9, …]],
"sell": [[-1, -1, -2, …], …]
},
"ByBit|futures|BTC": { … }
}
}
В buy и sell — по пять рядов, по одному на объём из volumes_usd, в каждом 360 значений от старых к новым. Последняя точка относится к last_bucket_ts, точка i — к моменту last_bucket_ts − (points − 1 − i) × step_sec. У покупки значения положительные, у продажи отрицательные: средняя цена сделки выше и ниже середины стакана.
Ряд [5, 7, 9, …] — покупка на $10 000: в первых точках 5–9 б. п., то есть 0,05–0,09 % сверх середины. null в ряду — нет данных или стакана не хватило, null вместо рынка — ключ неизвестен.
Проскальзывание DEX
/orderbooks/dex-slippage описывает DEX-ногу связки: проскальзывание покупки и продажи на объёмах от $100 до $100 000, налоги токена и признак honeypot по контракту — как колонки DEX-таблиц сайта. Фильтры: contract (несколько — через запятую) и network.
curl -G "https://api.genesisarbitrage.com/v1/orderbooks/dex-slippage" \
-d contract=0x6982508145454ce325ddbe47a25d4ec3d2311933 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"sizes_usd": [100, 500, 1000, 2500, 5000, 10000, 20000, 50000,
100000],
"contracts": [
{
"contract": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"network": "ETH",
"tax_buy_pct": 0,
"tax_sell_pct": 0,
"honeypot": "no",
"slippage_buy_pct": [0.31, 0.33, 0.36, 0.44, 0.58, 0.86,
1.41, 3.12, 6.05],
"slippage_sell_pct": [0.31, 0.34, 0.37, 0.46, 0.61, 0.9,
1.5, 3.3, 6.4],
"updated_at": 1794671040
}
]
}
Массивы проскальзывания идут по сетке sizes_usd: в примере покупка на $5 000 даёт проскальзывание 0,58 %, на $100 000 — 6,05 %. null в массиве — пулу не хватает ликвидности на этот объём.
tax_buy_pct и tax_sell_pct — налог токена на покупку и продажу, %; null значит, что источника нет, это не 0 %. honeypot: no — нет, suspect — источники расходятся, yes — продать токен может быть нельзя.
Как проверить связку по стакану
Возьмите строку арбитража
Найдите связку в
/arbitrage/spot-spotили другом наборе — см. «Эндпоинты арбитража». Запишите монету, биржи иspread_pct.Пересчитайте спред по стакану
Запросите
/orderbooks/spreads/spot-spotс этой монетой и объёмом сделки и сравнитеspread_pctсorder_delta.spread_pct.Проверьте свежесть и глубину
Вызовите
/orderbooks/bookдля обеих ног:age_sec,staleиdepth_limitedпокажут, можно ли доверять цифрам, а стенки — где может остановиться цена.Сравните с историей
/orderbooks/exec-historyпокажет, обычное ли это проскальзывание для рынка:1m— за 6 часов,1h— за 15 дней.Для DEX-ноги проверьте налоги
В связках DEX – Спот и DEX – Фьючерсы запросите
/orderbooks/dex-slippageпо контракту строки: проскальзывание, налоги иhoneypot.
Вопросы и ответы
Чем «Δ по ордерам» отличается от обычного спреда?
spread_pct строки считается по последним ценам бирж, «Δ по ордерам» — по средним ценам рыночных сделок на заданный объём. Разница между ними — то, что съедает стакан.
Почему вместо цены приходит null?
В /orderbooks/exec заявок не хватает на этот объём, в «Δ по ордерам» это статус exhausted. В истории исполнения null — нет данных за точку, в проскальзывании DEX — пулу не хватает ликвидности.
Можно ли посчитать исполнение больше $10 000?
Сетка /orderbooks/exec и «Δ по ордерам» — от $500 до $10 000. Для крупных сумм смотрите глубину и стенки в /orderbooks/book, для DEX-ноги — /orderbooks/dex-slippage с объёмами до $100 000.