Genesis Arbitrage

Genesis Arbitrage · · 17 min de lecture

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-slippage renvoie 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éePourquoi elle compte en arbitrageChamp de Genesis API
Prix DEX et CEXLe spread et son sensdex_price, cex_price, spread_pct
Liquidité du poolDe combien une transaction déplace le prixliquidity_usd
Volume sur 24 hSi le pool s'échange vraimentdex_volume_24h, volume_24h_usd
CapitalisationLa taille du tokenmarket_cap
Contrat et réseauS'il s'agit du même token que sur l'exchangecontract, network ou chain
Âge du poolUn pool récent est une raison de revérifier le contratpool_created_at
Dépôts et retraits sur le CEXSi le token peut entrer sur l'exchange ou en sortirdeposit_enabled, withdraw_enabled
Slippage, taxe, honeypotCe qu'il reste du spread/orderbooks/dex-slippage
Liens vers le poolExaminer vous-même le pool et ses transactionsdexscreener_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 :

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_pctTransactionRequis sur le CEXDonnées de la jambe DEX
Supérieur à 0Acheter sur le DEX, déposer sur l'exchange, vendredeposit_enabledslippage_buy_pct, tax_buy_pct
Inférieur à 0Acheter sur l'exchange, retirer, vendre sur le DEXwithdraw_enabledslippage_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 transactionSlippageGas, % de la tailleSpread 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

EndpointCe qu'il renvoieDocumentation
/arbitrage/dex-spotPrix DEX face au spot CEX, liquidité, capitalisation, volumeDEX — Spot
/arbitrage/dex-futuresPrix DEX face aux futures CEX, max_position_usdDEX — Futures
/arbitrage/crosschainUn token sur des DEX de deux réseaux, âge du poolCross-chain
/orderbooks/dex-slippageSlippage de 100 $ à 100 000 $, taxes, honeypotSlippage DEX
/market/dex-dumpsChutes de tokens sur les DEX et présence du token sur un CEXDEX 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

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.