Genesis Arbitrage

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

DEX API: цены DEX, ликвидность и проскальзывание рядом с ценами CEX

Коротко

  • DEX API отдаёт цену токена в пуле, ликвидность, объём, капитализацию, контракт и сеть. Для арбитража к ним нужна цена того же контракта на CEX — её дают эндпоинты DEX – Спот и DEX – Фьючерсы Genesis API на тарифах Pro и Max.
  • Цена на DEX зависит от суммы сделки, потому что её задаёт пул ликвидности. В условном примере спред 3 % оставляет $11 на сделке в $2 500 и уходит в минус на $5 000 после проскальзывания, налога токена и газа.
  • Проскальзывание на вашу сумму, налоги на покупку и продажу и признак honeypot отдаёт /orderbooks/dex-slippage. Genesis API только читает данные: обмен вы подписываете сами в своём кошельке.

DEX API — программный доступ к данным децентрализованных бирж (DEX): цене токена в пуле, ликвидности пула, объёму торгов, капитализации, адресу контракта и сети. На большинстве DEX нет стакана заявок и листинга: цену задаёт пул ликвидности, а создать пул может кто угодно. Поэтому вместе с ценой API должен отдавать данные для проверки токена и пула.

Для арбитража цену DEX сравнивают с ценой того же контракта на CEX и считают, сколько спреда останется на вашу сумму после проскальзывания, налога токена и газа. В Genesis API связки DEX ↔ CEX отдают /arbitrage/dex-spot и /arbitrage/dex-futures, а проскальзывание, налоги и признак honeypot по контракту — /orderbooks/dex-slippage.

Как формируется цена на DEX

На большинстве DEX обмен идёт через пул ликвидности — смарт-контракт с запасами двух токенов, например токена и USDC. Цена равна отношению запасов. Покупка забирает из пула токен и добавляет в него USDC, поэтому каждая следующая единица токена стоит дороже предыдущей.

Uniswap описывает такой пул формулой постоянного произведения x × y = k, где x и y — запасы токенов: после обмена произведение не должно уменьшиться.

Условный пример: в пуле $200 000 ликвидности, по $100 000 с каждой стороны. Покупка на $1 000 сдвигает среднюю цену на 2 × 1 000 / 200 000 = 1 %, покупка на $10 000 — уже на 10 %. Пошаговый расчёт с таблицей — в уроке «Что такое DEX-арбитраж».

Формула описывает один классический пул. В Uniswap v3 и v4 она действует внутри диапазонов цен, которые выбрали поставщики ликвидности, а цена DEX в строках Genesis Arbitrage агрегирована по контракту и сети. Поэтому точное проскальзывание на сумму берут из данных, а формулой пользуются для быстрой оценки.

Какие данные нужны от DEX API

Перед связкой DEX ↔ CEX смотрят не одну цену. Вот что нужно и где это лежит в ответах Genesis API:

ДанныеЗачем в арбитражеПоле Genesis API
Цена на DEX и на CEXСпред и его направлениеdex_price, cex_price, spread_pct
Ликвидность пулаНасколько сделка сдвинет ценуliquidity_usd
Объём за 24 часаЕсть ли в пуле живая торговляdex_volume_24h, volume_24h_usd
КапитализацияНасколько крупный токенmarket_cap
Контракт и сетьТот ли это токен, что на биржеcontract, network или chain
Возраст пулаСвежий пул — повод перепроверить контрактpool_created_at
Ввод и вывод на CEXМожно ли завести токен на биржу или вывестиdeposit_enabled, withdraw_enabled
Проскальзывание, налог, honeypotСколько спреда останется/orderbooks/dex-slippage
Ссылки на пулПосмотреть пул и сделки глазамиdexscreener_url, dextools_url, gmgn_url

Капитализация и объём DEX приходят в DEX – Спот, возраст пула — в сторонах buy и sell Кроссчейна. Запрос строки DEX – Спот по одной монете:

curl -G --compressed \
  "https://api.genesisarbitrage.com/v1/arbitrage/dex-spot" \
  -d coin=SCR \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

Строка из документации DEX — Спот, сокращённо:

{
  "coin": "SCR",
  "exchange": "MEXC",
  "cex_price": 0.02691,
  "dex_price": 0.02679,
  "spread_pct": 0.45,
  "network": "SCROLL",
  "contract": "0xd29687c813D741E2F938F4aC377128810E217b1b",
  "liquidity_usd": 10544.15,
  "market_cap": 5091835.0,
  "dex_volume_24h": 319.73,
  "deposit_enabled": true,
  "withdraw_enabled": true,
  "dexscreener_url": "https://dexscreener.com/scroll/0xd296…",
  "dextools_url": null,
  …
}

На MEXC токен дороже, чем в пуле, поэтому спред положительный: 0,45 %. Ликвидность пула — $10 544, объём DEX за сутки — около $320. Если это один классический пул, средняя цена покупки на $1 000 будет выше стартовой примерно на 2 × 1 000 / 10 544 ≈ 19 % — в 40 с лишним раз больше спреда. Ссылки бывают null: в этой строке есть только dexscreener_url.

Почему цена DEX расходится с CEX

Цена пула меняется только сделками в нём, а снаружи новая цена видна с каждым блоком сети: в Ethereum время делится на слоты по 12 секунд. На CEX цену двигает поток заявок в стакане. Расхождение держится, пока его не закроет арбитражёр, и вот что ему мешает:

Для арбитража знак спреда задаёт направление сделки, а направление — что должно быть открыто на бирже и какие данные DEX-ноги смотреть:

spread_pctСделкаНужно на CEXДанные DEX-ноги
Больше 0Купить на DEX, завести на биржу, продатьdeposit_enabledslippage_buy_pct, tax_buy_pct
Меньше 0Купить на бирже, вывести, продать на DEXwithdraw_enabledslippage_sell_pct, tax_sell_pct

Пока токен идёт между кошельком и биржей, спред может закрыться. В связке DEX – Фьючерсы движение цены гасит шорт фьючерса, открытый одновременно с покупкой на DEX, зато появляются маржа, фандинг и риск ликвидации — разбор в уроке «Арбитраж DEX – Фьючерсы». В строке DEX – Фьючерсы есть max_position_usd — максимальный размер позиции, если биржа его отдаёт.

Проскальзывание, налог токена и honeypot

/orderbooks/dex-slippage описывает DEX-ногу связки по контракту: проскальзывание покупки и продажи на суммах от $100 до $100 000, налог токена на покупку и продажу и признак honeypot — токена, который можно купить, но нельзя продать. Это те же данные, что в колонках DEX-таблиц сайта. Фильтры — contract (несколько адресов через запятую) и network, описание полей — в разделе «Проскальзывание DEX».

Пример ответа из документации, один контракт:

{
  "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: покупка на $1 000 теряет 0,36 %, на $10 000 — 0,86 %, на $100 000 — 6,05 %. null в массиве значит, что пулу не хватает ликвидности на эту сумму. honeypot принимает три значения: no, suspect — источники расходятся, yes — продать токен может быть нельзя. У каждого контракта своё время обновления — updated_at.

Условный пример: спред 3 % и что от него остаётся

Токен на DEX стоит $1,00, на CEX — $1,03: спред 3 % от цены покупки, направление — купить на DEX и продать на бирже. Налог на покупку — 1 %, комиссия биржи при продаже — 0,1 %, газ за обмен и перевод на биржу — $4. Лестница slippage_buy_pct: 0,5 % на $500, 0,7 % на $1 000, 1,3 % на $2 500 и 2,3 % на $5 000.

СуммаПроскальзываниеГаз, % суммыОстаток спреда
$5000,5 %0,8 %0,6 %, или $3
$1 0000,7 %0,4 %0,8 %, или $8
$2 5001,3 %0,16 %0,44 %, или $11
$5 0002,3 %0,08 %−0,48 %, или −$24

Для $5 000: 3 − 2,3 − 1 − 0,1 − 0,08 = −0,48 %, то есть минус $24 на сделке. Проценты для оценки складываем; точный расчёт через произведения даёт результат на несколько сотых процента ниже.

В долларах больше всего остаётся на $2 500, а на $5 000 тот же спред уводит сделку в минус. С ростом суммы доля газа падает, проскальзывание растёт, поэтому у каждой связки своя рабочая сумма. При honeypot: "yes" и отрицательном спреде считать нечего: купленный на бирже токен может не продаться в пуле.

Продажа на CEX в примере посчитана по цене строки. На деле её проверяют по стакану биржи: «Δ по ордерам» для DEX-строк отдаёт /orderbooks/spreads/dex-spot на суммы $500, $1 000, $2 500, $5 000 и $10 000 — поля в документации, разбор в инструкции «Эндпоинты стаканов».

Эндпоинты DEX в Genesis API

ЭндпоинтЧто отдаётДокументация
/arbitrage/dex-spotЦена DEX против спота CEX, ликвидность, капитализация, объёмDEX — Спот
/arbitrage/dex-futuresЦена DEX против фьючерса CEX, max_position_usdDEX — Фьючерсы
/arbitrage/crosschainОдин токен на DEX в двух сетях, возраст пуловКроссчейн
/orderbooks/dex-slippageПроскальзывание от $100 до $100 000, налоги, honeypotПроскальзывание DEX
/market/dex-dumpsОбвалы токенов на DEX и есть ли токен на CEXDEX Дампы

Все пять работают на тарифах API Pro ($100 в месяц, свежесть 10 с) и Max ($200, свежесть 5 с), на Trial и Start они отвечают 403 plan_restricted. У DEX – Спот и DEX – Фьючерсы фильтры coin, exchange, min_spread и min_liquidity, у Кроссчейна вместо exchange — chain, у DEX Дампов — chain и min_liquidity. Параметры и поля наборов разобраны в инструкции «Эндпоинты арбитража», цены — на странице «Тарифы Genesis API».

min_spread сравнивает спред со знаком: min_spread=2 уберёт и строку со спредом −5 %. Чтобы видеть оба направления, порог по модулю ставят в коде — так сделано в примере ниже. Крупные свапы в пулах с оценкой влияния на цену отдаёт ончейн-эндпоинт /onchain/dex-swaps, он разобран в статье «API ончейн-данных».

Без кода те же связки показывает таблица сайта: колонки, фильтры и порядок проверки описаны в инструкции «Как пользоваться таблицей DEX – Спот».

Пример на Python: связки DEX – Спот без ловушек

Скрипт берёт связки DEX – Спот с ликвидностью от $50 000 и спредом по модулю от 2 %, запрашивает по их контрактам проскальзывание и налоги и отбрасывает honeypot: "yes" и налог выше 5 %. Для остальных он считает, сколько спреда останется на $1 000 после проскальзывания и налога. Ключ берётся из переменной окружения GENESIS_API_KEY.

Функция запроса ждёт Retry-After секунд при 429 и 503. Если исчерпана месячная квота, Retry-After считается до её сброса и может растянуться на дни, поэтому длинное ожидание скрипт не начинает:

import os
import time
import requests

API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}


def get(path, params=None):
    for _ in range(3):
        r = requests.get(API + path, headers=HEADERS,
                         params=params, timeout=15)
        if r.status_code == 403:
            raise SystemExit("эндпоинты DEX — на тарифах Pro и Max")
        if r.status_code in (429, 503):
            wait = int(r.headers.get("Retry-After", "5"))
            if wait > 60:  # месячная квота исчерпана
                raise SystemExit(f"квота исчерпана, ждать {wait} с")
            time.sleep(wait)
            continue
        r.raise_for_status()
        return r.json()["data"]
    raise RuntimeError("API занят, повторите позже")

Отбор связок и проверка контрактов:

SIZE = 1000   # сумма сделки, USD — одно из значений sizes_usd
MAX_TAX = 5   # налог токена выше 5 % — мимо

rows = get("/arbitrage/dex-spot", {"min_liquidity": 50000})
rows = [x for x in rows
        if x["contract"] and abs(x["spread_pct"]) >= 2]

addrs = sorted({x["contract"].lower() for x in rows})
checks, sizes = {}, []
for i in range(0, len(addrs), 50):  # до 50 адресов в запросе
    d = get("/orderbooks/dex-slippage",
            {"contract": ",".join(addrs[i:i + 50])})
    sizes = d["sizes_usd"]
    for c in d["contracts"]:  # адрес приходит строчными буквами
        checks[c["contract"]] = c

found = []
for x in rows:
    c = checks.get(x["contract"].lower())
    if c is None or c["honeypot"] == "yes":
        continue  # нет данных или продать может быть нельзя
    taxes = [t for t in (c["tax_buy_pct"], c["tax_sell_pct"])
             if t is not None]  # null — источника нет, не 0 %
    if any(t > MAX_TAX for t in taxes):
        continue
    buy = x["spread_pct"] >= 0  # плюс: покупка на DEX
    ladder = c["slippage_buy_pct" if buy else "slippage_sell_pct"]
    k = sizes.index(SIZE)
    slip = ladder[k] if k < len(ladder) else None
    if slip is None:
        continue  # пулу не хватает ликвидности на SIZE
    tax = c["tax_buy_pct" if buy else "tax_sell_pct"]
    left = abs(x["spread_pct"]) - slip - (tax or 0)
    found.append((left, x, c["honeypot"], tax))

for left, x, hp, tax in sorted(found, key=lambda f: -f[0]):
    print(f'{x["coin"]:<8} {x["exchange"]:<8} '
          f'спред {x["spread_pct"]:+.2f}%, остаток {left:.2f}%, '
          f'налог {"нет данных" if tax is None else tax}, '
          f'honeypot {hp}')

Газ и комиссию биржи скрипт не вычитает — добавьте значения своей сети и биржи. Строки без данных в /orderbooks/dex-slippage он пропускает: такие токены проверяйте вручную по ссылкам из строки. Адреса сравниваются строчными буквами, потому что в DEX – Спот контракт может прийти со смешанным регистром, как в примере выше.

В цикле опрашивайте не чаще meta.freshness_sec. На Pro это раз в 10 секунд: 30 × 86 400 / 10 = 259 200 вызовов одного эндпоинта за 30 дней при квоте 5 млн. Как экономить квоту и трафик, разобрано в статье «Как опрашивать API без лимитов».

Риски, которые не видны в спреде

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

Можно ли купить токен через Genesis API?

Нет. Genesis API только отдаёт данные и ордеров не ставит — ни на DEX, ни на биржах. Обмен на DEX вы подписываете в своём кошельке, сделку на CEX открываете на бирже сами.

Как часто обновляются цены DEX в API?

Цена пула меняется с каждой сделкой в нём, а снаружи видна с новыми блоками сети. Ядро Genesis Arbitrage обновляет данные каждую секунду, а через API они приходят со свежестью тарифа: 10 с на Pro и 5 с на Max — эндпоинты DEX есть только на этих тарифах. Время сборки снимка — в meta.updated_at, у проскальзывания и налогов — updated_at каждого контракта.

Что значит null в налоге токена?

Что источника данных о налоге этого токена нет. Ноль подставлять нельзя: налог может оказаться любым. Пример на Python выше такие строки не отбрасывает, а печатает «налог нет данных» — их проверяют вручную.

Какой тариф Genesis API нужен для данных DEX?

Pro ($100 в месяц) или Max ($200). На Trial и Start эндпоинты DEX – Спот, DEX – Фьючерсы, Кроссчейн, DEX Дампы и проскальзывание DEX отвечают 403 plan_restricted.

Есть ли в ответе ссылки на DexScreener?

Да. В строках DEX – Спот, DEX – Фьючерсы и в обеих сторонах Кроссчейна есть dexscreener_url, dextools_url и gmgn_url — ссылки на страницу пула или токена. Если ссылки нет, в поле приходит null. В DEX Дампах ссылка на пул — в pool_url, остальные — в массиве links.