Genesis API Dokümantasyonu
Entegrasyon için gereken her şey: kimlik doğrulama, limitler, endpoint'ler ve yanıt şemaları.
DEX genel bakış
«DEX genel bakış»taki gibi büyük DEX swap'ları: live — son 15 dakika, ayrıca 1h, 6h, 24h ve 7d pencereleri. Her swap için havuz etkisi tahmini, 30 sn ve 5 dk sonraki fiyat hareketi ve trader etiketi bulunur. Kayıtlar doğrulandıkça tamamlanır (facts: pending → final) ve swap'ın likidite yeniden dağıtımı olduğu anlaşılırsa kaybolabilir — id ile eşleştirin.
https://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live/v1/onchain/dex-swaps?period=liveAnahtar yalnızca tarayıcınızda saklanır ve API dışında hiçbir yere gönderilmez.
Anahtarınızı yapıştırıp istek gönderin — kısaltılmış bir yanıt göstereceğiz.
Sorgu parametreleri
Tüm parametreler isteğe bağlıdır: filtre olmadan endpoint tüm veri setini döndürür.
| Parametre | Tür | Açıklama |
|---|---|---|
period | string | live (15 dakika, varsayılan), 1h, 6h, 24h veya 7d |
chain | string | Ağa göre filtrele |
side | string | buy veya sell |
dex | string | DEX; birden fazlası için virgülle ayırın |
min_usd | number | Minimum tutar, USD |
min_impact | number | Minimum mutlak havuz etkisi, % |
final | boolean | true — yalnızca doğrulanmış swap'lar (facts = final) |
token | string | Token ticker'ı |
q | string | Token, ad, adresler, trader, tx hash, DEX ve zincir içinde arama |
Örnek istek
curl "https://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Örnek yanıt
Yanıt örneği — tek bir data öğesi, uzun değerler kısaltılmış:
{
"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…"
}Yanıt alanları
| Alan | Tür | Açıklama |
|---|---|---|
id | string | Sabit id: zincir, işlem, token |
ts / published_at | int | Swap ve yayın zamanı |
token / token_name / token_address | string | Token: ticker, ad, sözleşme adresi |
chain / chain_name | string | Ağ |
side / amount / usd | mixed | buy veya sell yönü, miktar ve USD değeri |
dex / dex_entity / pool_address / pool_label / route | mixed | DEX, varlığı, havuz, havuz etiketi ve rota |
trader_address / trader_name / trader_type / trader_url | string | null | Trader: adres, etiket, tür ve bağlantı |
tier | string | Havuz likiditesine göre kademe: T1 ($30K–100K) ile T4 (10M$ üzeri) arası |
pool_liquidity_usd / size_pct_liquidity / impact_est_pct | number | null | Havuz likiditesi, swap'ın ondaki payı ve tahmini fiyat etkisi, % |
price_usd / price_change_5m_pct / price_change_1h_pct / price_after_30s_usd / price_after_5m_usd / move_after_5m_pct | number | null | Fiyat ve swap öncesine göre, 30 sn / 5 dk sonraki değişimi |
facts / legs | string / int | Doğrulama durumu: pending, publish, 30s, final veya unavailable; legs — bacak sayısı |
tx_hash / explorer_url / arkham_url / dexscreener_url | string | İşlem hash'i ve explorer / Arkham bağlantıları |