Genesis API Dokümantasyonu

Entegrasyon için gereken her şey: kimlik doğrulama, limitler, endpoint'ler ve yanıt şemaları.

DokümantasyonDEX genel bakış

DEX genel bakış

TrialStartProMax

«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.

GEThttps://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live
Deneyin
GET/v1/onchain/dex-swaps?period=live

Anahtar 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.

ParametreTürAçıklama
periodstringlive (15 dakika, varsayılan), 1h, 6h, 24h veya 7d
chainstringAğa göre filtrele
sidestringbuy veya sell
dexstringDEX; birden fazlası için virgülle ayırın
min_usdnumberMinimum tutar, USD
min_impactnumberMinimum mutlak havuz etkisi, %
finalbooleantrue — yalnızca doğrulanmış swap'lar (facts = final)
tokenstringToken ticker'ı
qstringToken, ad, adresler, trader, tx hash, DEX ve zincir içinde arama

Örnek istek

bash
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ış:

json
{
  "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ı

AlanTürAçıklama
idstringSabit id: zincir, işlem, token
ts / published_atintSwap ve yayın zamanı
token / token_name / token_addressstringToken: ticker, ad, sözleşme adresi
chain / chain_namestringAğ
side / amount / usdmixedbuy veya sell yönü, miktar ve USD değeri
dex / dex_entity / pool_address / pool_label / routemixedDEX, varlığı, havuz, havuz etiketi ve rota
trader_address / trader_name / trader_type / trader_urlstring | nullTrader: adres, etiket, tür ve bağlantı
tierstringHavuz likiditesine göre kademe: T1 ($30K–100K) ile T4 (10M$ üzeri) arası
pool_liquidity_usd / size_pct_liquidity / impact_est_pctnumber | nullHavuz 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_pctnumber | nullFiyat ve swap öncesine göre, 30 sn / 5 dk sonraki değişimi
facts / legsstring / intDoğrulama durumu: pending, publish, 30s, final veya unavailable; legs — bacak sayısı
tx_hash / explorer_url / arkham_url / dexscreener_urlstringİşlem hash'i ve explorer / Arkham bağlantıları