Documentation Genesis API

Tout pour intégrer : authentification, limites, endpoints et schémas de réponse.

DocumentationAperçu DEX

Aperçu DEX

TrialStartProMax

Gros swaps DEX, comme dans «Aperçu DEX» : live — les 15 dernières minutes, plus les fenêtres 1h, 6h, 24h et 7d. Chaque swap comporte une estimation de l'impact sur le pool, la variation du prix après 30 s et 5 min et le label du trader. Les enregistrements sont complétés au fil de leur vérification (facts : pending → final) et peuvent disparaître si un swap se révèle être un simple réarrangement de liquidité — associez par id.

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

La clé n'est stockée que dans votre navigateur et n'est envoyée nulle part sauf à l'API.

Collez votre clé et envoyez une requête — nous montrerons une réponse abrégée.

Paramètres de la requête

Tous les paramètres sont optionnels : sans filtres, l'endpoint renvoie l'ensemble complet des données.

ParamètreTypeDescription
periodstringlive (15 minutes, par défaut), 1h, 6h, 24h ou 7d
chainstringFiltre par réseau
sidestringbuy ou sell
dexstringDEX ; plusieurs — séparés par des virgules
min_usdnumberMontant minimal, USD
min_impactnumberImpact absolu minimal sur le pool, %
finalbooleantrue — uniquement les swaps vérifiés (facts = final)
tokenstringTicker du token
qstringRecherche sur le token, le nom, les adresses, le trader, le hash de tx, le DEX et la chaîne

Exemple de requête

bash
curl "https://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

Exemple de réponse

Exemple de réponse — un élément de data, valeurs longues raccourcies :

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…"
}

Champs de la réponse

ChampTypeDescription
idstringId stable : chaîne, transaction, token
ts / published_atintHeure du swap et de la publication
token / token_name / token_addressstringToken : ticker, nom, adresse du contrat
chain / chain_namestringRéseau
side / amount / usdmixedCôté buy ou sell, quantité et valeur en USD
dex / dex_entity / pool_address / pool_label / routemixedDEX, son entité, pool, label du pool et route
trader_address / trader_name / trader_type / trader_urlstring | nullTrader : adresse, label, type et lien
tierstringPalier selon la liquidité du pool : de T1 ($30K–100K) à T4 (plus de $10M)
pool_liquidity_usd / size_pct_liquidity / impact_est_pctnumber | nullLiquidité du pool, part du swap dans celle-ci et impact estimé sur le prix, %
price_usd / price_change_5m_pct / price_change_1h_pct / price_after_30s_usd / price_after_5m_usd / move_after_5m_pctnumber | nullPrix et sa variation avant le swap et après 30 s / 5 min
facts / legsstring / intStatut de vérification : pending, publish, 30s, final ou unavailable ; legs — nombre de jambes
tx_hash / explorer_url / arkham_url / dexscreener_urlstringHash de la transaction et liens explorer / Arkham