API DEX : prix, liquidité et slippage des DEX à côté du prix CEX
En bref
- Une API DEX renvoie le prix d'un token dans le pool, la liquidité, le volume, la capitalisation, le contrat et le réseau. Pour l'arbitrage, il faut aussi le prix CEX du même contrat : les endpoints DEX — Spot et DEX — Futures de Genesis API le fournissent avec les forfaits Pro et Max.
- Le prix sur un DEX dépend de la taille de la transaction, car il est fixé par un pool de liquidité. Dans un exemple hypothétique, un spread de 3 % laisse 11 $ sur une transaction de 2 500 $ et devient négatif à 5 000 $ après le slippage, la taxe du token et le gas.
/orderbooks/dex-slippagerenvoie le slippage pour la taille de votre transaction, les taxes d'achat et de vente et le flag honeypot. Genesis API ne fait que lire des données : vous signez le swap vous-même dans votre propre portefeuille.
Une API DEX est un accès programmatique aux données des exchanges décentralisés (DEX) : le prix d'un token dans le pool, la liquidité du pool, le volume d'échanges, la capitalisation, l'adresse du contrat et le réseau. La plupart des DEX n'ont ni carnet d'ordres ni processus de listing : un pool de liquidité fixe le prix, et n'importe qui peut créer un pool. C'est pourquoi une API DEX doit renvoyer, avec le prix, les données qui permettent de vérifier le token et le pool.
Pour l'arbitrage, on compare le prix du DEX au prix CEX du même contrat, puis on calcule quelle part du spread survit à la taille de votre transaction après le slippage, la taxe du token et le gas. Dans Genesis API, les paires DEX ↔ CEX viennent de /arbitrage/dex-spot et /arbitrage/dex-futures, tandis que le slippage, les taxes et le flag de honeypot par contrat viennent de /orderbooks/dex-slippage.
Comment un DEX fixe son prix
Sur la plupart des DEX, un swap passe par un pool de liquidité : un smart contract qui détient des réserves de deux tokens, par exemple un token et de l'USDC. Le prix est le rapport entre les réserves. Un achat retire le token du pool et y ajoute de l'USDC, si bien que chaque unité suivante du token coûte plus cher que la précédente.
Uniswap décrit un tel pool par la formule du produit constant x × y = k, où x et y sont les réserves de tokens : après un swap, le produit ne doit pas diminuer.
Exemple hypothétique : un pool contient 200 000 $ de liquidité, 100 000 $ de chaque côté. Un achat de 1 000 $ déplace le prix moyen de 2 × 1 000 / 200 000 = 1 %, un achat de 10 000 $ de 10 %. Le calcul pas à pas avec un tableau figure dans la leçon Qu'est-ce que l'arbitrage DEX.
La formule décrit un pool classique. Dans Uniswap v3 et v4, elle s'applique à l'intérieur des fourchettes de prix choisies par les fournisseurs de liquidité, et le prix DEX des lignes de Genesis Arbitrage est agrégé par contrat et par réseau. Le slippage exact pour une taille donnée vient donc des données, et la formule sert d'estimation rapide.
Ce qu'il faut attendre d'une API DEX
Juger une paire DEX ↔ CEX demande plus qu'un prix. Voici ce qu'il vous faut et où cela se trouve dans les réponses de Genesis API :
| Donnée | Pourquoi elle compte en arbitrage | Champ de Genesis API |
|---|---|---|
| Prix DEX et CEX | Le spread et son sens | dex_price, cex_price, spread_pct |
| Liquidité du pool | De combien une transaction déplace le prix | liquidity_usd |
| Volume sur 24 h | Si le pool s'échange vraiment | dex_volume_24h, volume_24h_usd |
| Capitalisation | La taille du token | market_cap |
| Contrat et réseau | S'il s'agit du même token que sur l'exchange | contract, network ou chain |
| Âge du pool | Un pool récent est une raison de revérifier le contrat | pool_created_at |
| Dépôts et retraits sur le CEX | Si le token peut entrer sur l'exchange ou en sortir | deposit_enabled, withdraw_enabled |
| Slippage, taxe, honeypot | Ce qu'il reste du spread | /orderbooks/dex-slippage |
| Liens vers le pool | Examiner vous-même le pool et ses transactions | dexscreener_url, dextools_url, gmgn_url |
La capitalisation et le volume DEX figurent dans DEX — Spot, l'âge du pool dans les côtés buy et sell de Cross-chain. Une requête pour la ligne DEX — Spot d'une seule monnaie :
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/dex-spot" \
-d coin=SCR \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Une ligne tirée de la documentation DEX — Spot, abrégée :
{
"coin": "SCR",
"exchange": "MEXC",
"cex_price": 0.02691,
"dex_price": 0.02679,
"spread_pct": 0.45,
"network": "SCROLL",
"contract": "0xd29687c813D741E2F938F4aC377128810E217b1b",
"liquidity_usd": 10544.15,
"market_cap": 5091835.0,
"dex_volume_24h": 319.73,
"deposit_enabled": true,
"withdraw_enabled": true,
"dexscreener_url": "https://dexscreener.com/scroll/0xd296…",
"dextools_url": null,
…
}
Le token coûte plus cher sur MEXC que dans le pool, le spread est donc positif : 0,45 %. La liquidité du pool est de 10 544 $ et le volume DEX sur 24 h d'environ 320 $. S'il s'agit d'un seul pool classique, le prix moyen d'un achat de 1 000 $ sera environ 2 × 1 000 / 10 544 ≈ 19 % au-dessus du prix de départ, soit plus de 40 fois le spread. Les liens peuvent valoir null : cette ligne n'a que dexscreener_url.
Pourquoi les prix des DEX s'écartent de ceux des CEX
Le prix d'un pool ne change que par les transactions qui s'y font, et de l'extérieur un nouveau prix apparaît à chaque bloc : Ethereum découpe le temps en slots de 12 secondes. Sur un CEX, le prix bouge avec le flux d'ordres du carnet. Un écart dure jusqu'à ce qu'un arbitragiste le comble, et voici ce qui l'en empêche :
- Dépôts ou retraits fermés. Si le token ne peut ni entrer sur l'exchange ni en sortir, les deux marchés vivent séparément. Dans une ligne, ce sont
deposit_enabledetwithdraw_enabled. - Les coûts dépassent l'écart. Gas, frais du pool et de l'exchange : cela ne vaut pas la peine de combler un écart plus petit que ces coûts.
- Taxe du token. Avec une taxe d'achat de 5 %, un écart allant jusqu'à 5 % est englouti par la taxe elle-même.
- Pool peu profond. Dans un pool de quelques dizaines de milliers de dollars, une seule transaction moyenne déplace le prix.
- Un autre token. Une copie avec un autre contrat peut s'échanger sur un DEX sous le même ticker. Genesis Arbitrage ne compare les prix que si l'adresse du contrat correspond.
Pour l'arbitrage, le signe du spread fixe le sens de la transaction, et le sens détermine ce qui doit être ouvert sur l'exchange et quelles données de la jambe DEX lire :
spread_pct | Transaction | Requis sur le CEX | Données de la jambe DEX |
|---|---|---|---|
| Supérieur à 0 | Acheter sur le DEX, déposer sur l'exchange, vendre | deposit_enabled | slippage_buy_pct, tax_buy_pct |
| Inférieur à 0 | Acheter sur l'exchange, retirer, vendre sur le DEX | withdraw_enabled | slippage_sell_pct, tax_sell_pct |
Pendant que le token voyage entre le portefeuille et l'exchange, le spread peut se refermer. Dans une paire DEX — Futures, un short sur futures ouvert en même temps que l'achat sur le DEX compense le mouvement de prix, mais il apporte avec lui marge, funding et risque de liquidation : voir la leçon Arbitrage : DEX — Futures. Une ligne DEX — Futures contient aussi max_position_usd, la taille maximale de position, lorsque l'exchange la fournit.
Slippage, taxe du token et honeypots
/orderbooks/dex-slippage décrit la jambe DEX d'une paire par contrat : le slippage à l'achat et à la vente pour des tailles de 100 $ à 100 000 $, la taxe d'achat et de vente du token et le flag honeypot (un honeypot est un token que l'on peut acheter mais pas vendre). Ce sont les mêmes données que les colonnes DEX du tableau du site. Les filtres sont contract (séparés par des virgules pour plusieurs adresses) et network ; les champs sont décrits dans la section Slippage DEX.
Un exemple de réponse tiré de la documentation, pour un contrat :
{
"sizes_usd": [100, 500, 1000, 2500, 5000, 10000, 20000, 50000,
100000],
"contracts": [
{
"contract": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"network": "ETH",
"tax_buy_pct": 0,
"tax_sell_pct": 0,
"honeypot": "no",
"slippage_buy_pct": [0.31, 0.33, 0.36, 0.44, 0.58, 0.86,
1.41, 3.12, 6.05],
"slippage_sell_pct": [0.31, 0.34, 0.37, 0.46, 0.61, 0.9,
1.5, 3.3, 6.4],
"updated_at": 1794671040
}
]
}
Les tableaux suivent la grille sizes_usd : un achat de 1 000 $ perd 0,36 %, un achat de 10 000 $ 0,86 %, un achat de 100 000 $ 6,05 %. Un null dans un tableau signifie que le pool manque de liquidité pour cette taille. honeypot prend trois valeurs : no, suspect (les sources ne concordent pas) et yes (la vente peut être impossible). Chaque contrat a sa propre heure de mise à jour dans updated_at.
Exemple hypothétique : un spread de 3 % et ce qu'il en reste
Le token coûte 1,00 $ sur le DEX et 1,03 $ sur le CEX : un spread de 3 % sur le prix d'achat, donc vous achetez sur le DEX et vendez sur l'exchange. La taxe d'achat est de 1 %, les frais de l'exchange sur la vente de 0,1 %, et le gas du swap et du transfert vers l'exchange de 4 $. L'échelle slippage_buy_pct : 0,5 % à 500 $, 0,7 % à 1 000 $, 1,3 % à 2 500 $ et 2,3 % à 5 000 $.
| Taille de la transaction | Slippage | Gas, % de la taille | Spread restant |
|---|---|---|---|
| 500 $ | 0,5 % | 0,8 % | 0,6 %, soit 3 $ |
| 1 000 $ | 0,7 % | 0,4 % | 0,8 %, soit 8 $ |
| 2 500 $ | 1,3 % | 0,16 % | 0,44 %, soit 11 $ |
| 5 000 $ | 2,3 % | 0,08 % | −0,48 %, soit −24 $ |
Pour 5 000 $ : 3 − 2,3 − 1 − 0,1 − 0,08 = −0,48 %, une perte de 24 $ sur la transaction. Additionner des pourcentages suffit pour une estimation ; le calcul exact avec des produits donne quelques centièmes de point de moins.
En dollars, c'est à 2 500 $ qu'il reste le plus, alors qu'à 5 000 $ le même spread rend la transaction négative. Quand la taille augmente, le gas pèse moins et le slippage plus, donc chaque paire a sa propre taille de travail. Avec honeypot: "yes" et un spread négatif, il n'y a rien à calculer : un token acheté sur l'exchange peut ne pas se vendre dans le pool.
La vente sur le CEX dans l'exemple utilise le prix de la ligne. En pratique, vous la vérifiez avec le carnet d'ordres de l'exchange : le Δ des carnets pour les lignes DEX vient de /orderbooks/spreads/dex-spot pour 500 $, 1 000 $, 2 500 $, 5 000 $ et 10 000 $ (champs dans la documentation, pas à pas dans le guide Endpoints des carnets d'ordres).
Endpoints DEX de Genesis API
| Endpoint | Ce qu'il renvoie | Documentation |
|---|---|---|
/arbitrage/dex-spot | Prix DEX face au spot CEX, liquidité, capitalisation, volume | DEX — Spot |
/arbitrage/dex-futures | Prix DEX face aux futures CEX, max_position_usd | DEX — Futures |
/arbitrage/crosschain | Un token sur des DEX de deux réseaux, âge du pool | Cross-chain |
/orderbooks/dex-slippage | Slippage de 100 $ à 100 000 $, taxes, honeypot | Slippage DEX |
/market/dex-dumps | Chutes de tokens sur les DEX et présence du token sur un CEX | DEX Dumps |
Les cinq fonctionnent avec les forfaits API Pro (100 $ par mois, fraîcheur de 10 s) et Max (200 $, fraîcheur de 5 s) ; avec Trial et Start, ils renvoient 403 plan_restricted. DEX — Spot et DEX — Futures acceptent coin, exchange, min_spread et min_liquidity, Cross-chain accepte chain au lieu de exchange, et DEX Dumps accepte chain et min_liquidity. Les paramètres et les champs sont détaillés dans le guide Endpoints d'arbitrage, les prix sur la page des tarifs de Genesis API.
min_spread compare le spread signé : min_spread=2 écarte aussi une ligne dont le spread est de −5 %. Pour voir les deux sens, appliquez le seuil à la valeur absolue dans le code, comme le fait l'exemple ci-dessous. Les gros swaps de pool avec une estimation de l'impact sur le prix viennent de l'endpoint on-chain /onchain/dex-swaps, présenté dans l'article API de données on-chain.
Sans code, le tableau du site montre les mêmes paires : ses colonnes, ses filtres et l'ordre des vérifications sont décrits dans Comment utiliser le tableau DEX — Spot.
Exemple Python : paires DEX — Spot sans pièges
Le script prend les paires DEX — Spot dont la liquidité dépasse 50 000 $ et dont le spread absolu atteint 2 %, demande le slippage et les taxes de leurs contrats, puis écarte honeypot: "yes" et les taxes supérieures à 5 %. Pour le reste, il calcule ce qu'il reste du spread sur 1 000 $ après le slippage et la taxe. La clé vient de la variable d'environnement GENESIS_API_KEY.
La fonction de requête attend Retry-After secondes en cas de 429 et 503. Quand le quota mensuel est épuisé, Retry-After décompte jusqu'à la réinitialisation du quota et peut atteindre plusieurs jours, donc le script ne lance pas d'attente longue :
import os
import time
import requests
API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def get(path, params=None):
for _ in range(3):
r = requests.get(API + path, headers=HEADERS,
params=params, timeout=15)
if r.status_code == 403:
raise SystemExit("Les endpoints DEX exigent le forfait Pro ou Max")
if r.status_code in (429, 503):
wait = int(r.headers.get("Retry-After", "5"))
if wait > 60: # quota mensuel épuisé
raise SystemExit(f"quota épuisé, réessayez dans {wait} s")
time.sleep(wait)
continue
r.raise_for_status()
return r.json()["data"]
raise RuntimeError("API occupée, réessayez plus tard")
Sélection des paires et vérification des contrats :
SIZE = 1000 # taille de la transaction, USD : l'une des valeurs de sizes_usd
MAX_TAX = 5 # ignorer les tokens taxés au-delà de 5 %
rows = get("/arbitrage/dex-spot", {"min_liquidity": 50000})
rows = [x for x in rows
if x["contract"] and abs(x["spread_pct"]) >= 2]
addrs = sorted({x["contract"].lower() for x in rows})
checks, sizes = {}, []
for i in range(0, len(addrs), 50): # jusqu'à 50 adresses par appel
d = get("/orderbooks/dex-slippage",
{"contract": ",".join(addrs[i:i + 50])})
sizes = d["sizes_usd"]
for c in d["contracts"]: # les adresses arrivent en minuscules
checks[c["contract"]] = c
found = []
for x in rows:
c = checks.get(x["contract"].lower())
if c is None or c["honeypot"] == "yes":
continue # pas de données, ou la vente peut être impossible
taxes = [t for t in (c["tax_buy_pct"], c["tax_sell_pct"])
if t is not None] # null signifie pas de source, pas 0 %
if any(t > MAX_TAX for t in taxes):
continue
buy = x["spread_pct"] >= 0 # positif : acheter sur le DEX
ladder = c["slippage_buy_pct" if buy else "slippage_sell_pct"]
k = sizes.index(SIZE)
slip = ladder[k] if k < len(ladder) else None
if slip is None:
continue # le pool manque de liquidité pour SIZE
tax = c["tax_buy_pct" if buy else "tax_sell_pct"]
left = abs(x["spread_pct"]) - slip - (tax or 0)
found.append((left, x, c["honeypot"], tax))
for left, x, hp, tax in sorted(found, key=lambda f: -f[0]):
print(f'{x["coin"]:<8} {x["exchange"]:<8} '
f'spread {x["spread_pct"]:+.2f}%, reste {left:.2f}%, '
f'taxe {"pas de données" if tax is None else tax}, '
f'honeypot {hp}')
Le script ne déduit ni le gas ni les frais de l'exchange : ajoutez vos propres chiffres de réseau et d'exchange. Il ignore les lignes sans données dans /orderbooks/dex-slippage : ces tokens se vérifient à la main via les liens de la ligne. Les adresses sont comparées en minuscules, car DEX — Spot peut renvoyer un contrat en casse mixte, comme dans l'exemple ci-dessus.
Interrogez en boucle au plus souvent que meta.freshness_sec. Avec Pro, c'est toutes les 10 secondes : 30 × 86 400 / 10 = 259 200 appels à un endpoint en 30 jours, pour un quota de 5M. Comment économiser du quota et du trafic est expliqué dans Comment interroger une API sans atteindre les limites.
Les risques que le spread ne montre pas
- MEV et attaques sandwich. Un bot peut voir votre swap DEX avant son inclusion dans un bloc : il achète avant vous, vend juste après et prend une partie du spread. Plus la tolérance de slippage de votre portefeuille est large, plus il peut prendre ; la protection est décrite dans MEV et attaques sandwich sur les DEX.
- Pouvoirs du propriétaire du token. Si le contrat le permet, le propriétaire peut relever la taxe ou bloquer les ventes après votre achat, et un
honeypot: "no"et une taxe nulle aujourd'hui ne vous en protègent pas. Les permissions du contrat et les verrouillages de liquidité se vérifient pas à pas dans Comment vérifier un token avant de l'acheter. - Retard des données. Les prix arrivent avec le retard de votre forfait et l'échelle de slippage avec son propre
updated_at. Avant une transaction, vérifiez le prix du pool via le lien de la ligne et le carnet d'ordres sur l'exchange. - Transfert vers l'exchange. Les dépôts peuvent se fermer pendant que le token est en transit, et le crédit attend les confirmations du réseau, un nombre que chaque exchange fixe pour lui-même.
- Gas. Sur un réseau saturé, le gas monte et mange le spread des petites transactions.
Questions et réponses
Puis-je acheter un token via Genesis API ?
Non. Genesis API ne fait que renvoyer des données et ne passe aucun ordre, ni sur les DEX ni sur les exchanges. Vous signez les swaps DEX dans votre propre portefeuille et vous ouvrez vous-même les transactions CEX sur l'exchange.
À quelle fréquence les prix DEX sont-ils mis à jour dans l'API ?
Le prix d'un pool change à chaque transaction qui s'y fait et se voit de l'extérieur à chaque nouveau bloc. Le cœur de Genesis Arbitrage met les données à jour chaque seconde, et l'API les sert avec la fraîcheur de votre forfait : 10 s avec Pro et 5 s avec Max, les seuls forfaits qui donnent accès aux endpoints DEX. L'heure de construction de l'instantané figure dans meta.updated_at ; le slippage et les taxes portent le updated_at propre à chaque contrat.
Que signifie null pour la taxe d'un token ?
Qu'il n'y a pas de source de données sur la taxe de ce token. Ne la traitez pas comme zéro : la taxe peut être n'importe quoi. L'exemple Python ci-dessus conserve ces lignes et affiche « taxe pas de données » pour que vous les vérifiiez à la main.
Quel forfait Genesis API faut-il pour les données DEX ?
Pro (100 $ par mois) ou Max (200 $). Avec Trial et Start, DEX — Spot, DEX — Futures, Cross-chain, DEX Dumps et le slippage DEX renvoient 403 plan_restricted.
Les réponses contiennent-elles des liens DexScreener ?
Oui. Les lignes DEX — Spot et DEX — Futures et les deux côtés de Cross-chain contiennent dexscreener_url, dextools_url et gmgn_url, des liens vers la page du pool ou du token. Quand un lien manque, le champ vaut null. Dans DEX Dumps, le lien du pool est pool_url, et les autres se trouvent dans le tableau links.