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 $ ;
nullsignifie que le carnet est trop mince pour ce volume. - Les carnets ont 5 à 20 secondes de retard sur la bourse : vérifiez
age_secetstale, 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
| Endpoint | Renvoie | Obligatoire | Documentation |
|---|---|---|---|
/orderbooks/exec | Prix d’achat et de vente pour un volume sur chaque marché | volume | Prix d’exécution |
/orderbooks/spreads/{dataset} | Δ des carnets pour les lignes d’un coin dans un jeu de données d’arbitrage | coin | Δ des carnets |
/orderbooks/book | Carnet d’un marché : 10 niveaux, murs, profondeur, âge | exchange, market, coin | Carnet d’un marché |
/orderbooks/coin/{coin} | Carnets d’un coin sur toutes les bourses et tous les marchés | coin dans le chemin | Carnets d’un coin |
/orderbooks/exec-history | Historique de slippage, jusqu’à 8 marchés par requête | keys, interval | Historique d’exécution |
/orderbooks/dex-slippage | Slippage, 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ètre | Type | Rôle |
|---|---|---|
volume | nombre | Volume en USD : 500, 1000, 2500, 5000 ou 10000, obligatoire |
exchange | chaîne | Filtre par bourse ; séparées par des virgules pour plusieurs |
market | chaîne | spot ou futures |
coin | chaîne | Ticker 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ètre | Type | Rôle |
|---|---|---|
{dataset} | chaîne, dans le chemin | spot-spot, spot-futures, futures-futures, dex-spot ou dex-futures |
coin | chaîne | Ticker du coin, obligatoire |
volume | nombre | 0 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
}
| Champ | Signification |
|---|---|
best_bid, best_ask | Meilleur bid et meilleur ask |
bids, asks | 10 meilleurs niveaux : [prix, montant en USD] |
walls_bid, walls_ask | Plus gros murs : [prix, montant en USD] |
depth_bid_usd, depth_ask_usd | Profondeur de chaque côté à ±50 % du meilleur prix, USD |
book_ts, age_sec, stale | Heure du carnet et son âge en secondes ; stale — plus de 30 s |
source, depth_limited | Source 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.
interval | Pas du point | 360 points couvrent |
|---|---|---|
1m | 1 minute | 6 heures |
15m | 15 minutes | 3,75 jours |
1h | 1 heure | 15 jours |
1d | 1 jour | environ 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
Prenez une ligne d’arbitrage
Trouvez une opération dans
/arbitrage/spot-spotou un autre jeu de données — voir les endpoints d’arbitrage. Notez le coin, les bourses etspread_pct.Recalculez le spread à travers les carnets
Demandez
/orderbooks/spreads/spot-spotavec ce coin et la taille de votre transaction, puis comparezspread_pctàorder_delta.spread_pct.Vérifiez la fraîcheur et la profondeur
Appelez
/orderbooks/bookpour les deux jambes :age_sec,staleetdepth_limitedindiquent si les chiffres sont fiables, et les murs montrent où le prix peut buter.Comparez avec l’historique
/orderbooks/exec-historymontre si ce slippage est normal pour le marché :1mcouvre 6 heures,1hcouvre 15 jours.Vérifiez les taxes de la jambe DEX
Pour les opérations DEX – Spot et DEX – Futures, demandez
/orderbooks/dex-slippagepour le contrat de la ligne : slippage, taxes ethoneypot.
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 $.