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 цену двигает поток заявок в стакане. Расхождение держится, пока его не закроет арбитражёр, и вот что ему мешает:
- Закрыт ввод или вывод. Если токен нельзя завести на биржу или вывести с неё, рынки живут отдельно. В строке это
deposit_enabledиwithdraw_enabled. - Расходы больше разницы. Газ, комиссия пула и биржи: расхождение меньше этих расходов закрывать невыгодно.
- Налог токена. При налоге на покупку 5 % расхождение до 5 % съедает сам налог.
- Мелкий пул. В пуле на десятки тысяч долларов цену сдвигает одна средняя сделка.
- Другой токен. Под тем же тикером на DEX может торговаться копия с другим контрактом. Genesis Arbitrage сравнивает цены только при одинаковом адресе контракта.
Для арбитража знак спреда задаёт направление сделки, а направление — что должно быть открыто на бирже и какие данные DEX-ноги смотреть:
spread_pct | Сделка | Нужно на CEX | Данные DEX-ноги |
|---|---|---|---|
| Больше 0 | Купить на DEX, завести на биржу, продать | deposit_enabled | slippage_buy_pct, tax_buy_pct |
| Меньше 0 | Купить на бирже, вывести, продать на DEX | withdraw_enabled | slippage_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.
| Сумма | Проскальзывание | Газ, % суммы | Остаток спреда |
|---|---|---|---|
| $500 | 0,5 % | 0,8 % | 0,6 %, или $3 |
| $1 000 | 0,7 % | 0,4 % | 0,8 %, или $8 |
| $2 500 | 1,3 % | 0,16 % | 0,44 %, или $11 |
| $5 000 | 2,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_usd | DEX — Фьючерсы |
/arbitrage/crosschain | Один токен на DEX в двух сетях, возраст пулов | Кроссчейн |
/orderbooks/dex-slippage | Проскальзывание от $100 до $100 000, налоги, honeypot | Проскальзывание DEX |
/market/dex-dumps | Обвалы токенов на DEX и есть ли токен на CEX | DEX Дампы |
Все пять работают на тарифах 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 без лимитов».
Риски, которые не видны в спреде
- MEV и сэндвич-атаки. Обмен на DEX до попадания в блок может увидеть бот: он покупает перед вами, продаёт после и забирает часть спреда. Чем шире допуск проскальзывания в кошельке, тем больше он может взять; защита разобрана в статье «MEV и сэндвич-атаки на DEX».
- Права владельца токена. Если контракт это позволяет, владелец может поднять налог или остановить продажи после вашей покупки, и сегодняшние
honeypot: "no"и нулевой налог от этого не защищают. Права в контракте и блокировку ликвидности проверяют по шагам из статьи «Как проверить токен перед покупкой». - Задержка данных. Цены приходят с задержкой тарифа, лестница проскальзывания — со своим
updated_at. Перед сделкой сверьте цену в пуле по ссылке из строки и стакан на бирже. - Перевод на биржу. Ввод могут закрыть, пока токен в пути, а зачисление ждёт подтверждений сети, и у каждой биржи их число своё.
- Газ. В загруженной сети комиссия растёт и съедает спред на малой сумме.
Вопросы и ответы
Можно ли купить токен через 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.