Документация Genesis API

Всё, что нужно для интеграции: аутентификация, лимиты, эндпоинты и схемы ответов.

Обзор DEX

TrialStartProMax

Крупные DEX-свапы, как в «Обзоре DEX»: live — последние 15 минут, плюс окна 1h, 6h, 24h и 7d. У свапа есть оценка влияния на пул, ход цены через 30 с и 5 мин и подпись трейдера. Запись дописывается по мере проверки (facts: pending → final) и может исчезнуть, если свап оказался перекладкой ликвидности, — сверяйте по id.

GEThttps://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live
Проверить запрос
GET/v1/onchain/dex-swaps?period=live

Ключ хранится только в вашем браузере и никуда, кроме API, не отправляется.

Вставьте ключ и отправьте запрос — покажем сокращённый ответ.

Параметры запроса

Все параметры необязательны: без фильтров эндпоинт вернёт полный набор данных.

ПараметрТипОписание
periodstringlive (15 минут, по умолчанию), 1h, 6h, 24h или 7d
chainstringФильтр по сети
sidestringbuy или sell
dexstringDEX; несколько — через запятую
min_usdnumberМинимальная сумма, USD
min_impactnumberМинимальное влияние на пул по модулю, %
finalbooleantrue — только проверенные свапы (facts = final)
tokenstringТикер токена
qstringПоиск по токену, имени, адресам, трейдеру, хэшу, DEX и сети

Пример запроса

bash
curl "https://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

Пример ответа

Пример ответа — одна запись data, длинные значения сокращены:

json
{
  "id": "ethereum:0x5f3c…e1:0x6982…1933",
  "ts": 1794675511,
  "published_at": 1794675523,
  "token": "PEPE",
  "token_name": "Pepe",
  "token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
  "chain": "ethereum",
  "chain_name": "Ethereum",
  "side": "buy",
  "amount": 41250000000,
  "usd": 412500,
  "dex": "Uniswap",
  "pool_address": "0xa43f…",
  "pool_label": "PEPE/WETH 0.3%",
  "trader_address": "0x7b9e…",
  "trader_name": "Wintermute",
  "tier": "T3",
  "pool_liquidity_usd": 4120000,
  "size_pct_liquidity": 10.01,
  "impact_est_pct": 4.8,
  "price_usd": 0.00001,
  "move_after_5m_pct": 1.9,
  "facts": "final",
  "tx_hash": "0x5f3c…e1",
  "explorer_url": "https://etherscan.io/tx/0x5f3c…e1",
  "dexscreener_url": "https://dexscreener.com/ethereum/0xa43f…"
}

Поля ответа

ПолеТипОписание
idstringСтабильный идентификатор: сеть, транзакция, токен
ts / published_atintВремя свапа и публикации
token / token_name / token_addressstringТокен: тикер, имя, адрес контракта
chain / chain_namestringСеть
side / amount / usdmixedСторона buy или sell, количество и сумма в USD
dex / dex_entity / pool_address / pool_label / routemixedDEX, его сущность, пул, метка пула и маршрут
trader_address / trader_name / trader_type / trader_urlstring | nullТрейдер: адрес, подпись, тип и ссылка
tierstringЯрус по ликвидности пула: от T1 ($30K–100K) до T4 (больше $10M)
pool_liquidity_usd / size_pct_liquidity / impact_est_pctnumber | nullЛиквидность пула, доля свапа от неё и оценка влияния на цену, %
price_usd / price_change_5m_pct / price_change_1h_pct / price_after_30s_usd / price_after_5m_usd / move_after_5m_pctnumber | nullЦена и её изменение до свапа и через 30 с / 5 мин
facts / legsstring / intСтатус проверки: pending, publish, 30s, final или unavailable; legs — число ног
tx_hash / explorer_url / arkham_url / dexscreener_urlstringХэш транзакции и ссылки на explorer / Arkham