Genesis Arbitrage

Genesis Arbitrage · · 12 dk okuma

Genesis API zincir üstü verisi: transferler, akışlar, unlock'lar, DEX swap'ları

Kısaca

  • /onchain/{section} endpoint'i, büyük transferlerden hack'lere kadar dokuz Genesis OnChain akışının her birini Start, Pro ve Max planlarında döndürür. Bölümsüz /onchain isteği tüm akışları tek nesnede verir.
  • Büyük DEX swap'ları, 24 saatlik veya 7 günlük analitik ve coin için 7 günlük özet Pro ve Max planlarında açıktır.
  • Adres etiketleri bir atıftır, garanti değildir. Borsaya transfer her zaman satış anlamına gelmez, swap kaydı da doğrulamadan sonra silinebilir.

Genesis API'nin zincir üstü endpoint'leri Genesis OnChain bölümünün verisini döndürür: büyük token transferleri, borsalara para yatırma ve borsalardan çekme, ekip cüzdanı hareketleri, sürekli vadeli DEX pozisyonları, token unlock'ları, claim'ler ve hack'ler; ayrıca DEX üzerindeki büyük swap'lar. Her satırda gönderen ve alıcı etiketleri, USD tutarı ve explorer bağlantıları hazır gelir. Kendi blockchain indexer'ınızı kurmadan, kendi kodunuzdan balina takibi ve borsa akışı izlemesi için bu yeterlidir.

Endpoint'ler ve planlar

EndpointNe döndürürAPI planları
/onchain/{section}Dokuz Genesis OnChain bölümünden biriStart, Pro, Max
/onchainDokuz bölümün tamamı tek nesnedeStart, Pro, Max
/onchain/dex-swapsBüyük DEX swap'larıPro, Max
/onchain/analytics24 saatlik veya 7 günlük OnChain analitiğiPro, Max
/onchain/coin/{symbol}Tek bir coin için 7 günlük özetPro, Max

Trial planında tüm zincir üstü endpoint'ler 403 plan_restricted döndürür. Veri tazeliği Start'ta 30 sn, Pro'da 10 sn, Max'te 5 sn'dir; aynı değer meta.freshness_sec alanında da gelir. Anahtar ve ilk istek hızlı başlangıç bölümünde, kotalar Genesis API limitleri bölümünde anlatılır.

/onchain/{section} için dokuz bölüm

sectionİçeriğiPanel bloğu
large-transfersBüyük token transferleriLarge Transfers
cex-flowsBorsalara para yatırma ve borsalardan çekmeCEX Deposits / Withdrawals
mint-bridgeToken mint'i ve köprü transferleriMint / Bridge
team-walletsEkip cüzdanı hareketleriTeam Transfers
perp-positionsSürekli vadeli DEX'lerdeki büyük pozisyonlarPerp. DEX Positions
unlocksToken unlock'larıUnlocks
claimsClaim'lerClaims
coin-trafficBir coinin tek hedefe yönelik transfer serileriCoin Traffic
hacksHack'ler ve exploit'lerHacks / Exploits

Her bloğun ne gösterdiği ve hangi sinyallere bakılacağı Genesis OnChain panel rehberinde, parametreler dokümantasyonda anlatılır. Bölümsüz /onchain isteği data içinde bir nesne döndürür: anahtar bölüm adıdır, değer o bölümün satırlarıdır. Filtreler bu durumda tüm bölümlere uygulanır.

ParametreTürNe yapar
min_usdnumberMinimum olay tutarı, USD
coinstringTek bir coinin satırları; hacks bölümünde coin yoktur, bu yüzden liste boş döner
whenstringYalnızca unlocks için: upcoming veya past
sectionstring/onchain?section=… isteği için bölüm

when için başka herhangi bir değer 400 bad_request döndürür. Aşağıda coin-traffic bölümü ve data dizisinin bir öğesi var:

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",
      …
    }
  ]
}

Bölüm alanları

large-transfers, cex-flows, mint-bridge, team-wallets ve claims bölümleri transferlerden oluşur; diğerlerinin kendi alanları vardır.

AlanlarNeredeAnlamı
ts, linksTüm bölümlerUnix saniyesi olarak olay zamanı ve hazır bağlantılar: metin + url
token / token_nameTransferler, coin-trafficToken ticker'ı ve tam adı
chain / chain_name, usd / amountTransferlerAğ, USD ve token cinsinden tutar
from_* / to_*TransferlerGönderen ve alıcı: etiket, adres, explorer bağlantısı
tx_hash / explorer_url / arkham_urlTransferlerİşlem hash'i, explorer ve Arkham bağlantıları
direction, target / target_addresscoin-trafficdeposit, withdrawal veya transfer yönü ve akışın hedefi
total_usd / count / window_hours, transfers[]coin-trafficSerinin toplamı, transfer sayısı, saat cinsinden pencere ve en büyük transferler
side / size / price / platformperp-positionsLong veya Short, büyüklük, fiyat, platform
unlock_percent / unlock_value_usd / hours_left / allocationsunlocksUnlock payı ve değeri, kalan saat, tahsisler
classification / technique / returned_fundshacksSınıflandırma, saldırı tekniği, iade edilen fonlar

DEX swap'ları: /onchain/dex-swaps

Pro ve Max planları. Endpoint, DEX Overview ekranındaki gibi büyük swap'ların akışını döndürür: her swap'ta havuzun likiditesinin ne kadarını aldığı, ondan hangi fiyat hareketinin beklendiği ve 30 saniye ile 5 dakika sonra ne olduğu görünür. Yanıt şeması dokümantasyondadır.

ParametreTürNe yapar
periodstringlive — son 15 dakika, varsayılan; 1h, 6h, 24h veya 7d
chainstringAğ
sidestringbuy veya sell
dexstringDEX; birden fazlası için virgülle ayırın
min_usdnumberMinimum swap tutarı, USD
min_impactnumberMinimum mutlak havuz etkisi, %
finalbooleantrue — yalnızca doğrulanmış swap'lar
tokenstringToken ticker'ı
qstringToken, ad, adresler, trader, hash, DEX ve ağ içinde arama
AlanTürAnlamı
idstringKalıcı tanımlayıcı: ağ, işlem, token
tierstringHavuz likiditesine göre kademe: T1 (30.000–100.000 $) ile T4 (10 milyon $ üzeri) arası
pool_liquidity_usd / size_pct_liquidity / impact_est_pctnumber veya nullHavuz likiditesi, swap'ın bunun içindeki payı ve tahmini fiyat etkisi, %
price_after_30s_usd / price_after_5m_usd / move_after_5m_pctnumber veya null30 sn ve 5 dk sonraki fiyat ile swap'tan sonraki 5 dakikada fiyat hareketi
factsstringDoğrulama durumu: pending, publish, 30s, final veya unavailable
trader_name / trader_addressstring veya nullTrader etiketi ve adresi

Aşağıdaki örnekte, 4.120.000 $ likiditeli bir havuzda 412.500 $'lık swap havuzun 412.500 / 4.120.000 × 100 = %10,01'ini almıştır. Tahmini etki %4,8, 5 dakika sonra fiyat %1,9 hareket etmiştir.

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 analitiği: /onchain/analytics

Bu da Pro ve Max planlarında. Tek çağrı, Genesis OnChain Analytics ekranını period=24h (varsayılan) veya 7d için döndürür: toplamlar, saatlik gruplar, borsa akışları, unlock'lar, hack'ler, odaktaki coinler ve olay akışı. Tüm alanlar dokümantasyondadır.

AlanTürAnlamı
kpiobjectToplamlar: events, usd, tokens, cex_in, cex_out, cex_net
hourlyobject24h için 1 saat, 7d için 6 saat adımlı gruplar
exchange_flowsobjectBorsa başına: in_usd, out_usd, net
tokensarrayEn büyük olay ve CEX bağlamıyla odaktaki en fazla 40 coin
eventsarrayDönemin olay akışı, en fazla 600

cex_net, yatırılanlar eksi çekilenlerdir: örnekte 312.456.789 − 287.654.321 = 24.802.468, yani borsalara çıkanlardan 24,8 milyon $ fazla girmiştir.

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 coin: /onchain/coin/{symbol}

Pro ve Max planları ayrıca coin sayfasındaki gibi tek bir coin için 7 günlük özet alır: zincir üstü olaylar, DEX swap'ları, unlock'lar ve CEX bağlamı. Ticker yolda verilir, 1 ile 32 karakter arasındadır; yanıt en fazla 10 saniyede bir yeniden oluşturulur. Alanlar dokümantasyondadır.

AlanTürAnlamı
cexobject veya nullFiyat, OI, 8 saatlik fonlama, en iyi spread, ağlar, para yatırma ve çekme; coin desteklenen CEX'lerde yoksa null
kpiobject7 günlük toplamlar: events, cex_in, cex_out, swaps, dex_buy, dex_sell
by_sectionobjectBölümlere göre olay sayıları; large_tx ve cex_deposits gibi anahtarlarla
events / swapsarrayOlaylar ve swap'lar, en fazla 2000; tam sayılar events_total ve swaps_total içinde
unlocks.upcoming / unlocks.pastarrayYaklaşan ve geçmiş unlock'lar
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
}

Varsayımsal örnek: cex-flows ile bir coinin borsalara yatırılması

Amaç, son bir saatte bir coinin borsalara ne kadarının taşındığını bilmek ve her büyük para yatırma için bildirim almaktır. cex-flows bölümünde yön etiketlerde görünür: to_name içindeki borsa para yatırma, from_name içindeki borsa para çekme demektir.

Bir saatte ARB için dört para yatırma görüldü: 412.000 $, 260.000 $, 180.000 $ ve 148.000 $; toplam 412.000 $ + 260.000 $ + 180.000 $ + 148.000 $ = 1.000.000 $. Bir de 150.000 $'lık para çekme oldu. Borsalara net akış 1.000.000 $ − 150.000 $ = 850.000 $: giren, çıkandan fazla. İlk para yatırmanın varsayımsal satırı şöyle görünür:

{
  "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. Coini ve eşiği belirleyin

    coin ve min_usd, yanıtta tek bir coinin büyük transferlerini tutar.

  2. Para yatırmayı para çekmeden ayırın

    to_name içindeki borsa para yatırmadır, from_name içindeki para çekme. Etiketleri büyük/küçük harfe bakmadan alt dize olarak eşleştirin.

  3. Pencereyi ve yeni transferleri sayın

    Son saatin satırlarını ts ile toplayın, yalnızca yeni tx_hash değerlerinde bildirim gönderin.

  4. Planınızın tazeliğinde sorgulayın

    İstekler arasında meta.freshness_sec kadar bekleyin; 429 ve 503 durumunda Retry-After saniye bekleyin.

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")  # etiket alt dizeleri
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):  # rate limit veya yeniden oluşturma
        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")):  # borsaya para yatırma
            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")):  # para çekme
            outflow += usd
    print(f"son bir saat: borsalara ${inflow:,.0f}, "
          f"net akış ${inflow - outflow:,.0f}")
    time.sleep(body["meta"]["freshness_sec"])

Betik yalnızca veri okur ve bildirim yazdırır; coinle ne yapacağınız sizin kararınızdır. Bir borsaya giden küçük transfer serileri coin-traffic bölümünde gruplanır; orada yön zaten direction alanındadır. Tüm coinlerin toplamları /onchain/analytics içinde kpi.cex_in, kpi.cex_out ve kpi.cex_net alanlarından gelir; zincir üstü veri kullanım senaryolarının genel bir özeti zincir üstü veri API'si makalesindedir.

Sorular ve cevaplar

Zincir üstü veri için hangi plan gerekir?

/onchain/{section} altındaki dokuz bölüm Start, Pro ve Max'te açıktır. DEX swap'ları, analitik ve coin özeti yalnızca Pro ve Max'tedir; Trial'da zincir üstü endpoint'ler 403 plan_restricted döndürür.

7 günden uzun geçmiş var mı?

En uzun pencereler swap'lar ve analitik için period=7d ile coin özetindeki 7 gündür; Genesis API'de ayrı bir arşiv yoktur. Uzun geçmiş için kayıtları her sorguda kendiniz saklayın.

Bir swap neden yanıttan kayboldu?

Doğrulamada işlemin yerine bir likidite yeniden dağıtımı bulundu ve kayıt silindi. Kayıtlı swap'ları id ile eşleştirin veya yalnızca final=true isteyin.

Yaklaşan token unlock'ları nasıl alınır?

/onchain/unlocks?when=upcoming isteğini gönderin. Her satırda unlock'ın payı ve değeri olan unlock_percent ile unlock_value_usd, ona kalan saati gösteren hours_left bulunur. min_usd değer eşiğini belirler, coin tek bir coini seçer.