Genesis Arbitrage

Genesis Arbitrage · · 13 min de lecture

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

EndpointCe qu'il renvoiePlans
/arbitrage/spot-spotSpreads entre marchés spot des CEXTrial, Start, Pro, Max
/arbitrage/spot-futuresSpot contre futures sur les CEXTrial, Start, Pro, Max
/arbitrage/futures-futuresFutures entre exchanges CEXTrial, Start, Pro, Max
/arbitrage/dex-spotPrix DEX contre spot CEXPro, Max
/arbitrage/dex-futuresPrix DEX contre futures CEXPro, Max
/arbitrage/crosschainUn token sur DEX entre réseauxPro, Max
/arbitrage/stocksActions tokenisées, métaux, indices et matières premières sur CEXStart, 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ètreTypeEffetExemple
coinstringFiltre par ticker de la coincoin=BTC
exchangestringFiltre par exchange ; plusieurs séparés par des virgulesexchange=Binance,OKX
min_spreadnumberSpread minimal, %min_spread=1
min_volumenumberVolume minimal sur 24 h des deux côtés, USDmin_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",
  …
}
ChampTypeContenu
exchange_buy, exchange_sellstringExchange d'achat et exchange de vente
market_buy, market_sellstringMarché du côté : spot ou futures
price_buy, price_sellnumberPrix à partir desquels le spread est calculé
bid_*, ask_*number ou nullMeilleurs bid et ask de chaque côté
spread_pctnumberSpread, %
network, contractstring ; string ou nullRéseau du token et adresse du contrat
deposit_enabled_*, withdraw_enabled_*booleanDépôts et retraits ouverts ou non sur chaque exchange
volume_24h_buy, volume_24h_sellnumber ou nullVolume sur 24 h, USD
trade_url_buy, trade_url_sellstringLiens 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ètreTypeEffetExemple
coinstringFiltre par ticker de la coincoin=SCR
exchangestringExchange CEX ; plusieurs séparés par des virgulesexchange=MEXC
min_spreadnumberSpread minimal, %min_spread=2
min_liquiditynumberLiquidité minimale, USDmin_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.

ChampTypeContenu
exchangestringExchange CEX
cex_price, dex_pricenumberPrix sur le CEX et sur le DEX
liquidity_usdnumberLiquidité du pool, USD
market_cap, dex_volume_24hnumber ou nullCapitalisation et volume sur 24 h du DEX (DEX – Spot)
ticker, max_position_usdstring ; number ou nullPaire de l'exchange et position maximale, USD (DEX – Futures)
deposit_enabled, withdraw_enabledbooleanDépôts et retraits ouverts ou non sur le CEX
dexscreener_url, dextools_url, gmgn_urlstring ou nullLiens 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ètreTypeEffetExemple
coinstringFiltre par ticker du tokencoin=WLD
chainstringFiltre par réseauchain=ethereum
min_spreadnumberSpread minimal, %min_spread=1
min_liquiditynumberLiquidité minimale, USDmin_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,
    …
  }
}
ChampTypeContenu
buy.chainstringRéseau du côté
buy.pairstringPaire DEX, par exemple WLD/USDC
buy.contractstringAdresse du contrat sur ce réseau
buy.price_usd, buy.liquidity_usd, buy.volume_24h_usdnumberPrix, liquidité du pool et volume sur 24 h, USD
buy.pool_created_atstring ou nullDate de création du pool
buy.dexscreener_url, dextools_url, gmgn_urlstring ou nullLiens 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ètreTypeEffetExemple
symbolstringFiltre par ticker de l'instrumentsymbol=BRENT
categorystringCatégorie : Stock, Metal, Index ou Commoditycategory=Commodity
exchangestringFiltre par exchange ; plusieurs séparés par des virgulesexchange=MEXC
min_spreadnumberSpread 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 :

EndpointTableau du site et son guide
/arbitrage/spot-spotSpot – Spot
/arbitrage/spot-futuresSpot – Futures
/arbitrage/futures-futuresArbitrage de futures
/arbitrage/dex-spotDEX – Spot
/arbitrage/dex-futuresDEX – Futures
/arbitrage/crosschainCrosschain
/arbitrage/stocksArbitrage d'actions

Comment construire un moniteur de paires

  1. 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.

  2. Réduisez l'ensemble côté serveur

    Fixez min_spread au-dessus de la somme de vos frais, et min_volume ou min_liquidity pour écarter les coins illiquides.

  3. Gardez dans le code les lignes exécutables

    Spot – Spot : withdraw_enabled_buy et deposit_enabled_sell. DEX – Spot avec spread positif : deposit_enabled ; avec spread négatif : withdraw_enabled. Actions : recherchez par symbol_on_buy et symbol_on_sell.

  4. Vérifiez le token et le carnet d'ordres

    Comparez contract et network, et calculez l'exécution pour votre taille avec les endpoints de carnets d'ordres.

  5. 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.