Документация Genesis API
Всё, что нужно для интеграции: аутентификация, лимиты, эндпоинты и схемы ответов.
ДокументацияОбзор DEX
Обзор DEX
TrialStartProMax
Крупные DEX-свапы, как в «Обзоре DEX»: live — последние 15 минут, плюс окна 1h, 6h, 24h и 7d. У свапа есть оценка влияния на пул, ход цены через 30 с и 5 мин и подпись трейдера. Запись дописывается по мере проверки (facts: pending → final) и может исчезнуть, если свап оказался перекладкой ликвидности, — сверяйте по id.
GET
https://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=liveПроверить запрос
GET
/v1/onchain/dex-swaps?period=liveКлюч хранится только в вашем браузере и никуда, кроме API, не отправляется.
Вставьте ключ и отправьте запрос — покажем сокращённый ответ.
Параметры запроса
Все параметры необязательны: без фильтров эндпоинт вернёт полный набор данных.
| Параметр | Тип | Описание |
|---|---|---|
period | string | live (15 минут, по умолчанию), 1h, 6h, 24h или 7d |
chain | string | Фильтр по сети |
side | string | buy или sell |
dex | string | DEX; несколько — через запятую |
min_usd | number | Минимальная сумма, USD |
min_impact | number | Минимальное влияние на пул по модулю, % |
final | boolean | true — только проверенные свапы (facts = final) |
token | string | Тикер токена |
q | string | Поиск по токену, имени, адресам, трейдеру, хэшу, 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…"
}Поля ответа
| Поле | Тип | Описание |
|---|---|---|
id | string | Стабильный идентификатор: сеть, транзакция, токен |
ts / published_at | int | Время свапа и публикации |
token / token_name / token_address | string | Токен: тикер, имя, адрес контракта |
chain / chain_name | string | Сеть |
side / amount / usd | mixed | Сторона buy или sell, количество и сумма в USD |
dex / dex_entity / pool_address / pool_label / route | mixed | DEX, его сущность, пул, метка пула и маршрут |
trader_address / trader_name / trader_type / trader_url | string | null | Трейдер: адрес, подпись, тип и ссылка |
tier | string | Ярус по ликвидности пула: от T1 ($30K–100K) до T4 (больше $10M) |
pool_liquidity_usd / size_pct_liquidity / impact_est_pct | number | null | Ликвидность пула, доля свапа от неё и оценка влияния на цену, % |
price_usd / price_change_5m_pct / price_change_1h_pct / price_after_30s_usd / price_after_5m_usd / move_after_5m_pct | number | null | Цена и её изменение до свапа и через 30 с / 5 мин |
facts / legs | string / int | Статус проверки: pending, publish, 30s, final или unavailable; legs — число ног |
tx_hash / explorer_url / arkham_url / dexscreener_url | string | Хэш транзакции и ссылки на explorer / Arkham |