Endpoints d'arbitrage de Genesis API : CEX, DEX, cross-chain et actions
En bref
- Sept endpoints renvoient les paires des tableaux du site : les trois jeux CEX sont sur tous les plans, les actions à partir de Start, et DEX – Spot, DEX – Futures et Cross-chain sur Pro et Max.
- Une ligne CEX contient les prix et les meilleures cotations des deux exchanges, le réseau, le contrat, l'état des dépôts et des retraits et les volumes : les champs pour choisir des paires réellement exécutables.
- Le spread de la réponse est l'écart de prix au moment du snapshot : les frais, les transferts et le slippage n'y sont pas déduits.
Les endpoints d'arbitrage de Genesis API renvoient les mêmes paires que les tableaux de Genesis Arbitrage : spreads entre marchés spot et futures des CEX, entre DEX et CEX, entre réseaux et sur des actions tokenisées. Chaque élément de data est une paire : où acheter, où vendre, le spread — l'écart de prix en pourcentage — et les champs pour le vérifier : état des dépôts et des retraits, volumes, liquidité, liens. Les sept endpoints sont des requêtes GET avec la clé dans l'en-tête X-API-Key.
Sept endpoints et plans
| Endpoint | Ce qu'il renvoie | Plans |
|---|---|---|
/arbitrage/spot-spot | Spreads entre marchés spot des CEX | Trial, Start, Pro, Max |
/arbitrage/spot-futures | Spot contre futures sur les CEX | Trial, Start, Pro, Max |
/arbitrage/futures-futures | Futures entre exchanges CEX | Trial, Start, Pro, Max |
/arbitrage/dex-spot | Prix DEX contre spot CEX | Pro, Max |
/arbitrage/dex-futures | Prix DEX contre futures CEX | Pro, Max |
/arbitrage/crosschain | Un token sur DEX entre réseaux | Pro, Max |
/arbitrage/stocks | Actions tokenisées, métaux, indices et matières premières sur CEX | Start, Pro, Max |
Un endpoint hors de votre plan renvoie 403 plan_restricted ; les codes d'erreur sont dans Réponses et erreurs de Genesis API, et les prix sur la page tarifs de Genesis API.
CEX : Spot – Spot, Spot – Futures, Futures – Futures
Les trois endpoints CEX acceptent les mêmes paramètres et renvoient des lignes au même format. Les champs market_buy et market_sell indiquent le marché de chaque côté : spot et spot, spot et futures, ou futures et futures.
| Paramètre | Type | Effet | Exemple |
|---|---|---|---|
coin | string | Filtre par ticker de la coin | coin=BTC |
exchange | string | Filtre par exchange ; plusieurs séparés par des virgules | exchange=Binance,OKX |
min_spread | number | Spread minimal, % | min_spread=1 |
min_volume | number | Volume minimal sur 24 h des deux côtés, USD | min_volume=50000 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/spot-spot" \
-d min_spread=1 -d min_volume=50000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/spot-futures" \
-d coin=BTC -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/futures-futures" \
-d exchange=Binance,OKX -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Une ligne de réponse tirée de la documentation Spot — Spot, abrégée :
{
"coin": "FUEL",
"exchange_buy": "ByBit",
"exchange_sell": "Gate",
"market_buy": "spot",
"market_sell": "spot",
"price_buy": 0.0007029,
"price_sell": 0.0007037,
"ask_buy": 0.0007029,
"bid_sell": 0.0007021,
"spread_pct": 0.11,
"network": "ETH",
"contract": "0x675B68AA4d9c2d3BB3F0397048e62E6B7192079c",
"withdraw_enabled_buy": true,
"deposit_enabled_sell": true,
"volume_24h_buy": 17652.64,
"volume_24h_sell": 12512.51,
"trade_url_buy": "https://www.bybit.com/trade/spot/FUEL/USDT",
…
}
| Champ | Type | Contenu |
|---|---|---|
exchange_buy, exchange_sell | string | Exchange d'achat et exchange de vente |
market_buy, market_sell | string | Marché du côté : spot ou futures |
price_buy, price_sell | number | Prix à partir desquels le spread est calculé |
bid_*, ask_* | number ou null | Meilleurs bid et ask de chaque côté |
spread_pct | number | Spread, % |
network, contract | string ; string ou null | Réseau du token et adresse du contrat |
deposit_enabled_*, withdraw_enabled_* | boolean | Dépôts et retraits ouverts ou non sur chaque exchange |
volume_24h_buy, volume_24h_sell | number ou null | Volume sur 24 h, USD |
trade_url_buy, trade_url_sell | string | Liens vers les terminaux de trading |
spread_pct est calculé à partir de price_buy et price_sell — la colonne Prix du site, la dernière transaction. La transaction elle-même passe par le carnet d'ordres : vous achetez à ask_buy et vous vendez à bid_sell. Dans l'exemple, bid_sell est inférieur à ask_buy : aux meilleures cotations, la paire est donc négative :
(0,0007021 − 0,0007029) / 0,0007029 × 100 ≈ −0,11 %
L'écart exact pour votre taille vient d'Order-book Δ — GET /orderbooks/spreads/{dataset}, décrit dans le guide des endpoints de carnets d'ordres.
Paires Spot – Spot transférables
Une paire spot entre exchanges ne fonctionne que si la coin peut être déplacée : achetée sur un exchange, retirée puis créditée sur l'autre. Il faut donc des retraits ouverts sur l'exchange d'achat (withdraw_enabled_buy) et des dépôts ouverts sur l'exchange de vente (deposit_enabled_sell). La requête n'a pas de paramètres pour ces indicateurs : on les filtre dans le code, tandis que min_volume écarte côté serveur les coins illiquides.
import os
import requests
r = requests.get(
"https://api.genesisarbitrage.com/v1/arbitrage/spot-spot",
headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
params={"min_spread": 1, "min_volume": 50000},
timeout=15,
)
r.raise_for_status()
rows = r.json()["data"]
# Le transfert ne fonctionne que si les retraits sont ouverts sur
# l'exchange d'achat et les dépôts sur l'exchange de vente
ok = [x for x in rows
if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
ok.sort(key=lambda x: x["spread_pct"], reverse=True)
for x in ok[:10]:
print(f'{x["coin"]:<8} {x["exchange_buy"]} → '
f'{x["exchange_sell"]} {x["spread_pct"]}% '
f'network {x["network"]}')
Les nouvelles tentatives sur 429 et 503 s'appuient sur la fonction get_json de Réponses et erreurs de Genesis API. Un bot qui envoie ces paires sur Telegram est construit dans l'article bot d'arbitrage crypto en Python.
DEX – Spot et DEX – Futures
Les jeux DEX comparent le prix d'un token sur un DEX, un exchange décentralisé, avec son prix sur un CEX : DEX – Spot contre le spot, DEX – Futures contre les futures. Les deux endpoints sont sur les plans Pro et Max.
| Paramètre | Type | Effet | Exemple |
|---|---|---|---|
coin | string | Filtre par ticker de la coin | coin=SCR |
exchange | string | Exchange CEX ; plusieurs séparés par des virgules | exchange=MEXC |
min_spread | number | Spread minimal, % | min_spread=2 |
min_liquidity | number | Liquidité minimale, USD | min_liquidity=50000 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/dex-spot" \
-d min_spread=2 -d min_liquidity=50000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/dex-futures" \
-d min_spread=1 -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Une ligne DEX – Spot de la documentation, abrégée :
{
"coin": "SCR",
"exchange": "MEXC",
"cex_price": 0.02691,
"dex_price": 0.02679,
"spread_pct": 0.45,
"network": "SCROLL",
"liquidity_usd": 10544.15,
"market_cap": 5091835.0,
"deposit_enabled": true,
"withdraw_enabled": true,
"dexscreener_url": "https://dexscreener.com/scroll/0xd296…",
"dextools_url": null,
"gmgn_url": null,
…
}
Le prix sur MEXC est supérieur à celui du pool : le spread est donc positif. Le signe de spread_pct donne la direction : un plus signifie que le token est moins cher sur le DEX, on y achète et on vend sur le CEX ; un moins signifie l'inverse.
| Champ | Type | Contenu |
|---|---|---|
exchange | string | Exchange CEX |
cex_price, dex_price | number | Prix sur le CEX et sur le DEX |
liquidity_usd | number | Liquidité du pool, USD |
market_cap, dex_volume_24h | number ou null | Capitalisation et volume sur 24 h du DEX (DEX – Spot) |
ticker, max_position_usd | string ; number ou null | Paire de l'exchange et position maximale, USD (DEX – Futures) |
deposit_enabled, withdraw_enabled | boolean | Dépôts et retraits ouverts ou non sur le CEX |
dexscreener_url, dextools_url, gmgn_url | string ou null | Liens DexScreener, DEXTools et GMGN |
Le pool de l'exemple contient 10 544 $ de liquidité : un achat important fera donc bouger son prix. Le slippage pour des tailles de 100 à 100 000 $, les taxes du token et le drapeau honeypot par contrat viennent de GET /orderbooks/dex-slippage sur les plans Pro et Max.
Cross-chain : un token entre réseaux
GET /arbitrage/crosschain compare le prix DEX d'un token entre blockchains, sur les plans Pro et Max. Une ligne contient coin, spread_pct et deux objets aux mêmes champs : buy, le côté où le token est moins cher, et sell, où il coûte plus. Le token passe d'un réseau à l'autre par un bridge cross-chain.
| Paramètre | Type | Effet | Exemple |
|---|---|---|---|
coin | string | Filtre par ticker du token | coin=WLD |
chain | string | Filtre par réseau | chain=ethereum |
min_spread | number | Spread minimal, % | min_spread=1 |
min_liquidity | number | Liquidité minimale, USD | min_liquidity=20000 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/crosschain" \
-d coin=WLD -d min_liquidity=20000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Une ligne de la documentation Cross-chain, abrégée :
{
"coin": "WLD",
"spread_pct": 0.59,
"buy": {
"chain": "optimism",
"pair": "WLD/USDC",
"price_usd": 0.4048,
"liquidity_usd": 48747,
"volume_24h_usd": 2484,
"pool_created_at": "2023-07-24 08:44:19 UTC",
…
},
"sell": {
"chain": "ethereum",
"pair": "WLD/WETH",
"price_usd": 0.4072,
"liquidity_usd": 421426,
…
}
}
| Champ | Type | Contenu |
|---|---|---|
buy.chain | string | Réseau du côté |
buy.pair | string | Paire DEX, par exemple WLD/USDC |
buy.contract | string | Adresse du contrat sur ce réseau |
buy.price_usd, buy.liquidity_usd, buy.volume_24h_usd | number | Prix, liquidité du pool et volume sur 24 h, USD |
buy.pool_created_at | string ou null | Date de création du pool |
buy.dexscreener_url, dextools_url, gmgn_url | string ou null | Liens DexScreener, DEXTools et GMGN |
sell a les mêmes champs. pool_created_at est une chaîne de date UTC, et non des secondes unix comme la plupart des horodatages de l'API ; elle peut valoir null. Un pool créé il y a quelques jours est une raison de vérifier les contrats des deux côtés : sur un nouveau réseau, un autre token peut se cacher derrière le même ticker.
Arbitrage d'actions : actions, métaux, indices, matières premières
GET /arbitrage/stocks renvoie les spreads sur les actions tokenisées, les métaux, les indices et les matières premières entre exchanges CEX et est disponible à partir du plan Start.
| Paramètre | Type | Effet | Exemple |
|---|---|---|---|
symbol | string | Filtre par ticker de l'instrument | symbol=BRENT |
category | string | Catégorie : Stock, Metal, Index ou Commodity | category=Commodity |
exchange | string | Filtre par exchange ; plusieurs séparés par des virgules | exchange=MEXC |
min_spread | number | Spread minimal, % | min_spread=0.3 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/stocks" \
-d category=Commodity -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Une ligne de la documentation de l'arbitrage d'actions, abrégée :
{
"symbol": "BRENT",
"category": "Commodity",
"exchange_buy": "MEXC",
"exchange_sell": "Ourbit",
"symbol_on_buy": "UKOIL",
"symbol_on_sell": "BRENTOIL",
"price_buy": 76.68,
"price_sell": 76.82,
"spread_pct": 0.18,
…
}
symbol est le ticker courant de l'instrument, tandis que symbol_on_buy et symbol_on_sell sont ses noms sur chaque exchange : dans l'exemple, le pétrole Brent se négocie sous UKOIL sur MEXC et sous BRENTOIL sur Ourbit. Cherchez l'instrument sur l'exchange par symbol_on_*. La ligne n'a ni réseau, ni contrat, ni champs de dépôt : sur les CEX, ces instruments se négocient comme des futures perpétuels, et la paire s'ouvre avec des positions Long et Short (guide du tableau).
Réponses de l'API et tableaux du site
Les colonnes des tableaux du site sont expliquées dans les guides :
| Endpoint | Tableau du site et son guide |
|---|---|
/arbitrage/spot-spot | Spot – Spot |
/arbitrage/spot-futures | Spot – Futures |
/arbitrage/futures-futures | Arbitrage de futures |
/arbitrage/dex-spot | DEX – Spot |
/arbitrage/dex-futures | DEX – Futures |
/arbitrage/crosschain | Crosschain |
/arbitrage/stocks | Arbitrage d'actions |
Comment construire un moniteur de paires
Choisissez l'endpoint selon votre plan
Consultez le tableau des plans ci-dessus : les jeux DEX et Cross-chain ne sont que sur Pro et Max.
Réduisez l'ensemble côté serveur
Fixez
min_spreadau-dessus de la somme de vos frais, etmin_volumeoumin_liquiditypour écarter les coins illiquides.Gardez dans le code les lignes exécutables
Spot – Spot :
withdraw_enabled_buyetdeposit_enabled_sell. DEX – Spot avec spread positif :deposit_enabled; avec spread négatif :withdraw_enabled. Actions : recherchez parsymbol_on_buyetsymbol_on_sell.Vérifiez le token et le carnet d'ordres
Comparez
contractetnetwork, et calculez l'exécution pour votre taille avec les endpoints de carnets d'ordres.Interrogez au rythme de votre plan
Pas plus souvent que
meta.freshness_sec. Le bot envoie une alerte, et c'est vous qui passez la transaction sur l'exchange.
Questions et réponses
Ces endpoints peuvent-ils passer une transaction ?
Non. Genesis API ne fournit que des données et ne passe aucun ordre. Un bot sur Genesis API trouve une paire et vous envoie une alerte, et c'est vous qui ouvrez la transaction sur l'exchange.
Pourquoi les lignes n'ont-elles pas les colonnes Book ni Ord. ?
Les deux sont calculées à partir des carnets d'ordres et s'obtiennent à part : Order-book Δ via GET /orderbooks/spreads/{dataset} et le carnet d'ordres d'un marché via GET /orderbooks/book, tous deux sur les plans Pro et Max.
De quel plan ai-je besoin pour DEX et Cross-chain ?
Pro ou Max. Trial couvre les trois jeux CEX, et Start ajoute l'arbitrage d'actions.