Genesis Arbitrage

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

API ончейн-данных: переводы китов, потоки на биржи и разлоки токенов

Коротко

  • API ончейн-данных отдаёт события блокчейнов уже разобранными: какой токен ушёл, от кого, кому и на сколько долларов. Сырые данные берут с нод, индексаторы раскладывают их в таблицы, а метки адресов остаются атрибуцией и бывают ошибочными.
  • Трейдеру полезны вводы и выводы с бирж, крупные переводы, кошельки команд, позиции на perp DEX, разлоки, клеймы, взломы и крупные свапы DEX. Ввод на биржу не всегда заканчивается продажей.
  • В Genesis API девять ончейн-разделов открыты с тарифа Start, а свапы DEX, аналитика и сводка монеты — на Pro и Max. Окно и сумму потоков считает ваш код, параметра времени у разделов нет.

API ончейн-данных — HTTP-интерфейс к событиям блокчейнов, уже собранным, пересчитанным в доллары и подписанным: какой токен ушёл, с какого адреса, на какой и в какой транзакции. Через такой API следят за переводами китов, вводами монет на биржи, разлоками токенов и крупными свапами на DEX без своей ноды и индексатора. Кит здесь — адрес с крупной суммой монеты, чьи переводы способны сдвинуть рынок.

Откуда берутся ончейн-данные

Данные проходят три слоя: нода хранит блоки, индексатор превращает их в строки событий, база меток подписывает адреса.

Нода: блоки и логи

Нода блокчейна хранит блоки и отдаёт их по JSON-RPC. В Ethereum и совместимых сетях перевод токена стандарта ERC-20 записывается в лог событием Transfer(address indexed _from, address indexed _to, uint256 _value), а выпуск новых токенов стандарт советует отмечать тем же событием с отправителем 0x0 (EIP-20).

Логи по фильтру отдаёт метод eth_getLogs: диапазон блоков fromBlock и toBlock, адрес контракта address и темы события topics (JSON-RPC Ethereum). В логе — адреса, номер блока, хэш транзакции и количество в минимальных единицах токена. Цены в долларах, имени владельца и признака биржи в блоке нет.

Индексатор: из логов в таблицы

Индексатор читает блоки подряд, декодирует события и раскладывает их по таблицам: переводы, свапы, изменения пулов. Количество он делит на 10 в степени decimals токена — при восьми знаках это деление на 100 000 000 — и умножает на цену в момент блока, так появляется сумма в долларах.

Затем пороги: в ленту попадают переводы крупнее заданной суммы, а серии мелких переводов на один адрес склеиваются в одну строку. Держать такой конвейер для нескольких сетей — отдельный проект, API ончейн-данных отдаёт его результат одним запросом.

Метки адресов: кто стоит за адресом

Метка — подпись адреса: «Binance», «казначейство проекта», «маркетмейкер». Её ставят по признакам: адрес пересылает монеты на известный кошелёк биржи, проект сам опубликовал свои адреса, адрес получил токены из контракта вестинга. Владелец адреса эти выводы не подтверждает, поэтому метка может устареть или оказаться ошибочной.

Адрес без признаков остаётся без имени: в примерах документации Genesis API у такого отправителя стоит сокращённый адрес 0xec01…d1a5.

Какие ончейн-события полезны трейдеру

Условный пример: за утро на биржи завели монеты проекта на $2 000 000, а с кошелька его команды ушли $500 000 на адрес маркетмейкера. По отдельности каждое событие мало что говорит, вместе это повод проверить цену, открытый интерес и график разлоков.

СобытиеЧто видноКак обычно читают
Ввод на биржуМонеты пришли на адрес биржиВозможная продажа, залог или перекладка
Вывод с биржиМонеты ушли на внешний адресХранение, DeFi или другая биржа
Крупный переводПеревод выше порога между кошелькамиКит перекладывает позицию
Кошелёк командыДвижение с адресов фонда, казначейства, основателейВвод на биржу весит больше перевода между своими
Позиция на perp DEXЛонг или шорт: размер, цена, площадкаСтавка кита и риск ликвидаций
РазлокДата, доля и стоимость разблокировкиНовое предложение монеты
КлеймТокены из аирдропа, вестинга, наградПолучатели могут продать сразу
Минт и мостВыпуск токенов, переходы между сетямиВыпуск стейблкоинов — приток денег
ВзломПротокол, ущерб, техника атакиРиск для токена и связанных сетей
Свап на DEXСторона, сумма, доля пула, ход ценыСдвиг цены до реакции бирж

Позиции на децентрализованных биржах бессрочных фьючерсов, perp DEX, видны потому, что данные этих площадок открыты. У Hyperliquid info-эндпоинт POST https://api.hyperliquid.xyz/info с запросом clearinghouseState отдаёт открытые позиции и маржу любого адреса без ключа (документация Hyperliquid). CEX чужие позиции не публикуют, они отдают сводные цифры вроде открытого интереса.

Разлок — разблокировка токенов команды, инвесторов или фонда по графику вестинга, то есть выдачи частями по расписанию. Дата известна заранее, поэтому рынок может заложить продажу в цену ещё до события.

Свап на DEX двигает цену пула в том же блоке. Условный пример: покупка на $150 000 в пуле с ликвидностью $1 200 000 забирает 150 000 / 1 200 000 × 100 = 12,5 % пула. Цена пула сдвинется заметно, а на биржах движение появится позже или не появится вовсе. Сравнение цен DEX и CEX — в статье «DEX API».

Взлом виден в блокчейне по переводам из контракта протокола. Чаще других атакуют мосты, в их контрактах лежат крупные суммы: громкие случаи — в статье «Мосты между блокчейнами», кража у биржи — в разборе взлома Bybit.

Задержка и подтверждение

Между транзакцией и строкой в вашем коде проходят секунды и минуты — это задержка данных. Для обзора потоков за сутки она неважна, для реакции на один крупный ввод или свап — решает.

Подтверждение в сети

В Ethereum новый блок может выйти раз в слот — 12 секунд, а финальным он становится примерно через 15 минут (ethereum.org). Финализированный блок уже не изменить без потери огромной суммы ETH. Индексатор, которому нужна только окончательная картина, может читать блоки до тега finalized — так нода называет последний финализированный блок.

Биржа зачисляет депозит, когда транзакция наберёт минимум подтверждений сети, и у Binance, например, этот минимум свой для каждой монеты (справка Binance). Поэтому ввод на биржу виден в блокчейне раньше, чем владелец сможет продать эти монеты.

Задержка данных

Пример полей свапа из документации Genesis API: ts = 1794675511 — время свапа, published_at = 1794675523 — время публикации записи, между ними 1794675523 − 1794675511 = 12 секунд. Дальше добавляются свежесть данных тарифа в meta.freshness_sec — 30 секунд на Start, 10 на Pro, 5 на Max — и интервал вашего опроса.

ЭтапСколькоЧто это значит
Блок в Ethereumслот 12 сТранзакция видна, но не финальна
Финальность в Ethereumоколо 15 минБлок уже не изменится
Зачисление на биржеминимум подтверждений биржиСвой для каждой монеты
Публикация свапа12 с в примереЗапись ещё не final
Статус finalне раньше 5 мин после свапаИзвестна цена через 30 с и 5 мин
Отдача Genesis API30, 10 или 5 сТарифы Start, Pro и Max

У свапов лента period=live с непроверенными записями быстрее, но запись может исчезнуть, если свап окажется перекладкой ликвидности. Параметр final=true оставляет только проверенные свапы, зато минимум на 5 минут позже.

Ончейн-данные в Genesis API

Genesis API отдаёт ленты раздела Genesis OnChain: в строках переводов уже есть метки отправителя и получателя, сумма в долларах и в токенах, хэш транзакции и ссылка на эксплорер. Запросы — HTTP GET с ключом в заголовке X-API-Key, ответ — JSON с полем data и блоком meta.

ЭндпоинтЧто отдаётТарифы
/onchain/{section}Один из 9 ончейн-разделовStart, Pro, Max
/onchainВсе 9 разделов одним объектомStart, Pro, Max
/onchain/dex-swapsКрупные свапы DEXPro, Max
/onchain/analyticsИтоги за 24h или 7dPro, Max
/onchain/coin/{symbol}Сводка монеты за 7 днейPro, Max

Разделы названы по лентам: large-transfers, cex-flows, mint-bridge, team-wallets, perp-positions, unlocks, claims, hacks и coin-traffic — серии переводов одной монеты на одну цель. Фильтры — min_usd и coin, у разлоков ещё when со значением upcoming или past. Параметра времени нет, окно считается по полю ts.

Запрос предстоящих разлоков дороже $1 000 000:

curl -G "https://api.genesisarbitrage.com/v1/onchain/unlocks" \
  -d when=upcoming -d min_usd=1000000 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

В строке разлока — unlock_percent и unlock_value_usd (доля и стоимость), hours_left (часов до события) и allocations (распределение по получателям).

На Pro и Max добавляются три эндпоинта. /onchain/dex-swaps отдаёт крупные свапы с долей ликвидности пула, оценкой влияния на цену и ходом цены через 30 секунд и 5 минут (Обзор DEX в документации). /onchain/analytics считает итоги за 24h или 7d: kpi.cex_in, kpi.cex_out, kpi.cex_net и потоки по каждой бирже (Аналитика OnChain). /onchain/coin/{symbol} собирает события, свапы и разлоки монеты за 7 дней с ценой, OI и фандингом на CEX (Монета OnChain).

Квоту тратит только ответ 200, а на Trial ончейн-эндпоинты отвечают 403 plan_restricted. Start стоит $50 в месяц и даёт 2 млн вызовов, Pro — $100 и 5 млн, Max — $200 и 10 млн (тарифы Genesis API). Все параметры и поля с примерами ответов — в инструкции «Эндпоинты ончейна».

Без кода те же ленты показывает дашборд Genesis OnChain, свапы — Обзор DEX, итоги за сутки и неделю — Аналитика OnChain.

Python: сумма вводов монеты на биржи за окно

Условный пример: за 6 часов на биржи пришли пять переводов ARB — $640 000, $520 000, $410 000, $330 000 и $150 000. Сумма 640 000 + 520 000 + 410 000 + 330 000 + 150 000 = 2 050 000, порог в $2 000 000 пройден. Когда первый перевод станет старше 6 часов, он выпадет из окна: 2 050 000 − 640 000 = 1 410 000, и сумма снова ниже порога.

Поля direction в cex-flows нет, направление видно по меткам: биржа в to_name — ввод, биржа в from_name — вывод. Ответ — текущая лента раздела, поэтому скрипт хранит вводы у себя по tx_hash и сам выбрасывает старые. Так сумма за окно не задваивается между опросами.

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", 50_000
WINDOW = 6 * 3600        # окно, секунды
ALERT_USD = 2_000_000    # порог суммы вводов за окно
CEX = ("binance", "okx", "bybit", "coinbase", "kraken")
deposits = {}            # tx_hash -> (ts, usd)
alerted = False

def to_exchange(row):
    label = (row.get("to_name") or "").lower()
    return any(name in label 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()
    for row in body["data"]:
        if row.get("tx_hash") and to_exchange(row):
            deposits[row["tx_hash"]] = (row.get("ts") or 0,
                                        row.get("usd") or 0)
    start = time.time() - WINDOW
    deposits = {h: v for h, v in deposits.items() if v[0] >= start}
    total = sum(usd for _, usd in deposits.values())
    print(f"{COIN}: на биржи за 6 ч ${total:,.0f}, "
          f"переводов {len(deposits)}")
    if total >= ALERT_USD and not alerted:
        print("Порог пройден: проверьте цену, OI и фандинг")
    alerted = total >= ALERT_USD
    time.sleep(body["meta"]["freshness_sec"])

Кортеж CEX — подстроки меток, дополните его биржами, где торгуется монета. Скрипт только считает и печатает: Genesis API ордеров не ставит, решение о сделке остаётся за вами.

Ответ на запрос с coin и min_usd приходит без ETag, поэтому каждый опрос списывает вызов. На Start пауза — 30 секунд, это 2 592 000 / 30 = 86 400 вызовов за 30 дней, или 4,32 % квоты в 2 млн. Для десятка монет берите ленту /onchain/cex-flows без фильтров и разбирайте её у себя: полный набор приходит с ETag, а повтор с If-None-Match на неизменённые данные вернёт 304 без списания.

Переводы ниже min_usd в подсчёт не попадут: серии мелких переводов одной монеты на одну биржу собраны в coin-traffic с полями direction, total_usd, count и window_hours.

Как читать ввод на биржу

Те же $2 050 000 в ARB, пришедшие на биржи за 6 часов, могут быть подготовкой к продаже, залогом под фьючерсы или перекладкой между своими счетами. По одной строке ленты сценарий не определить.

СценарийЧто ещё видноЧем проверить
Подготовка к продажеПродажи на DEX, цена слабеет/onchain/dex-swaps с side=sell
Залог под фьючерсыРастёт открытый интерес, меняется фандинг/market/open-interest, /funding/rates
Перекладка между своимиВстречный вывод с той же биржиfrom_name в cex-flows, эксплорер
Продажа команды или фондаОтправитель — кошелёк командыteam-wallets, unlocks

Сильнее одного события выглядит совпадение нескольких по одной монете: ввод на биржу, перевод с кошелька команды и близкий разлок. Их видно в одном ответе /onchain/coin/{symbol}, где рядом с событиями лежит блок cex с oi_usd и funding_8h. Эндпоинты /market/open-interest и /funding/rates из таблицы есть уже на Trial.

Другие данные рынка и выбор источника под задачу — в обзоре «API криптовалют».

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

Насколько точны метки адресов в ончейн-данных?

Метку ставят по признакам, владелец адреса её не подтверждает, поэтому полной точности нет. Чем больше переводов связывает адрес с известным кошельком, тем надёжнее вывод, а новые адреса чаще остаются без имени. Крупное событие проверяйте по ссылке на эксплорер.

Есть ли в Genesis API история ончейн-событий?

Глубокого архива нет. Самые длинные окна — 7 дней: period=7d у свапов и аналитики и сводка монеты за 7 дней, прошедшие разлоки отдаёт when=past. Долгую историю собирайте сами, сохраняя записи при каждом опросе по tx_hash или id.

Что значат статусы pending и final у свапов DEX?

Это поле facts — статус проверки записи. pending — свап опубликован, цену после него ещё ждут; publish и 30s — промежуточные этапы; final — запись проверена, цена через 30 секунд и 5 минут известна; unavailable — факт собрать не удалось. Пока статус не final, запись может исчезнуть, поэтому храните свапы по id или запрашивайте final=true.

Можно ли отслеживать китов через API бесплатно?

Сырые данные можно брать со своей ноды или публичного узла по JSON-RPC, но метки, суммы в долларах и пороги придётся строить самому. У Genesis API бесплатного тарифа нет: ончейн-разделы открыты с тарифа Start за $50 в месяц, свапы DEX и аналитика — с Pro за $100.