Genesis Arbitrage

Genesis Arbitrage · · 12 menit baca

Data on-chain Genesis API: transfer, arus, unlock, swap DEX

Ringkasan

  • Endpoint /onchain/{section} mengembalikan salah satu dari sembilan feed Genesis OnChain, dari transfer besar hingga peretasan, di paket Start, Pro, dan Max. Request ke /onchain tanpa section mengembalikan semua feed dalam satu objek.
  • Swap DEX besar, analitik 24 jam atau 7 hari, dan ringkasan koin 7 hari tersedia di paket Pro dan Max.
  • Label alamat adalah atribusi, bukan jaminan. Transfer ke exchange tidak selalu berarti penjualan, dan catatan swap bisa hilang setelah verifikasi.

Endpoint on-chain Genesis API mengembalikan data bagian Genesis OnChain: transfer token besar, deposit dan penarikan exchange, pergerakan dompet tim, posisi perp DEX, unlock token, claim, dan peretasan, plus swap besar di DEX. Setiap baris sudah memuat label pengirim dan penerima, jumlah dalam USD, dan tautan explorer. Ini cukup untuk melacak whale dan memantau arus exchange dari kode Anda sendiri, tanpa indexer blockchain sendiri.

Endpoint dan paket

EndpointYang dikembalikanPaket API
/onchain/{section}Salah satu dari sembilan bagian Genesis OnChainStart, Pro, Max
/onchainKesembilan bagian dalam satu objekStart, Pro, Max
/onchain/dex-swapsSwap DEX besarPro, Max
/onchain/analyticsAnalitik OnChain untuk 24 jam atau 7 hariPro, Max
/onchain/coin/{symbol}Ringkasan 7 hari untuk satu koinPro, Max

Di Trial, semua endpoint on-chain mengembalikan 403 plan_restricted. Kesegaran data adalah 30 dtk di Start, 10 dtk di Pro, dan 5 dtk di Max, dan nilai yang sama datang di meta.freshness_sec. Key dan request pertama dibahas di mulai cepat, kuota di limit Genesis API.

Sembilan bagian /onchain/{section}

sectionIsinyaBlok dasbor
large-transfersTransfer token besarLarge Transfers
cex-flowsDeposit ke dan penarikan dari exchangeCEX Deposits / Withdrawals
mint-bridgeMint token dan transfer bridgeMint / Bridge
team-walletsPergerakan dompet timTeam Transfers
perp-positionsPosisi besar di DEX perpetualPerp. DEX Positions
unlocksUnlock tokenUnlocks
claimsClaimClaims
coin-trafficRangkaian transfer satu koin ke satu tujuanCoin Traffic
hacksPeretasan dan exploitHacks / Exploits

Apa yang ditampilkan setiap blok dan sinyal apa yang perlu dicari dibahas di panduan dasbor Genesis OnChain, parameternya ada di dokumentasi. Request ke /onchain tanpa section mengembalikan objek di data: kuncinya nama bagian, nilainya baris bagian itu. Filter lalu berlaku untuk setiap bagian.

ParameterTipeFungsi
min_usdnumberJumlah event minimum, USD
coinstringBaris untuk satu koin; hacks tidak punya koin, jadi daftarnya kosong
whenstringHanya untuk unlocks: upcoming atau past
sectionstringBagian untuk request /onchain?section=…

Nilai when lain apa pun mengembalikan 400 bad_request. Di bawah ini bagian coin-traffic, satu item dari array 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",
      …
    }
  ]
}

Field bagian

Bagian large-transfers, cex-flows, mint-bridge, team-wallets, dan claims terdiri dari transfer; bagian lain punya field sendiri.

FieldDi manaArti
ts, linksSemua bagianWaktu event dalam detik unix dan tautan siap pakai: teks + url
token / token_nameTransfer, coin-trafficTicker token dan nama lengkapnya
chain / chain_name, usd / amountTransferJaringan, jumlah dalam USD dan dalam token
from_* / to_*TransferPengirim dan penerima: label, alamat, tautan explorer
tx_hash / explorer_url / arkham_urlTransferHash transaksi, tautan explorer dan Arkham
direction, target / target_addresscoin-trafficArah deposit, withdrawal, atau transfer dan tujuan arus
total_usd / count / window_hours, transfers[]coin-trafficTotal rangkaian, jumlah transfer, jendela dalam jam, dan transfer terbesar
side / size / price / platformperp-positionsLong atau Short, ukuran, harga, platform
unlock_percent / unlock_value_usd / hours_left / allocationsunlocksPorsi dan nilai unlock, sisa jam, alokasi
classification / technique / returned_fundshacksKlasifikasi, teknik serangan, dana yang dikembalikan

Swap DEX: /onchain/dex-swaps

Paket Pro dan Max. Endpoint ini mengembalikan feed swap besar, seperti layar DEX Overview: setiap swap menunjukkan berapa persen likuiditas pool yang diambilnya, pergerakan harga apa yang diperkirakan darinya, dan apa yang terjadi setelah 30 detik dan 5 menit. Skema respons ada di dokumentasi.

ParameterTipeFungsi
periodstringlive — 15 menit terakhir, default; 1h, 6h, 24h, atau 7d
chainstringJaringan
sidestringbuy atau sell
dexstringDEX; pisahkan dengan koma untuk beberapa
min_usdnumberJumlah swap minimum, USD
min_impactnumberDampak pool absolut minimum, %
finalbooleantrue — hanya swap terverifikasi
tokenstringTicker token
qstringPencarian di token, nama, alamat, trader, hash, DEX, dan jaringan
FieldTipeArti
idstringPengenal stabil: jaringan, transaksi, token
tierstringTier menurut likuiditas pool: dari T1 (30.000–100.000 $) hingga T4 (di atas 10 juta $)
pool_liquidity_usd / size_pct_liquidity / impact_est_pctnumber atau nullLikuiditas pool, porsi swap darinya, dan perkiraan dampak harga, %
price_after_30s_usd / price_after_5m_usd / move_after_5m_pctnumber atau nullHarga setelah 30 dtk dan 5 mnt serta pergerakan harga selama 5 menit setelah swap
factsstringStatus verifikasi: pending, publish, 30s, final, atau unavailable
trader_name / trader_addressstring atau nullLabel dan alamat trader

Pada contoh di bawah, swap 412.500 $ di pool dengan likuiditas 4.120.000 $ mengambil 412.500 / 4.120.000 × 100 = 10,01% pool. Perkiraan dampaknya 4,8%, dan setelah 5 menit harga bergerak 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"
}

Analitik OnChain: /onchain/analytics

Juga untuk Pro dan Max. Satu panggilan mengembalikan layar Genesis OnChain Analytics untuk period=24h (default) atau 7d, dengan total, bucket per jam, arus exchange, unlock, peretasan, koin yang menjadi sorotan, dan feed event. Semua field ada di dokumentasi.

FieldTipeArti
kpiobjectTotal: events, usd, tokens, cex_in, cex_out, cex_net
hourlyobjectBucket dengan langkah 1 jam untuk 24h dan 6 jam untuk 7d
exchange_flowsobjectPer exchange: in_usd, out_usd, net
tokensarrayHingga 40 koin yang menjadi sorotan dengan event terbesar dan konteks CEX
eventsarrayFeed event periode itu, hingga 600

cex_net adalah deposit dikurangi penarikan: pada contoh 312.456.789 − 287.654.321 = 24.802.468, jadi 24,8 juta $ lebih banyak masuk ke exchange daripada yang keluar.

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

Koin OnChain: /onchain/coin/{symbol}

Pro dan Max juga mendapat ringkasan 7 hari untuk satu koin, seperti halaman koin: event on-chain, swap DEX, unlock, dan konteks CEX. Ticker ditulis di path, 1 sampai 32 karakter, dan respons dibangun ulang paling sering sekali per 10 detik. Field ada di dokumentasi.

FieldTipeArti
cexobject atau nullHarga, OI, funding 8 jam, spread terbaik, jaringan, deposit dan penarikan; null jika koin tidak ada di CEX yang didukung
kpiobjectTotal 7 hari: events, cex_in, cex_out, swaps, dex_buy, dex_sell
by_sectionobjectJumlah event per bagian, dengan kunci seperti large_tx dan cex_deposits
events / swapsarrayEvent dan swap, hingga 2000; jumlah penuh di events_total dan swaps_total
unlocks.upcoming / unlocks.pastarrayUnlock yang akan datang dan yang sudah lewat
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
}

Contoh hipotetis: deposit koin ke exchange lewat cex-flows

Tujuannya mengetahui berapa banyak sebuah koin dipindahkan ke exchange selama satu jam terakhir dan mendapat notifikasi untuk setiap deposit besar. Di cex-flows, arah terlihat pada label: exchange di to_name berarti deposit, exchange di from_name berarti penarikan.

Dalam satu jam, ARB mengalami empat deposit: 412.000 $, 260.000 $, 180.000 $, dan 148.000 $, totalnya 412.000 $ + 260.000 $ + 180.000 $ + 148.000 $ = 1.000.000 $. Ada satu penarikan 150.000 $. Arus bersih ke exchange adalah 1.000.000 $ − 150.000 $ = 850.000 $: yang masuk lebih banyak daripada yang keluar. Beginilah baris hipotetis deposit pertama:

{
  "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. Tentukan koin dan ambang batas

    coin dan min_usd menjaga transfer besar satu koin tetap ada di respons.

  2. Pisahkan deposit dari penarikan

    Exchange di to_name adalah deposit, di from_name penarikan. Cocokkan label berdasarkan substring, tanpa membedakan huruf besar-kecil.

  3. Hitung jendela dan transfer baru

    Jumlahkan baris satu jam terakhir berdasarkan ts, dan beri notifikasi hanya untuk nilai tx_hash baru.

  4. Polling sesuai kesegaran paket Anda

    Beri jeda meta.freshness_sec antar request; pada 429 dan 503, tunggu Retry-After detik.

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")  # substring label
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 atau pembangunan ulang
        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")):  # deposit ke exchange
            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")):  # penarikan
            outflow += usd
    print(f"satu jam terakhir: ke exchange ${inflow:,.0f}, "
          f"arus bersih ${inflow - outflow:,.0f}")
    time.sleep(body["meta"]["freshness_sec"])

Skrip ini hanya membaca data dan mencetak notifikasi; apa yang dilakukan dengan koin itu adalah keputusan Anda. Rangkaian transfer kecil ke satu exchange dikelompokkan di bagian coin-traffic, tempat arahnya sudah ada di field direction. Total untuk semua koin datang dari /onchain/analytics di kpi.cex_in, kpi.cex_out, dan kpi.cex_net, dan ikhtisar kasus penggunaan data on-chain ada di artikel API data on-chain.

Tanya jawab

Paket apa yang saya butuhkan untuk data on-chain?

Sembilan bagian /onchain/{section} terbuka di Start, Pro, dan Max. Swap DEX, analitik, dan ringkasan koin hanya untuk Pro dan Max, dan di Trial endpoint on-chain mengembalikan 403 plan_restricted.

Apakah ada riwayat lebih dari 7 hari?

Jendela terpanjang adalah period=7d untuk swap dan analitik serta 7 hari di ringkasan koin; Genesis API tidak punya arsip terpisah. Untuk riwayat panjang, simpan sendiri catatannya pada setiap polling.

Mengapa swap menghilang dari respons?

Verifikasi menemukan pengaturan ulang likuiditas, bukan perdagangan, dan catatannya dihapus. Cocokkan swap tersimpan berdasarkan id atau minta hanya final=true.

Bagaimana cara mendapat unlock token yang akan datang?

Minta /onchain/unlocks?when=upcoming. Setiap baris punya unlock_percent dan unlock_value_usd, porsi dan nilai unlock, serta hours_left, sisa jam hingga unlock. min_usd menetapkan ambang nilai, coin memilih satu koin.