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
| Endpoint | Yang dikembalikan | Paket API |
|---|---|---|
/onchain/{section} | Salah satu dari sembilan bagian Genesis OnChain | Start, Pro, Max |
/onchain | Kesembilan bagian dalam satu objek | Start, Pro, Max |
/onchain/dex-swaps | Swap DEX besar | Pro, Max |
/onchain/analytics | Analitik OnChain untuk 24 jam atau 7 hari | Pro, Max |
/onchain/coin/{symbol} | Ringkasan 7 hari untuk satu koin | Pro, 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}
section | Isinya | Blok dasbor |
|---|---|---|
large-transfers | Transfer token besar | Large Transfers |
cex-flows | Deposit ke dan penarikan dari exchange | CEX Deposits / Withdrawals |
mint-bridge | Mint token dan transfer bridge | Mint / Bridge |
team-wallets | Pergerakan dompet tim | Team Transfers |
perp-positions | Posisi besar di DEX perpetual | Perp. DEX Positions |
unlocks | Unlock token | Unlocks |
claims | Claim | Claims |
coin-traffic | Rangkaian transfer satu koin ke satu tujuan | Coin Traffic |
hacks | Peretasan dan exploit | Hacks / 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.
| Parameter | Tipe | Fungsi |
|---|---|---|
min_usd | number | Jumlah event minimum, USD |
coin | string | Baris untuk satu koin; hacks tidak punya koin, jadi daftarnya kosong |
when | string | Hanya untuk unlocks: upcoming atau past |
section | string | Bagian 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.
| Field | Di mana | Arti |
|---|---|---|
ts, links | Semua bagian | Waktu event dalam detik unix dan tautan siap pakai: teks + url |
token / token_name | Transfer, coin-traffic | Ticker token dan nama lengkapnya |
chain / chain_name, usd / amount | Transfer | Jaringan, jumlah dalam USD dan dalam token |
from_* / to_* | Transfer | Pengirim dan penerima: label, alamat, tautan explorer |
tx_hash / explorer_url / arkham_url | Transfer | Hash transaksi, tautan explorer dan Arkham |
direction, target / target_address | coin-traffic | Arah deposit, withdrawal, atau transfer dan tujuan arus |
total_usd / count / window_hours, transfers[] | coin-traffic | Total rangkaian, jumlah transfer, jendela dalam jam, dan transfer terbesar |
side / size / price / platform | perp-positions | Long atau Short, ukuran, harga, platform |
unlock_percent / unlock_value_usd / hours_left / allocations | unlocks | Porsi dan nilai unlock, sisa jam, alokasi |
classification / technique / returned_funds | hacks | Klasifikasi, 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.
| Parameter | Tipe | Fungsi |
|---|---|---|
period | string | live — 15 menit terakhir, default; 1h, 6h, 24h, atau 7d |
chain | string | Jaringan |
side | string | buy atau sell |
dex | string | DEX; pisahkan dengan koma untuk beberapa |
min_usd | number | Jumlah swap minimum, USD |
min_impact | number | Dampak pool absolut minimum, % |
final | boolean | true — hanya swap terverifikasi |
token | string | Ticker token |
q | string | Pencarian di token, nama, alamat, trader, hash, DEX, dan jaringan |
| Field | Tipe | Arti |
|---|---|---|
id | string | Pengenal stabil: jaringan, transaksi, token |
tier | string | Tier menurut likuiditas pool: dari T1 (30.000–100.000 $) hingga T4 (di atas 10 juta $) |
pool_liquidity_usd / size_pct_liquidity / impact_est_pct | number atau null | Likuiditas pool, porsi swap darinya, dan perkiraan dampak harga, % |
price_after_30s_usd / price_after_5m_usd / move_after_5m_pct | number atau null | Harga setelah 30 dtk dan 5 mnt serta pergerakan harga selama 5 menit setelah swap |
facts | string | Status verifikasi: pending, publish, 30s, final, atau unavailable |
trader_name / trader_address | string atau null | Label 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.
| Field | Tipe | Arti |
|---|---|---|
kpi | object | Total: events, usd, tokens, cex_in, cex_out, cex_net |
hourly | object | Bucket dengan langkah 1 jam untuk 24h dan 6 jam untuk 7d |
exchange_flows | object | Per exchange: in_usd, out_usd, net |
tokens | array | Hingga 40 koin yang menjadi sorotan dengan event terbesar dan konteks CEX |
events | array | Feed 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.
| Field | Tipe | Arti |
|---|---|---|
cex | object atau null | Harga, OI, funding 8 jam, spread terbaik, jaringan, deposit dan penarikan; null jika koin tidak ada di CEX yang didukung |
kpi | object | Total 7 hari: events, cex_in, cex_out, swaps, dex_buy, dex_sell |
by_section | object | Jumlah event per bagian, dengan kunci seperti large_tx dan cex_deposits |
events / swaps | array | Event dan swap, hingga 2000; jumlah penuh di events_total dan swaps_total |
unlocks.upcoming / unlocks.past | array | Unlock 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…"
}
Tentukan koin dan ambang batas
coindanmin_usdmenjaga transfer besar satu koin tetap ada di respons.Pisahkan deposit dari penarikan
Exchange di
to_nameadalah deposit, difrom_namepenarikan. Cocokkan label berdasarkan substring, tanpa membedakan huruf besar-kecil.Hitung jendela dan transfer baru
Jumlahkan baris satu jam terakhir berdasarkan
ts, dan beri notifikasi hanya untuk nilaitx_hashbaru.Polling sesuai kesegaran paket Anda
Beri jeda
meta.freshness_secantar request; pada429dan503, tungguRetry-Afterdetik.
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.