Ончейн в Genesis API: переводы, потоки, разлоки и свапы DEX
Коротко
- Эндпоинт /onchain/{section} отдаёт любую из девяти лент Genesis OnChain, от крупных переводов до взломов, на тарифах Start, Pro и Max. Запрос /onchain без раздела возвращает все ленты одним объектом.
- Крупные свапы DEX, аналитика за 24 часа или 7 дней и сводка монеты за 7 дней открыты на тарифах Pro и Max.
- Метки адресов — атрибуция, не гарантия. Перевод на биржу не всегда означает продажу, а запись о свапе может исчезнуть после проверки.
Ончейн-эндпоинты Genesis API отдают данные раздела Genesis OnChain: крупные переводы токенов, депозиты и выводы с бирж, кошельки команд, позиции на perp DEX, разлоки, клеймы и взломы, а также крупные свапы на DEX. В строках уже есть метки отправителя и получателя, сумма в долларах и ссылки на эксплорер. За китами и потоками на биржи можно следить из своего кода без собственного индексатора блокчейнов.
Эндпоинты и тарифы
| Эндпоинт | Что отдаёт | Тарифы API |
|---|---|---|
/onchain/{section} | Один из девяти разделов Genesis OnChain | Start, Pro, Max |
/onchain | Все девять разделов одним объектом | Start, Pro, Max |
/onchain/dex-swaps | Крупные свапы DEX | Pro, Max |
/onchain/analytics | Аналитика OnChain за 24h или 7d | Pro, Max |
/onchain/coin/{symbol} | Сводка одной монеты за 7 дней | Pro, Max |
На Trial все ончейн-эндпоинты отвечают 403 plan_restricted. Свежесть ответа — 30 с на Start, 10 с на Pro и 5 с на Max, это же значение приходит в meta.freshness_sec. Ключ и первый запрос — в быстром старте, квоты — в инструкции «Лимиты Genesis API».
Девять разделов /onchain/{section}
section | Что внутри | Блок дашборда |
|---|---|---|
large-transfers | Крупные переводы токенов | Крупные переводы |
cex-flows | Депозиты на биржи и выводы с них | Депозиты / Выводы на CEX |
mint-bridge | Выпуск токенов и переводы через мосты | Минт / Бридж |
team-wallets | Движения кошельков команд | Переводы команд |
perp-positions | Крупные позиции на perp DEX | Perp. DEX позиции |
unlocks | Разлоки токенов | Анлоки |
claims | Клеймы | Клеймы |
coin-traffic | Серии переводов одной монеты на одну цель | Движения монет |
hacks | Взломы и эксплойты | Взломы / Эксплойты |
Что показывает каждый блок и какие сигналы в нём искать, описано в инструкции «Дашборд Genesis OnChain», параметры — в документации. Запрос /onchain без раздела возвращает в data объект: ключ — имя раздела, значение — его строки. Фильтры при этом применяются к каждому разделу.
| Параметр | Тип | Что делает |
|---|---|---|
min_usd | number | Минимальная сумма события, USD |
coin | string | Строки одной монеты; у hacks монеты нет, список будет пустым |
when | string | Только для unlocks: upcoming — предстоящие, past — прошедшие |
section | string | Раздел для запроса /onchain?section=… |
Другое значение when вернёт 400 bad_request. Ниже — раздел coin-traffic, один элемент массива data:
curl "https://api.genesisarbitrage.com/v1/onchain/coin-traffic" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"ts": 1783802410,
"token": "LAB",
"direction": "deposit",
"target": "Gate-io",
"target_address": "0x8782163068c7cd74D2510768a61135C1e4Eb07b3",
"total_usd": 573796.98,
"count": 18,
"window_hours": 5.69,
"avg_usd": 31878,
"largest_usd": 59891.78,
"transfers": [
{
"ts": 1783788640,
"usd": 59891.78,
"from_name": "0xec01…d1a5",
"tx_hash": "0xbf44850a7dc16086c08cfb…",
"chain": "bsc",
…
}
]
}
Поля разделов
Разделы large-transfers, cex-flows, mint-bridge, team-wallets и claims состоят из переводов, у остальных поля свои.
| Поля | Где | Что значит |
|---|---|---|
ts, links | Все разделы | Время события в unix-секундах и готовые ссылки text + url |
token / token_name | Переводы, coin-traffic | Тикер и полное имя токена |
chain / chain_name, usd / amount | Переводы | Сеть, сумма в долларах и в токенах |
from_* / to_* | Переводы | Отправитель и получатель: метка, адрес, ссылка на эксплорер |
tx_hash / explorer_url / arkham_url | Переводы | Хэш транзакции и ссылки на эксплорер и Arkham |
direction, target / target_address | coin-traffic | Направление deposit, withdrawal или transfer и цель потока |
total_usd / count / window_hours, transfers[] | coin-traffic | Сумма серии, число переводов, окно в часах и крупнейшие переводы |
side / size / price / platform | perp-positions | Long или Short, размер, цена, площадка |
unlock_percent / unlock_value_usd / hours_left / allocations | unlocks | Доля и стоимость разлока, часов до него, распределение |
classification / technique / returned_funds | hacks | Классификация, техника атаки, возвращённые средства |
Свапы DEX: /onchain/dex-swaps
Тарифы Pro и Max. Эндпоинт отдаёт ленту крупных свапов, как экран «Обзор DEX»: у каждого свапа видно, какую долю ликвидности пула он забрал, какого хода цены от него ждать и что случилось через 30 секунд и 5 минут. Схема ответа — в документации.
| Параметр | Тип | Что делает |
|---|---|---|
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 — только проверенные свапы |
token | string | Тикер токена |
q | string | Поиск по токену, имени, адресам, трейдеру, хэшу, DEX и сети |
| Поле | Тип | Что значит |
|---|---|---|
id | string | Постоянный идентификатор: сеть, транзакция, токен |
tier | string | Ярус по ликвидности пула: от T1 ($30 000–100 000) до T4 (больше $10 млн) |
pool_liquidity_usd / size_pct_liquidity / impact_est_pct | number или null | Ликвидность пула, доля свапа в ней и оценка влияния на цену, % |
price_after_30s_usd / price_after_5m_usd / move_after_5m_pct | number или null | Цена через 30 с и 5 мин и ход цены за 5 минут после свапа |
facts | string | Статус проверки: pending, publish, 30s, final или unavailable |
trader_name / trader_address | string или null | Метка и адрес трейдера |
В примере ниже свап на $412 500 в пуле с ликвидностью $4 120 000 забрал 412 500 / 4 120 000 × 100 = 10,01 % пула. Оценка влияния — 4,8 %, а через 5 минут цена сдвинулась на 1,9 %.
curl -G "https://api.genesisarbitrage.com/v1/onchain/dex-swaps" \
-d period=1h -d min_usd=100000 -d final=true \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"id": "ethereum:0x5f3c…e1:0x6982…1933",
"ts": 1794675511,
"token": "PEPE",
"chain": "ethereum",
"side": "buy",
"usd": 412500,
"dex": "Uniswap",
"pool_label": "PEPE/WETH 0.3%",
"tier": "T3",
"pool_liquidity_usd": 4120000,
"size_pct_liquidity": 10.01,
"impact_est_pct": 4.8,
"move_after_5m_pct": 1.9,
"facts": "final",
"explorer_url": "https://etherscan.io/tx/0x5f3c…e1"
}
Аналитика OnChain: /onchain/analytics
Тоже Pro и Max. Один вызов отдаёт экран «Аналитика Genesis OnChain» за period=24h (по умолчанию) или 7d — итоги, почасовые корзины, потоки по биржам, разлоки, взломы, монеты в фокусе и ленту событий. Все поля — в документации.
| Поле | Тип | Что значит |
|---|---|---|
kpi | object | Итоги: events, usd, tokens, cex_in, cex_out, cex_net |
hourly | object | Корзины с шагом 1 ч для 24h и 6 ч для 7d |
exchange_flows | object | По каждой бирже: in_usd, out_usd, net |
tokens | array | До 40 монет в фокусе с крупнейшим событием и контекстом CEX |
events | array | Лента событий периода, до 600 |
cex_net — разница депозитов и выводов: в примере 312 456 789 − 287 654 321 = 24 802 468, то есть на биржи занесли на $24,8 млн больше, чем вывели.
curl -G "https://api.genesisarbitrage.com/v1/onchain/analytics" \
-d period=24h \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"period": "24h",
"kpi": {
"events": 1284,
"usd": 912345678,
"tokens": 211,
"cex_in": 312456789,
"cex_out": 287654321,
"cex_net": 24802468
},
"exchange_flows": {
"Binance": {
"in_usd": 98123456, "out_usd": 87654321, "net": 10469135
}
},
"tokens": [ … ],
"events": [ … ]
}
Монета OnChain: /onchain/coin/{symbol}
На Pro и Max есть и сводка одной монеты за 7 дней, как на странице монеты: ончейн-события, свапы DEX, разлоки и контекст CEX. Тикер передаётся в пути, от 1 до 32 символов, ответ пересобирается не чаще раза в 10 секунд. Поля — в документации.
| Поле | Тип | Что значит |
|---|---|---|
cex | object или null | Цена, OI, фандинг за 8 часов, лучший спред, сети, ввод и вывод; null — монеты нет на поддерживаемых CEX |
kpi | object | Итоги за 7 дней: события, cex_in, cex_out, свапы, dex_buy, dex_sell |
by_section | object | Число событий по разделам с ключами вида large_tx, cex_deposits |
events / swaps | array | События и свапы, до 2000; общее число — events_total и swaps_total |
unlocks.upcoming / unlocks.past | array | Предстоящие и прошедшие разлоки |
curl "https://api.genesisarbitrage.com/v1/onchain/coin/PEPE" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"symbol": "PEPE",
"cex": {
"price": 0.00001,
"oi_usd": 412000000,
"funding_8h": 0.0081,
"best_spread": 0.42,
"deposit": true,
"withdraw": true,
"nets": ["ETH", "BSC"]
},
"kpi": {
"events": 38, "cex_in": 21000000,
"cex_out": 18500000, "swaps": 54
},
"events_total": 38,
"swaps_total": 54
}
Условный пример: вводы монеты на биржи через cex-flows
Задача — знать, сколько монеты занесли на биржи за последний час, и получать уведомление о каждом крупном вводе. Направление в cex-flows видно по меткам: биржа в to_name — ввод, биржа в from_name — вывод.
За час по ARB пришли четыре ввода: $412 000, $260 000, $180 000 и $148 000, всего $412 000 + $260 000 + $180 000 + $148 000 = $1 000 000. Вывод один — $150 000. Чистый поток на биржи: $1 000 000 − $150 000 = $850 000, заносят больше, чем выводят. Так выглядит условная строка первого ввода:
{
"ts": 1794675511,
"token": "ARB",
"chain": "arbitrum_one",
"usd": 412000,
"amount": 1030000,
"from_name": "0x7a2f…c31b",
"to_name": "Binance Deposit",
"tx_hash": "0x9c1e…",
"explorer_url": "https://arbiscan.io/tx/0x9c1e…"
}
Задайте монету и порог
coinиmin_usdоставят в ответе крупные переводы одной монеты.Отделите вводы от выводов
Биржа в
to_name— ввод, вfrom_name— вывод. Метки сравнивайте по подстроке без учёта регистра.Считайте окно и новые переводы
Суммируйте строки за последний час по
ts, а уведомление отправляйте только по новымtx_hash.Опрашивайте с частотой тарифа
Пауза между запросами —
meta.freshness_sec, на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"]}
COIN, MIN_USD = "ARB", 100_000
CEX = ("binance", "okx", "bybit", "coinbase") # подстроки меток
seen = set()
def is_cex(label):
return any(name in (label or "").lower() for name in CEX)
while True:
r = requests.get(f"{API}/onchain/cex-flows", headers=HEADERS,
params={"coin": COIN, "min_usd": MIN_USD},
timeout=15)
if r.status_code in (429, 503): # лимит или пересборка
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
body = r.json()
hour_ago = time.time() - 3600
inflow = outflow = 0.0
for row in body["data"]:
if (row.get("ts") or 0) < hour_ago:
continue
usd = row.get("usd") or 0
if is_cex(row.get("to_name")): # ввод на биржу
inflow += usd
if row.get("tx_hash") not in seen:
seen.add(row.get("tx_hash"))
print(f"{COIN} → {row['to_name']}: ${usd:,.0f}")
elif is_cex(row.get("from_name")): # вывод с биржи
outflow += usd
print(f"за час: на биржи ${inflow:,.0f}, "
f"чистый поток ${inflow - outflow:,.0f}")
time.sleep(body["meta"]["freshness_sec"])
Скрипт только читает данные и печатает уведомления, решение по монете остаётся за вами. Серии мелких переводов на одну биржу собраны в разделе coin-traffic, где направление уже указано в поле direction. Итоги по всем монетам отдаёт /onchain/analytics в kpi.cex_in, kpi.cex_out и kpi.cex_net, а обзор задач с ончейн-данными — в статье «API ончейн-данных».
Вопросы и ответы
Какой тариф нужен для ончейн-данных?
Девять разделов /onchain/{section} открыты на Start, Pro и Max. Свапы DEX, аналитика и сводка монеты — только на Pro и Max, на Trial ончейн-эндпоинты отвечают 403 plan_restricted.
Есть ли история глубже 7 дней?
Самые длинные окна — period=7d у свапов и аналитики и 7 дней в сводке монеты, отдельного архива в Genesis API нет. Долгую историю собирайте сами, сохраняя записи при каждом опросе.
Почему свап пропал из ответа?
Проверка нашла перекладку ликвидности вместо сделки, и запись удалили. Сверяйте сохранённые свапы по id или берите только final=true.
Как получить предстоящие разлоки токенов?
Запросите /onchain/unlocks?when=upcoming. В строке есть unlock_percent и unlock_value_usd — доля и стоимость разлока, а hours_left — сколько часов до него осталось. Порог по стоимости задаёт min_usd, монету — coin.