Genesis Arbitrage

Genesis Arbitrage · · 15 menit baca

API data on-chain: transfer whale, arus exchange, dan unlock token

Ringkasan

  • API data on-chain mengembalikan event blockchain yang sudah didekode: token apa yang berpindah, dari siapa, ke siapa, dan senilai berapa dolar. Data mentah datang dari node, indexer mengubahnya menjadi tabel, dan label alamat tetap berupa atribusi yang bisa salah.
  • Trader memantau deposit dan penarikan exchange, transfer besar, pergerakan wallet tim, posisi perp DEX, unlock, claim, hack, dan swap DEX besar. Deposit ke exchange tidak selalu berujung pada penjualan.
  • Di Genesis API, sembilan bagian on-chain tersedia mulai paket Start, sedangkan swap DEX, analitik, dan ringkasan koin memerlukan Pro atau Max. Kode Anda yang menghitung jendela waktu dan total arus, karena bagian-bagian ini tidak punya parameter waktu.

API data on-chain adalah antarmuka HTTP ke event blockchain yang sudah dikumpulkan, dikonversi ke dolar, dan diberi label: token apa yang berpindah, dari alamat mana, ke alamat mana, dan lewat transaksi yang mana. Dengan API seperti ini Anda bisa melacak transfer whale, deposit ke exchange, unlock token, dan swap besar di DEX tanpa menjalankan node atau indexer sendiri. Whale di sini adalah alamat yang memegang koin dalam jumlah cukup besar sehingga transfernya bisa menggerakkan pasar.

Dari mana data on-chain berasal

Data melewati tiga lapisan: node menyimpan blok, indexer mengubahnya menjadi baris event, dan database label memberi nama pada alamat.

Node: blok dan log

Node blockchain menyimpan blok dan menyajikannya lewat JSON-RPC. Di Ethereum dan chain yang kompatibel, transfer token ERC-20 ditulis ke log transaksi sebagai event Transfer(address indexed _from, address indexed _to, uint256 _value), dan standar menyarankan event yang sama dipancarkan dengan 0x0 sebagai pengirim saat token baru dicetak (EIP-20).

Metode eth_getLogs mengembalikan log yang cocok dengan filter: rentang blok fromBlock dan toBlock, address kontrak, dan topics event (Ethereum JSON-RPC). Sebuah log berisi alamat, nomor blok, hash transaksi, dan jumlah dalam satuan terkecil token. Blok tidak memuat harga dolar, nama pemilik, maupun penanda exchange.

Indexer: dari log ke tabel

Indexer membaca blok secara berurutan, mendekode event, dan memilahnya ke dalam tabel: transfer, swap, perubahan pool. Indexer membagi jumlah dengan 10 pangkat decimals token (dengan delapan desimal, berarti dibagi 100.000.000) dan mengalikannya dengan harga pada waktu blok, yang menghasilkan nilai dolar.

Lalu ada threshold: feed hanya menyimpan transfer di atas jumlah tertentu, dan rangkaian transfer kecil ke satu alamat digabung menjadi satu baris. Membangun pipeline seperti itu untuk beberapa chain adalah proyek tersendiri, sedangkan API data on-chain mengembalikan hasilnya dalam satu request.

Label alamat: siapa di balik sebuah alamat

Label adalah nama yang dilekatkan pada alamat: "Binance", "kas proyek", "market maker". Label ditetapkan berdasarkan bukti: alamat meneruskan koin ke wallet exchange yang dikenal, proyek sendiri yang mempublikasikan alamatnya, alamat menerima token dari kontrak vesting. Pemilik tidak mengonfirmasi satu pun dari ini, jadi label bisa usang atau sekadar salah.

Alamat tanpa bukti tetap tanpa nama: pada contoh di dokumentasi Genesis API, pengirim seperti itu tampil dengan alamat yang dipersingkat, 0xec01…d1a5.

Event on-chain apa yang penting bagi trader

Contoh hipotetis: dalam satu pagi, koin sebuah proyek senilai $2.000.000 masuk ke exchange, dan $500.000 keluar dari wallet tim ke alamat market maker. Masing-masing event sendirian tidak berarti banyak; bersama-sama, keduanya jadi alasan untuk memeriksa harga, open interest, dan jadwal unlock.

EventYang terlihatCara membacanya
Deposit ke exchangeKoin tiba di alamat exchangeKemungkinan jual, jaminan, atau pemindahan
Penarikan dari exchangeKoin keluar ke alamat eksternalPenyimpanan, DeFi, atau exchange lain
Transfer besarTransfer di atas threshold antar alamatWhale memindahkan posisinya
Wallet timPergerakan dari alamat foundation, treasury, atau pendiriDeposit ke exchange lebih berbobot daripada pemindahan internal
Posisi perp DEXLong atau short: ukuran, harga, platformTaruhan whale dan risiko likuidasi
UnlockTanggal, porsi, dan nilai rilisSuplai baru koin
ClaimToken dari airdrop, vesting, rewardPenerima bisa langsung menjual
Mint dan bridgePenerbitan token, perpindahan antar chainPencetakan stablecoin berarti uang masuk
HackProtokol, kerugian, teknik seranganRisiko bagi token dan chain terkait
Swap DEXSisi, jumlah, porsi pool, pergerakan hargaPergeseran harga sebelum exchange bereaksi

Posisi di exchange terdesentralisasi untuk perpetual futures, yaitu perp DEX, terlihat karena platform ini membuka datanya. Di Hyperliquid, endpoint info POST https://api.hyperliquid.xyz/info dengan request clearinghouseState mengembalikan posisi terbuka dan margin dari alamat mana pun, tanpa key (dokumentasi Hyperliquid). CEX tidak mempublikasikan posisi trader lain; mereka memberikan angka agregat seperti open interest.

Unlock adalah rilis token tim, investor, atau foundation sesuai jadwal vesting, yang membagikannya dalam beberapa tahap menurut jadwal tertentu. Tanggalnya diketahui sebelumnya, sehingga pasar bisa memperhitungkan tekanan jual sebelum event terjadi.

Swap DEX menggeser harga pool dalam blok yang sama. Contoh hipotetis: pembelian $150.000 di pool dengan likuiditas $1.200.000 mengambil 150.000 / 1.200.000 × 100 = 12,5% dari pool. Harga pool bergeser cukup terasa, sementara di exchange pergerakannya baru terlihat belakangan atau tidak sama sekali. Perbandingan harga DEX dan CEX dibahas di artikel API DEX.

Hack terlihat on-chain sebagai transfer keluar dari kontrak sebuah protokol. Bridge lebih sering diserang daripada protokol lain karena kontraknya menyimpan dana besar: kasus-kasus penting ada di artikel bridge blockchain, dan pencurian dari exchange ada di ulasan hack Bybit.

Latensi dan konfirmasi

Antara sebuah transaksi dan baris di kode Anda ada jeda detik hingga menit; ini adalah latensi data. Hampir tidak berpengaruh untuk ikhtisar arus harian, tetapi menentukan hasilnya saat Anda bereaksi terhadap satu deposit atau swap besar.

Konfirmasi jaringan

Di Ethereum, blok baru bisa muncul sekali per slot, yaitu setiap 12 detik, dan menjadi final setelah sekitar 15 menit (ethereum.org). Blok yang sudah final tidak bisa diubah kecuali sejumlah besar ETH hilang. Indexer yang hanya butuh gambaran yang sudah mapan bisa membaca blok sampai tag finalized, nama yang dipakai node untuk blok final terbaru.

Exchange mengkredit deposit setelah transaksi mencapai jumlah konfirmasi jaringan minimum, dan di Binance, misalnya, minimum itu berbeda untuk setiap koin (FAQ Binance). Jadi deposit ke exchange terlihat on-chain sebelum pemiliknya bisa menjual koin tersebut.

Delay data

Pada contoh swap di dokumentasi Genesis API, ts = 1794675511 adalah waktu swap dan published_at = 1794675523 adalah waktu publikasi: selisih 1794675523 − 1794675511 = 12 detik. Ditambah lagi kesegaran data paket Anda di meta.freshness_sec (30 detik di Start, 10 di Pro, 5 di Max) dan interval polling Anda.

TahapBerapa lamaArtinya
Blok Ethereumslot 12 dtkTransaksi terlihat tetapi belum final
Finality Ethereumsekitar 15 mntBlok tidak akan berubah lagi
Kredit di exchangeminimum konfirmasi exchangeBerbeda untuk setiap koin
Publikasi swap12 dtk pada contohRecord belum berstatus final
Status finalpaling cepat 5 mnt setelah swapHarga setelah 30 dtk dan 5 mnt sudah diketahui
Pengiriman Genesis API30, 10, atau 5 dtkPaket Start, Pro, dan Max

Untuk swap, feed period=live dengan record yang belum diverifikasi lebih cepat, tetapi sebuah record bisa menghilang jika swap ternyata hanya pemindahan likuiditas. Parameter final=true hanya menyimpan swap yang sudah diverifikasi, yang tiba minimal 5 menit lebih lambat.

Data on-chain di Genesis API

Genesis API mengembalikan feed bagian Genesis OnChain: baris transfer sudah membawa label pengirim dan penerima, jumlah dalam dolar dan token, hash transaksi, dan tautan explorer. Request-nya berupa HTTP GET dengan key di header X-API-Key, dan responsnya adalah JSON dengan field data dan blok meta.

EndpointYang dikembalikanPaket
/onchain/{section}Salah satu dari 9 bagian on-chainStart, Pro, Max
/onchainSemua 9 bagian dalam satu objekStart, Pro, Max
/onchain/dex-swapsSwap DEX besarPro, Max
/onchain/analyticsTotal untuk 24h atau 7dPro, Max
/onchain/coin/{symbol}Ringkasan koin 7 hariPro, Max

Bagian-bagian ini dinamai menurut feed-nya: large-transfers, cex-flows, mint-bridge, team-wallets, perp-positions, unlocks, claims, hacks, dan coin-traffic, yang memuat rangkaian transfer satu koin ke satu tujuan. Filternya adalah min_usd dan coin, ditambah when dengan upcoming atau past untuk unlock. Tidak ada parameter waktu, jadi jendela dihitung dari field ts.

Request untuk unlock token yang akan datang dengan nilai di atas $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"

Baris unlock memiliki unlock_percent dan unlock_value_usd (porsi dan nilai), hours_left (jam hingga event), dan allocations (rincian per penerima).

Pro dan Max menambah tiga endpoint. /onchain/dex-swaps mengembalikan swap besar beserta porsi likuiditas pool, perkiraan dampak harga, dan pergerakan harga setelah 30 detik dan 5 menit (ikhtisar DEX di dokumentasi). /onchain/analytics menghitung total untuk 24h atau 7d: kpi.cex_in, kpi.cex_out, kpi.cex_net, dan arus per exchange (analitik OnChain). /onchain/coin/{symbol} mengumpulkan event, swap, dan unlock sebuah koin selama 7 hari beserta harga CEX, OI, dan funding-nya (koin OnChain).

Hanya respons 200 yang memakai kuota, dan di Trial endpoint on-chain mengembalikan 403 plan_restricted. Start berharga $50 per bulan untuk 2M panggilan, Pro $100 untuk 5M, Max $200 untuk 10M (harga Genesis API). Setiap parameter dan field, lengkap dengan contoh respons, ada di panduan endpoint on-chain.

Tanpa kode, feed yang sama ada di dasbor Genesis OnChain, swap di Ikhtisar DEX, serta total harian dan mingguan di Analitik OnChain.

Python: deposit exchange sebuah koin dalam satu jendela

Contoh hipotetis: dalam 6 jam, lima transfer ARB tiba di exchange, senilai $640.000, $520.000, $410.000, $330.000, dan $150.000. Totalnya 640.000 + 520.000 + 410.000 + 330.000 + 150.000 = 2.050.000, sehingga threshold $2.000.000 terlewati. Begitu transfer pertama berumur lebih dari 6 jam, transfer itu keluar dari jendela: 2.050.000 − 640.000 = 1.410.000, dan total kembali turun di bawah threshold.

cex-flows tidak punya field direction, jadi arah ditentukan dari label: exchange di to_name berarti deposit, exchange di from_name berarti penarikan. Responsnya adalah feed terkini dari bagian tersebut, jadi skrip menyimpan deposit berdasarkan tx_hash dan membuang yang lama sendiri. Dengan begitu total jendela tidak terhitung ganda di antara polling.

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        # jendela, detik
ALERT_USD = 2_000_000    # total deposit yang memicu alert
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):  # rate limit atau pembangunan ulang
        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}: ke exchange dalam 6 jam ${total:,.0f}, "
          f"transfer {len(deposits)}")
    if total >= ALERT_USD and not alerted:
        print("Threshold terlewati: periksa harga, OI, dan funding")
    alerted = total >= ALERT_USD
    time.sleep(body["meta"]["freshness_sec"])

Tuple CEX berisi potongan teks label; tambahkan exchange tempat koin tersebut diperdagangkan. Skrip hanya menghitung dan mencetak: Genesis API tidak menempatkan order, dan keputusan trading tetap di tangan Anda.

Respons untuk request dengan coin dan min_usd datang tanpa ETag, jadi setiap polling memakai satu panggilan. Di Start dengan jeda 30 detik, itu 2.592.000 / 30 = 86.400 panggilan dalam 30 hari, atau 4,32% dari kuota 2M. Untuk selusin koin, ambil feed /onchain/cex-flows tanpa filter dan pisahkan sendiri: set lengkapnya datang dengan ETag, dan permintaan ulang dengan If-None-Match pada data yang tidak berubah mengembalikan 304 tanpa memakai kuota.

Transfer di bawah min_usd tidak akan terhitung: rangkaian transfer kecil satu koin ke satu exchange dikelompokkan di coin-traffic, dengan field direction, total_usd, count, dan window_hours.

Cara membaca deposit ke exchange

ARB senilai $2.050.000 yang sama yang tiba di exchange dalam 6 jam bisa berupa persiapan menjual, jaminan untuk futures, atau pemindahan antar akun milik pemiliknya sendiri. Satu baris feed tidak akan memberi tahu yang mana.

SkenarioApa lagi yang terlihatCara memeriksa
Bersiap menjualPenjualan di DEX, harga melemah/onchain/dex-swaps dengan side=sell
Jaminan futuresOpen interest naik, funding berubah/market/open-interest, /funding/rates
Pemindahan internalPenarikan yang sepadan dari exchange yang samafrom_name di cex-flows, explorer
Penjualan tim atau danaPengirimnya wallet timteam-wallets, unlocks

Beberapa event pada satu koin lebih berbobot daripada satu event saja: deposit ke exchange, transfer dari wallet tim, dan unlock yang akan datang. Semuanya terlihat dalam satu respons /onchain/coin/{symbol}, tempat event berdampingan dengan blok cex yang berisi oi_usd dan funding_8h. Endpoint /market/open-interest dan /funding/rates dari tabel tersedia sejak Trial.

Data pasar lainnya dan cara memilih sumber untuk suatu tugas dibahas di ikhtisar API kripto.

Tanya jawab

Seberapa akurat label alamat dalam data on-chain?

Label ditetapkan berdasarkan bukti dan pemilik alamat tidak mengonfirmasinya, jadi akurasi penuh tidak mungkin. Semakin banyak transfer yang menghubungkan sebuah alamat dengan wallet yang dikenal, semakin andal kesimpulannya, dan alamat baru lebih sering tetap tanpa nama. Periksa setiap event besar lewat tautan explorer.

Apakah Genesis API punya riwayat on-chain?

Tidak ada arsip yang dalam. Jendela terpanjang adalah 7 hari: period=7d untuk swap dan analitik serta ringkasan koin 7 hari, sedangkan unlock yang sudah lewat berasal dari when=past. Bangun riwayat panjang sendiri dengan menyimpan record pada setiap polling berdasarkan tx_hash atau id.

Apa arti status pending dan final pada swap DEX?

Itu adalah field facts, status verifikasi record. pending berarti swap sudah dipublikasikan dan harga setelahnya masih ditunggu; publish dan 30s adalah tahap perantara; final berarti record sudah diverifikasi dan harga setelah 30 detik dan 5 menit sudah diketahui; unavailable berarti fakta tidak berhasil dikumpulkan. Sampai statusnya final, sebuah record bisa menghilang, jadi simpan swap berdasarkan id atau minta final=true.

Bisakah saya melacak whale dengan API secara gratis?

Anda bisa mengambil data mentah dari node sendiri atau endpoint publik lewat JSON-RPC, tetapi label, jumlah dolar, dan threshold harus Anda bangun sendiri. Genesis API tidak punya paket gratis: bagian on-chain dimulai dari paket Start seharga $50 per bulan, sedangkan swap DEX dan analitik dari Pro seharga $100.