Documentation Genesis API
Tout pour intégrer : authentification, limites, endpoints et schémas de réponse.
Aperçu DEX
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.
https://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live/v1/onchain/dex-swaps?period=liveLa 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ètre | Type | Description |
|---|---|---|
period | string | live (15 minutes, par défaut), 1h, 6h, 24h ou 7d |
chain | string | Filtre par réseau |
side | string | buy ou sell |
dex | string | DEX ; plusieurs — séparés par des virgules |
min_usd | number | Montant minimal, USD |
min_impact | number | Impact absolu minimal sur le pool, % |
final | boolean | true — uniquement les swaps vérifiés (facts = final) |
token | string | Ticker du token |
q | string | Recherche sur le token, le nom, les adresses, le trader, le hash de tx, le DEX et la chaîne |
Exemple de requête
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 :
{
"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
| Champ | Type | Description |
|---|---|---|
id | string | Id stable : chaîne, transaction, token |
ts / published_at | int | Heure du swap et de la publication |
token / token_name / token_address | string | Token : ticker, nom, adresse du contrat |
chain / chain_name | string | Réseau |
side / amount / usd | mixed | Côté buy ou sell, quantité et valeur en USD |
dex / dex_entity / pool_address / pool_label / route | mixed | DEX, son entité, pool, label du pool et route |
trader_address / trader_name / trader_type / trader_url | string | null | Trader : adresse, label, type et lien |
tier | string | Palier selon la liquidité du pool : de T1 ($30K–100K) à T4 (plus de $10M) |
pool_liquidity_usd / size_pct_liquidity / impact_est_pct | number | null | Liquidité 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_pct | number | null | Prix et sa variation avant le swap et après 30 s / 5 min |
facts / legs | string / int | Statut de vérification : pending, publish, 30s, final ou unavailable ; legs — nombre de jambes |
tx_hash / explorer_url / arkham_url / dexscreener_url | string | Hash de la transaction et liens explorer / Arkham |