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.
| Event | Yang terlihat | Cara membacanya |
|---|---|---|
| Deposit ke exchange | Koin tiba di alamat exchange | Kemungkinan jual, jaminan, atau pemindahan |
| Penarikan dari exchange | Koin keluar ke alamat eksternal | Penyimpanan, DeFi, atau exchange lain |
| Transfer besar | Transfer di atas threshold antar alamat | Whale memindahkan posisinya |
| Wallet tim | Pergerakan dari alamat foundation, treasury, atau pendiri | Deposit ke exchange lebih berbobot daripada pemindahan internal |
| Posisi perp DEX | Long atau short: ukuran, harga, platform | Taruhan whale dan risiko likuidasi |
| Unlock | Tanggal, porsi, dan nilai rilis | Suplai baru koin |
| Claim | Token dari airdrop, vesting, reward | Penerima bisa langsung menjual |
| Mint dan bridge | Penerbitan token, perpindahan antar chain | Pencetakan stablecoin berarti uang masuk |
| Hack | Protokol, kerugian, teknik serangan | Risiko bagi token dan chain terkait |
| Swap DEX | Sisi, jumlah, porsi pool, pergerakan harga | Pergeseran 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.
| Tahap | Berapa lama | Artinya |
|---|---|---|
| Blok Ethereum | slot 12 dtk | Transaksi terlihat tetapi belum final |
| Finality Ethereum | sekitar 15 mnt | Blok tidak akan berubah lagi |
| Kredit di exchange | minimum konfirmasi exchange | Berbeda untuk setiap koin |
| Publikasi swap | 12 dtk pada contoh | Record belum berstatus final |
Status final | paling cepat 5 mnt setelah swap | Harga setelah 30 dtk dan 5 mnt sudah diketahui |
| Pengiriman Genesis API | 30, 10, atau 5 dtk | Paket 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.
| Endpoint | Yang dikembalikan | Paket |
|---|---|---|
/onchain/{section} | Salah satu dari 9 bagian on-chain | Start, Pro, Max |
/onchain | Semua 9 bagian dalam satu objek | Start, Pro, Max |
/onchain/dex-swaps | Swap DEX besar | Pro, Max |
/onchain/analytics | Total untuk 24h atau 7d | Pro, Max |
/onchain/coin/{symbol} | Ringkasan koin 7 hari | Pro, 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.
| Skenario | Apa lagi yang terlihat | Cara memeriksa |
|---|---|---|
| Bersiap menjual | Penjualan di DEX, harga melemah | /onchain/dex-swaps dengan side=sell |
| Jaminan futures | Open interest naik, funding berubah | /market/open-interest, /funding/rates |
| Pemindahan internal | Penarikan yang sepadan dari exchange yang sama | from_name di cex-flows, explorer |
| Penjualan tim atau dana | Pengirimnya wallet tim | team-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.