Genesis Arbitrage

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

Ончейн в 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 OnChainStart, Pro, Max
/onchainВсе девять разделов одним объектомStart, Pro, Max
/onchain/dex-swapsКрупные свапы DEXPro, Max
/onchain/analyticsАналитика OnChain за 24h или 7dPro, 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 DEXPerp. DEX позиции
unlocksРазлоки токеновАнлоки
claimsКлеймыКлеймы
coin-trafficСерии переводов одной монеты на одну цельДвижения монет
hacksВзломы и эксплойтыВзломы / Эксплойты

Что показывает каждый блок и какие сигналы в нём искать, описано в инструкции «Дашборд Genesis OnChain», параметры — в документации. Запрос /onchain без раздела возвращает в data объект: ключ — имя раздела, значение — его строки. Фильтры при этом применяются к каждому разделу.

ПараметрТипЧто делает
min_usdnumberМинимальная сумма события, USD
coinstringСтроки одной монеты; у hacks монеты нет, список будет пустым
whenstringТолько для unlocks: upcoming — предстоящие, past — прошедшие
sectionstringРаздел для запроса /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_addresscoin-trafficНаправление deposit, withdrawal или transfer и цель потока
total_usd / count / window_hours, transfers[]coin-trafficСумма серии, число переводов, окно в часах и крупнейшие переводы
side / size / price / platformperp-positionsLong или Short, размер, цена, площадка
unlock_percent / unlock_value_usd / hours_left / allocationsunlocksДоля и стоимость разлока, часов до него, распределение
classification / technique / returned_fundshacksКлассификация, техника атаки, возвращённые средства

Свапы DEX: /onchain/dex-swaps

Тарифы Pro и Max. Эндпоинт отдаёт ленту крупных свапов, как экран «Обзор DEX»: у каждого свапа видно, какую долю ликвидности пула он забрал, какого хода цены от него ждать и что случилось через 30 секунд и 5 минут. Схема ответа — в документации.

ПараметрТипЧто делает
periodstringlive — последние 15 минут, по умолчанию; 1h, 6h, 24h или 7d
chainstringСеть
sidestringbuy или sell
dexstringDEX; несколько — через запятую
min_usdnumberМинимальная сумма свапа, USD
min_impactnumberМинимальное влияние на пул по модулю, %
finalbooleantrue — только проверенные свапы
tokenstringТикер токена
qstringПоиск по токену, имени, адресам, трейдеру, хэшу, DEX и сети
ПолеТипЧто значит
idstringПостоянный идентификатор: сеть, транзакция, токен
tierstringЯрус по ликвидности пула: от T1 ($30 000–100 000) до T4 (больше $10 млн)
pool_liquidity_usd / size_pct_liquidity / impact_est_pctnumber или nullЛиквидность пула, доля свапа в ней и оценка влияния на цену, %
price_after_30s_usd / price_after_5m_usd / move_after_5m_pctnumber или nullЦена через 30 с и 5 мин и ход цены за 5 минут после свапа
factsstringСтатус проверки: pending, publish, 30s, final или unavailable
trader_name / trader_addressstring или 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 — итоги, почасовые корзины, потоки по биржам, разлоки, взломы, монеты в фокусе и ленту событий. Все поля — в документации.

ПолеТипЧто значит
kpiobjectИтоги: events, usd, tokens, cex_in, cex_out, cex_net
hourlyobjectКорзины с шагом 1 ч для 24h и 6 ч для 7d
exchange_flowsobjectПо каждой бирже: in_usd, out_usd, net
tokensarrayДо 40 монет в фокусе с крупнейшим событием и контекстом CEX
eventsarrayЛента событий периода, до 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 секунд. Поля — в документации.

ПолеТипЧто значит
cexobject или nullЦена, OI, фандинг за 8 часов, лучший спред, сети, ввод и вывод; null — монеты нет на поддерживаемых CEX
kpiobjectИтоги за 7 дней: события, cex_in, cex_out, свапы, dex_buy, dex_sell
by_sectionobjectЧисло событий по разделам с ключами вида large_tx, cex_deposits
events / swapsarrayСобытия и свапы, до 2000; общее число — events_total и swaps_total
unlocks.upcoming / unlocks.pastarrayПредстоящие и прошедшие разлоки
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…"
}
  1. Задайте монету и порог

    coin и min_usd оставят в ответе крупные переводы одной монеты.

  2. Отделите вводы от выводов

    Биржа в to_name — ввод, в from_name — вывод. Метки сравнивайте по подстроке без учёта регистра.

  3. Считайте окно и новые переводы

    Суммируйте строки за последний час по ts, а уведомление отправляйте только по новым tx_hash.

  4. Опрашивайте с частотой тарифа

    Пауза между запросами — 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.