Genesis Arbitrage

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

Эндпоинты стаканов 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 отдаёт её по всем рынкам для одного объёма сетки.

ПараметрТипЧто делает
volumenumberОбъём в USD: 500, 1000, 2500, 5000 или 10000, обязательный
exchangestringФильтр по бирже, несколько — через запятую
marketstringspot или futures
coinstringТикер монеты, например 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
coinstringТикер монеты, обязательный
volumenumber0 по умолчанию — лучшие цены стакана; или 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, asks10 лучших уровней: [цена, сумма в 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 точек покрывают
1m1 минута6 часов
15m15 минут3,75 дня
1h1 час15 дней
1d1 деньоколо года

Данные собираются с 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 — продать токен может быть нельзя.

Как проверить связку по стакану

  1. Возьмите строку арбитража

    Найдите связку в /arbitrage/spot-spot или другом наборе — см. «Эндпоинты арбитража». Запишите монету, биржи и spread_pct.

  2. Пересчитайте спред по стакану

    Запросите /orderbooks/spreads/spot-spot с этой монетой и объёмом сделки и сравните spread_pct с order_delta.spread_pct.

  3. Проверьте свежесть и глубину

    Вызовите /orderbooks/book для обеих ног: age_sec, stale и depth_limited покажут, можно ли доверять цифрам, а стенки — где может остановиться цена.

  4. Сравните с историей

    /orderbooks/exec-history покажет, обычное ли это проскальзывание для рынка: 1m — за 6 часов, 1h — за 15 дней.

  5. Для 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.