Dokumentasi Genesis API
Semua yang Anda butuhkan untuk integrasi: autentikasi, limit, endpoint, dan skema respons.
Ikhtisar DEX
Swap DEX besar, seperti di «Ikhtisar DEX»: live — 15 menit terakhir, ditambah jendela 1h, 6h, 24h, dan 7d. Setiap swap memiliki estimasi dampak pada pool, pergerakan harga setelah 30 s dan 5 min, serta label trader. Record dilengkapi seiring verifikasi (facts: pending → final) dan dapat hilang jika swap ternyata hanya penataan ulang likuiditas — cocokkan berdasarkan id.
https://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live/v1/onchain/dex-swaps?period=liveKey hanya disimpan di browser Anda dan tidak dikirim ke mana pun selain API.
Tempel key Anda dan kirim request — kami akan menampilkan respons yang dipotong.
Parameter query
Semua parameter bersifat opsional: tanpa filter, endpoint mengembalikan seluruh dataset.
| Parameter | Tipe | Deskripsi |
|---|---|---|
period | string | live (15 menit, default), 1h, 6h, 24h, atau 7d |
chain | string | Filter berdasarkan jaringan |
side | string | buy atau sell |
dex | string | DEX; beberapa — pisahkan dengan koma |
min_usd | number | Jumlah minimum, USD |
min_impact | number | Dampak absolut minimum pada pool, % |
final | boolean | true — hanya swap yang terverifikasi (facts = final) |
token | string | Ticker token |
q | string | Cari di token, nama, alamat, trader, hash tx, DEX, dan chain |
Contoh request
curl "https://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Contoh respons
Contoh respons — satu entri data, nilai panjang dipersingkat:
{
"id": "ethereum:0x5f3c…e1:0x6982…1933",
"ts": 1794675511,
"published_at": 1794675523,
"token": "PEPE",
"token_name": "Pepe",
"token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"chain": "ethereum",
"chain_name": "Ethereum",
"side": "buy",
"amount": 41250000000,
"usd": 412500,
"dex": "Uniswap",
"pool_address": "0xa43f…",
"pool_label": "PEPE/WETH 0.3%",
"trader_address": "0x7b9e…",
"trader_name": "Wintermute",
"tier": "T3",
"pool_liquidity_usd": 4120000,
"size_pct_liquidity": 10.01,
"impact_est_pct": 4.8,
"price_usd": 0.00001,
"move_after_5m_pct": 1.9,
"facts": "final",
"tx_hash": "0x5f3c…e1",
"explorer_url": "https://etherscan.io/tx/0x5f3c…e1",
"dexscreener_url": "https://dexscreener.com/ethereum/0xa43f…"
}Field respons
| Field | Tipe | Deskripsi |
|---|---|---|
id | string | Id yang stabil: chain, transaksi, token |
ts / published_at | int | Waktu swap dan publikasi |
token / token_name / token_address | string | Token: ticker, nama, alamat kontrak |
chain / chain_name | string | Jaringan |
side / amount / usd | mixed | Sisi buy atau sell, jumlah, dan nilai USD |
dex / dex_entity / pool_address / pool_label / route | mixed | DEX, entitasnya, pool, label pool, dan rute |
trader_address / trader_name / trader_type / trader_url | string | null | Trader: alamat, label, tipe, dan tautan |
tier | string | Tier berdasarkan likuiditas pool: dari T1 ($30K–100K) hingga T4 (di atas $10M) |
pool_liquidity_usd / size_pct_liquidity / impact_est_pct | number | null | Likuiditas pool, porsi swap darinya, dan estimasi dampak harga, % |
price_usd / price_change_5m_pct / price_change_1h_pct / price_after_30s_usd / price_after_5m_usd / move_after_5m_pct | number | null | Harga dan perubahannya sebelum swap serta setelah 30 s / 5 min |
facts / legs | string / int | Status verifikasi: pending, publish, 30s, final, atau unavailable; legs — jumlah leg |
tx_hash / explorer_url / arkham_url / dexscreener_url | string | Hash transaksi dan tautan explorer / Arkham |