Genesis Arbitrage

Genesis Arbitrage · · 13 min de lecture

Endpoints de carnets d’ordres de Genesis API : prix d’exécution, Δ des carnets, carnet, historique et DEX

En bref

  • Six endpoints de carnets d’ordres sur les plans API Pro et Max renvoient les mêmes données que le site affiche dans la colonne « Δ par ordres », la fenêtre « Carnet d’ordres » et Genesis Charts.
  • Le prix d’exécution est le prix moyen d’un ordre au marché de 500, 1 000, 2 500, 5 000 ou 10 000 $ ; null signifie que le carnet est trop mince pour ce volume.
  • Les carnets ont 5 à 20 secondes de retard sur la bourse : vérifiez age_sec et stale, et consultez le carnet dans le terminal de la bourse avant de trader.

L’API de carnet d’ordres de Genesis API, ce sont six endpoints qui montrent quelle part d’un spread survit à une transaction d’une taille donnée. Ils renvoient des prix d’exécution pour un volume, le Δ des carnets pour les lignes d’arbitrage, un carnet d’ordres avec sa profondeur, l’historique de slippage et le slippage DEX — les mêmes données que la colonne « Δ par ordres » et Genesis Charts sur le site.

Six endpoints de carnets d’ordres

EndpointRenvoieObligatoireDocumentation
/orderbooks/execPrix d’achat et de vente pour un volume sur chaque marchévolumePrix d’exécution
/orderbooks/spreads/{dataset}Δ des carnets pour les lignes d’un coin dans un jeu de données d’arbitragecoinΔ des carnets
/orderbooks/bookCarnet d’un marché : 10 niveaux, murs, profondeur, âgeexchange, market, coinCarnet d’un marché
/orderbooks/coin/{coin}Carnets d’un coin sur toutes les bourses et tous les marchéscoin dans le cheminCarnets d’un coin
/orderbooks/exec-historyHistorique de slippage, jusqu’à 8 marchés par requêtekeys, intervalHistorique d’exécution
/orderbooks/dex-slippageSlippage, taxes et indicateur de honeypot par contrat—Slippage DEX

Les six font partie des plans de l’API Pro (100 $ par mois) et Max (200 $) ; sur Trial et Start, ils renvoient 403 plan_restricted. Dans /orderbooks/exec et dans le paramètre keys de l’historique, un marché s’écrit Exchange|market|COIN, par exemple Binance|spot|BTC. Les exemples de réponse ci-dessous montrent le champ data, abrégé.

Pour une vue d’ensemble des données de carnets d’ordres, voir l’article sur l’API de carnet d’ordres.

Prix d’exécution pour un volume

Le prix d’exécution est le prix moyen auquel un ordre au marché d’une taille donnée parcourt le carnet : un achat prend les asks, une vente frappe les bids, c’est donc le VWAP des ordres que la transaction consomme. /orderbooks/exec le renvoie pour tous les marchés, pour un volume de la grille.

ParamètreTypeRôle
volumenombreVolume en USD : 500, 1000, 2500, 5000 ou 10000, obligatoire
exchangechaîneFiltre par bourse ; séparées par des virgules pour plusieurs
marketchaînespot ou futures
coinchaîneTicker du coin, p. ex. BTC
curl "https://api.genesisarbitrage.com/v1/orderbooks/exec?volume=1000" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "volume": 1000,
  "markets": {
    "Binance|spot|BTC": [96021.5, 96010.2],
    "ByBit|futures|BTC": [96030.1, 96018.7],
    "Ourbit|spot|SHELL": [0.10418, null],
    …
  }
}

La valeur de chaque clé de marché est [prix d’achat, prix de vente]. null à la place d’un prix signifie que le carnet est trop mince pour ce volume : dans l’exemple, les bids de SHELL sur Ourbit n’absorbent pas une vente de 1 000 $. Sans filtre, la réponse contient tous les marchés ; passez donc coin quand il vous faut un seul coin.

Δ des carnets : le spread après parcours du carnet

Le Δ des carnets est le spread d’une ligne d’arbitrage recalculé à travers les carnets pour un volume donné. /orderbooks/spreads/{dataset} prend toutes les lignes d’un coin dans le jeu de données choisi et ajoute à chacune un objet order_delta, avec les mêmes formules que la colonne du site.

ParamètreTypeRôle
{dataset}chaîne, dans le cheminspot-spot, spot-futures, futures-futures, dex-spot ou dex-futures
coinchaîneTicker du coin, obligatoire
volumenombre0 par défaut — meilleurs prix du carnet ; ou 500, 1000, 2500, 5000, 10000

Pour les paires CEX, l’achat parcourt les asks de exchange_buy et la vente entre dans les bids de exchange_sell. order_delta contient buy_price et sell_price, et le résultat ne dépasse jamais le spread_pct de la ligne.

Pour les lignes DEX, le signe du spread fixe le côté CEX : avec spread_pct ≥ 0, le token est vendu dans les bids du CEX ; avec un spread négatif, il est acheté sur les asks. order_delta contient side et cex_price, le prix d’exécution sur le CEX ; si le signe s’inverse après parcours du carnet, le Δ vaut 0.

Le champ status : ok — calculé, no_book — pas de carnet, exhausted — le carnet n’a pas rempli le volume.

Un exemple hypothétique : coin XYZ, achat sur MEXC à 2,000, vente sur Gate à 2,016, spread de la ligne 0,8 %. Requête du Δ des carnets pour 5 000 $ :

curl -G \
  "https://api.genesisarbitrage.com/v1/orderbooks/spreads/spot-spot" \
  -d coin=XYZ -d volume=5000 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "coin": "XYZ",
  "exchange_buy": "MEXC",
  "exchange_sell": "Gate",
  "market_buy": "spot",
  "market_sell": "spot",
  "price_buy": 2.0,
  "price_sell": 2.016,
  "ask_buy": 2.001,
  "bid_sell": 2.015,
  "spread_pct": 0.8,
  "order_delta": {
    "volume": 5000,
    "buy_price": 2.004,
    "sell_price": 2.01,
    "spread_pct": 0.2994,
    "status": "ok"
  }
}

Les autres champs de la ligne sont les mêmes que dans /arbitrage/spot-spot. Spread de la ligne : (2,016 − 2,000) / 2,000 × 100 = 0,8 %.

Pour 5 000 $, l’achat à travers le carnet de MEXC donne une moyenne de 2,004 et la vente dans le carnet de Gate rapporte 2,010 : (2,010 − 2,004) / 2,004 × 100 ≈ 0,2994 %. Sur les 0,8 %, environ 0,3 % survit à cette taille — à peu près 15 $ avant frais et transfert : 5 000 × 0,002994 ≈ 14,97.

Exemple Python : spread avant et après le carnet

Le script affiche le spread de la ligne à côté du spread après carnet pour BTC dans le jeu de données Spot – Spot à 5 000 $. La clé vient de la variable d’environnement GENESIS_API_KEY ; sur 429 et 503, le script attend Retry-After secondes.

import os
import time
import requests

BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}


def get(path, params):
    for _ in range(3):
        r = requests.get(BASE + path, headers=HEADERS,
                         params=params, timeout=15)
        if r.status_code in (429, 503):
            # limite de requêtes ou données en reconstruction
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        r.raise_for_status()
        return r.json()["data"]
    raise RuntimeError("API occupée, réessayez plus tard")


rows = get("/orderbooks/spreads/spot-spot",
           {"coin": "BTC", "volume": 5000})
for row in rows:
    od = row["order_delta"]
    if od["status"] == "ok":
        after = f'{od["spread_pct"]:.4f}%'
    else:
        after = od["status"]  # no_book ou exhausted
    print(f'{row["exchange_buy"]} → {row["exchange_sell"]}: '
          f'{row["spread_pct"]}% → {after}')

Dans une boucle, interrogez l’API au plus une fois toutes les meta.freshness_sec secondes : 10 s sur Pro, 5 s sur Max. Le quota et les limites sont détaillés dans le guide des limites de Genesis API.

Carnet d’un marché et carnets d’un coin

/orderbooks/book renvoie le carnet d’un marché, comme la fenêtre « Carnet d’ordres » du site. Trois paramètres obligatoires définissent le marché : exchange (insensible à la casse), market (spot ou futures) et coin. /orderbooks/coin/{coin} renvoie un tableau des mêmes objets pour toutes les bourses et tous les marchés du coin.

curl -G "https://api.genesisarbitrage.com/v1/orderbooks/book" \
  -d exchange=Binance -d market=spot -d coin=BTC \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "exchange": "Binance",
  "market": "spot",
  "coin": "BTC",
  "book_ts": 1794675858,
  "age_sec": 6,
  "stale": false,
  "source": "ws",
  "depth_limited": false,
  "levels_bid": 500,
  "levels_ask": 500,
  "best_bid": 96015.9,
  "best_ask": 96016,
  "bids": [[96015.9, 412300.5], [96015.8, 51020.3], …],
  "asks": [[96016, 388120.2], [96016.1, 20410.7], …],
  "walls_bid": [[95900, 2410000]],
  "walls_ask": [[96500, 1980000]],
  "depth_bid_usd": 61234567,
  "depth_ask_usd": 58765432
}
ChampSignification
best_bid, best_askMeilleur bid et meilleur ask
bids, asks10 meilleurs niveaux : [prix, montant en USD]
walls_bid, walls_askPlus gros murs : [prix, montant en USD]
depth_bid_usd, depth_ask_usdProfondeur de chaque côté à ±50 % du meilleur prix, USD
book_ts, age_sec, staleHeure du carnet et son âge en secondes ; stale — plus de 30 s
source, depth_limitedSource du carnet (ws ou rest) et indicateur de profondeur limitée

La profondeur de marché dans depth_bid_usd et depth_ask_usd indique combien de dollars d’ordres se trouvent d’un côté du carnet : dans l’exemple, environ 58,8 M$ d’asks sur BTC chez Binance à +50 % du meilleur ask.

Avec depth_limited: true, la bourse publie un carnet partiel et un gros volume peut ne pas être rempli. S’il n’y a pas de carnet pour cette bourse, ce marché et ce coin, vous recevez 404.

Historique d’exécution

/orderbooks/exec-history est l’historique de slippage de Genesis Charts : ce que coûtait l’exécution à chaque volume de la grille, en points de base par rapport au milieu du carnet (1 pb = 0,01 %). Une requête accepte jusqu’à 8 marchés dans keys, séparés par des virgules ; interval est obligatoire.

intervalPas du point360 points couvrent
1m1 minute6 heures
15m15 minutes3,75 jours
1h1 heure15 jours
1d1 jourenviron un an

Les données sont collectées depuis le 6 septembre 2026 ; la série quotidienne n’est donc remplie qu’à partir de cette date.

curl -G "https://api.genesisarbitrage.com/v1/orderbooks/exec-history" \
  --data-urlencode "keys=Binance|spot|BTC,ByBit|futures|BTC" \
  -d interval=1h \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "interval": "1h",
  "step_sec": 3600,
  "points": 360,
  "volumes_usd": [500, 1000, 2500, 5000, 10000],
  "last_bucket_ts": 1794672000,
  "series": {
    "Binance|spot|BTC": {
      "buy": [[1, 1, 2, …], [1, 2, 2, …], [2, 3, 4, …],
              [3, 4, 6, …], [5, 7, 9, …]],
      "sell": [[-1, -1, -2, …], …]
    },
    "ByBit|futures|BTC": { … }
  }
}

buy et sell contiennent chacun cinq séries, une par volume de volumes_usd, de 360 valeurs chacune, de la plus ancienne à la plus récente. Le dernier point correspond à last_bucket_ts, et le point i à last_bucket_ts − (points − 1 − i) × step_sec. Les valeurs d’achat sont positives et celles de vente négatives : le prix moyen de la transaction se situe au-dessus et en dessous du milieu du carnet.

La série [5, 7, 9, …] est un achat de 10 000 $ : ses premiers points coûtaient 5 à 9 pb, soit 0,05 à 0,09 % au-dessus du milieu. null dans une série signifie absence de données ou carnet non rempli ; null à la place d’un objet de marché signifie une clé inconnue.

Slippage DEX

/orderbooks/dex-slippage décrit la jambe DEX d’une opération : slippage d’achat et de vente de 100 à 100 000 $, taxes du token et indicateur de honeypot par contrat — comme les colonnes du tableau DEX du site. Filtres : contract (séparés par des virgules pour plusieurs) et network.

curl -G "https://api.genesisarbitrage.com/v1/orderbooks/dex-slippage" \
  -d contract=0x6982508145454ce325ddbe47a25d4ec3d2311933 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "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 de slippage suivent la grille sizes_usd : dans l’exemple, un achat de 5 000 $ glisse de 0,58 % et un achat de 100 000 $ de 6,05 %. null dans un tableau signifie que le pool manque de liquidité pour cette taille.

tax_buy_pct et tax_sell_pct sont la taxe d’achat et de vente du token, en % ; null signifie qu’il n’y a pas de source, pas 0 %. honeypot : no ; suspect — les sources divergent ; yes — la vente peut être impossible.

Comment vérifier une opération avec les carnets

  1. Prenez une ligne d’arbitrage

    Trouvez une opération dans /arbitrage/spot-spot ou un autre jeu de données — voir les endpoints d’arbitrage. Notez le coin, les bourses et spread_pct.

  2. Recalculez le spread à travers les carnets

    Demandez /orderbooks/spreads/spot-spot avec ce coin et la taille de votre transaction, puis comparez spread_pct à order_delta.spread_pct.

  3. Vérifiez la fraîcheur et la profondeur

    Appelez /orderbooks/book pour les deux jambes : age_sec, stale et depth_limited indiquent si les chiffres sont fiables, et les murs montrent où le prix peut buter.

  4. Comparez avec l’historique

    /orderbooks/exec-history montre si ce slippage est normal pour le marché : 1m couvre 6 heures, 1h couvre 15 jours.

  5. Vérifiez les taxes de la jambe DEX

    Pour les opérations DEX – Spot et DEX – Futures, demandez /orderbooks/dex-slippage pour le contrat de la ligne : slippage, taxes et honeypot.

Questions et réponses

En quoi le Δ des carnets diffère-t-il du spread ordinaire ?

Le spread_pct d’une ligne utilise les derniers prix des bourses ; le Δ des carnets utilise les prix moyens d’ordres au marché pour le volume donné. La différence entre les deux est ce que prend le carnet.

Pourquoi ai-je null au lieu d’un prix ?

Dans /orderbooks/exec, le carnet a trop peu d’ordres pour ce volume ; dans le Δ des carnets, le même cas correspond au statut exhausted. Dans l’historique d’exécution, null signifie qu’il n’y a pas de données pour le point, et dans le slippage DEX, que le pool manque de liquidité.

Puis-je calculer l’exécution au-delà de 10 000 $ ?

La grille de /orderbooks/exec et du Δ des carnets est fixe, de 500 à 10 000 $. Pour des tailles supérieures, regardez la profondeur et les murs dans /orderbooks/book ; pour la jambe DEX, /orderbooks/dex-slippage va jusqu’à 100 000 $.