Genesis Arbitrage

Genesis Arbitrage · · 13 min de lecture

Données API pour l’arbitrage : spreads, carnets d’ordres et funding

En bref

  • Chaque question du trader a son endpoint : l’écart de prix est spread_pct dans /arbitrage/*, le transfert de la crypto repose sur les indicateurs de dépôt et de retrait ainsi que network et contract, l’exécution pour votre taille se lit dans /orderbooks/* et le cas du funding dans /funding/*.
  • Le spread de la ligne est calculé à partir des dernières transactions. Dans l’exemple illustratif, 1,5 % sur 2 500 $ tombe à 0,72 % après le parcours des carnets d’ordres, puis à environ 0,52 %, soit près de 13 $, après deux frais taker de 0,1 %.
  • Chaque réponse porte ses horodatages : meta.updated_at est le moment de construction de l’instantané, meta.freshness_sec est le pas d’actualisation de votre plan, et age_sec et stale donnent l’âge du carnet d’ordres.
  • Une paire se vérifie en quatre points : écart de prix, transfert, carnet d’ordres et fraîcheur. Si l’un d’eux échoue, l’entrée est annulée.
  • L’arbitrage CEX, le funding et l’open interest sont dans tous les plans Genesis API, les sections on-chain commencent à Start, et les carnets d’ordres et les données DEX viennent avec Pro et Max.

Les données d’arbitrage crypto répondent à cinq questions : y a-t-il un écart de prix, peut-on déplacer la crypto, le carnet d’ordres est-il assez profond pour votre taille, le funding rapporte-t-il, et que font les gros acteurs. Dans Genesis API, chaque question a son propre endpoint et quelques champs de réponse. La première requête et l’enveloppe success, data, meta sont décrites dans la leçon 2 ; cette leçon porte sur les champs à lire et dans quel ordre.

Question du trader → endpoint → champs

QuestionEndpointChamps
Y a-t-il un écart de prix/arbitrage/*spread_pct, price_buy, price_sell
Peut-on déplacer la cryptola même ligne de /arbitrage/spot-spotwithdraw_enabled_buy, deposit_enabled_sell, network, contract
Le carnet est-il assez profond/orderbooks/*order_delta.spread_pct, order_delta.status
Le funding rapporte-t-il/funding/*spread_pct, interval_1, interval_2, next_payout_1
Que font les gros acteurs/onchain/*, /market/open-interestdirection, total_usd, oi_change_1h

L’astérisque désigne un groupe : /arbitrage/* contient sept endpoints, de Spot – Spot aux actions, tandis que /orderbooks/* et /funding/* en contiennent six chacun. Les sections suivantes suivent l’ordre dans lequel on vérifie une paire.

Y a-t-il un écart de prix : spread_pct

Une ligne de la documentation Spot — Spot : FUEL, achat sur ByBit à 0,0007029, vente sur Gate à 0,0007037, spread_pct 0,11. Vérification : (0,0007037 − 0,0007029) / 0,0007029 × 100 ≈ 0,11 %. Le spread de la ligne est calculé à partir de price_buy et price_sell, les prix des dernières transactions ; sur le site, c’est la colonne Prix.

Dans les jeux de données DEX – Spot et DEX – Futures, le signe compte : le plus signifie que le token est moins cher sur le DEX, le moins qu’il est plus cher. Les paramètres et champs des sept jeux de données sont décrits dans le guide des endpoints d’arbitrage.

spread_pct ne répond qu’à la première question : il ne contient ni frais, ni transfert, ni carnet d’ordres.

Peut-on déplacer la crypto : dépôts, retraits, réseau et contrat

Une paire spot entre plateformes exige un transfert : vous achetez la crypto sur une plateforme, la retirez et la déposez sur l’autre. La ligne comporte donc deux indicateurs à lire : withdraw_enabled_buy, si les retraits sont ouverts sur la plateforme d’achat, et deposit_enabled_sell, si les dépôts sont ouverts sur la plateforme de vente. La requête n’a pas de paramètres pour eux, c’est donc votre code qui filtre les lignes.

network et contract indiquent s’il s’agit du même token. Des cryptos différentes peuvent se négocier sous un même ticker sur des plateformes différentes ; comparez donc l’adresse du contrat avec les pages de retrait et de dépôt des deux plateformes. Les contrats d’une crypto par réseau, et les plateformes qui utilisent chacun d’eux, s’obtiennent avec /coins/search sur tous les plans (Coin Search).

Dans les jeux de données DEX, les indicateurs concernent le côté CEX : deposit_enabled et withdraw_enabled. Dans Cross-chain, le token passe par un pont entre les réseaux buy.chain et sell.chain ; il n’y a donc pas d’indicateurs de plateforme.

Le carnet d’ordres est-il assez profond : spread de la ligne et spread après exécution

Un ordre au marché parcourt le carnet d’ordres : un achat prend les asks vers le haut à partir du meilleur, une vente prend les bids vers le bas. Plus la taille est grande, plus le prix moyen se dégrade et moins il reste du spread de la ligne. Order-book Δ, /orderbooks/spreads/{dataset} sur les plans Pro et Max, renvoie ce qui reste pour votre taille (documentation).

Exemple illustratif : crypto LMN, achat sur OKX à 0,4000, vente sur Bitget à 0,4060. Spread de la ligne : (0,4060 − 0,4000) / 0,4000 × 100 = 1,5 %. Requête sur /orderbooks/spreads/spot-spot avec coin=LMN et différentes valeurs de volume :

TailleAchat → venteOrder-book ΔEn dollars
00,4002 → 0,40581,3993 %—
500 $0,4004 → 0,40551,2737 %6,37 $
2 500 $0,4012 → 0,40410,7228 %18,07 $
10 000 $—exhausted—

volume=0 utilise le meilleur ask d’OKX et le meilleur bid de Bitget : les meilleurs ordres sont moins bons que les dernières transactions, si bien que 0,1 point de pourcentage disparaît même pour la plus petite taille. À 2 500 $, le prix moyen d’achat est 0,4012 et le prix moyen de vente 0,4041 : (0,4041 − 0,4012) / 0,4012 × 100 ≈ 0,7228 %. À 10 000 $, les bids de Bitget sont épuisés et order_delta.status vaut exhausted.

Chaque plateforme prélève des frais taker ; l’exemple suppose 0,1 % (maker et taker). À 2 500 $, il vous reste 0,7228 − 2 × 0,1 = 0,5228 %, soit 2 500 × 0,5228 / 100 ≈ 13,07 $. Les frais de retrait ne figurent pas dans les réponses : consultez-les sur la page de retrait de la plateforme et déduisez-les séparément.

Sur Trial et Start, les endpoints de carnets d’ordres renvoient 403 plan_restricted ; le carnet se vérifie donc dans le terminal de la plateforme. Le prix d’exécution et le slippage sont expliqués dans API de carnet d’ordres crypto, et les six endpoints dans le guide des endpoints de carnets d’ordres.

Le funding rapporte-t-il : spread, intervalles et paiements

L’arbitrage de funding consiste à prendre un short là où le taux de financement (funding) est le plus élevé et un long là où il est le plus bas : les mouvements de prix changent peu le résultat, et l’écart de taux s’accumule. Les candidats viennent de /funding/spread sur tous les plans : la meilleure paire de plateformes dans best et son spread_pct (Funding spread).

Le spread de la paire ne dit pas quand ni à quelle fréquence les paiements ont lieu. interval_1 et interval_2 sont les intervalles de funding des deux plateformes, et next_payout_1 et next_payout_2 sont les heures des prochains paiements en UTC : seule une position ouverte au moment du règlement reçoit le funding. Les taux d’intervalles différents se comparent après normalisation sur 8 heures, ce qui correspond au champ funding_8h_pct de /funding/rates.

Exemple illustratif : un spread de 0,03 % par période de 8 heures, avec une position de 5 000 $ sur chaque jambe. Un règlement rapporte 5 000 × 0,03 / 100 = 1,5 $. Quatre transactions, ouverture et clôture des deux jambes, coûtent 4 × 5 000 × 0,1 / 100 = 20 $ avec des frais taker de 0,1 %. Les frais sont amortis après 20 / 1,5 ≈ 13,3 règlements : soit 14 règlements de huit heures, près de cinq jours, si les taux se maintiennent.

L’historique montre si l’écart tient : sur Pro et Max, /funding/analytics/summary avec coin renvoie, pour chaque plateforme, sum (funding cumulé), cov (couverture) et flips (changements de signe) pour chaque période. Les détails se trouvent dans API de taux de financement (funding) et dans le guide des endpoints de funding.

Que font les gros acteurs : on-chain et open interest

Les données on-chain et l’open interest expliquent pourquoi une paire peut se refermer avant que vous l’exécutiez. Une crypto qui afflue vers la plateforme de vente signifie des vendeurs qui arrivent avant votre transfert. Un open interest en hausse signifie de nouvelles positions à effet de levier, et un mouvement brusque contre elles déclenche des liquidations.

Ce que vous voyezRequêteChampsPlans
Flux de cryptos depuis et vers les plateformes/onchain/coin-trafficdirection, target, total_usdStart, Pro, Max
Déblocages de tokens/onchain/unlocksunlock_value_usd, hours_leftStart, Pro, Max
Open interest par plateforme/market/open-interestoi_usd, oi_change_1h, price_change_1hTous

L’exemple de réponse dans la documentation Genesis Onchain montre 18 transferts de LAB vers Gate pour 573 796,98 $ en 5,69 heures, avec direction à deposit. Si LAB a une paire qui vend sur Gate à ce moment-là, un tel flux est une raison de réduire la taille ou de renoncer à l’entrée. Plus de détails dans API de données on-chain et API d’open interest.

Fraîcheur des données et horodatages

Chaque réponse porte son heure : meta.updated_at est le temps unix de construction de l’instantané, et meta.freshness_sec est le pas d’actualisation de votre plan : 60 secondes sur Trial, 30 sur Start, 10 sur Pro et 5 sur Max. L’âge de l’instantané est l’heure actuelle moins updated_at (fraîcheur des données).

Exemple illustratif : plan Trial, la réponse est arrivée à 1783802455 et updated_at vaut 1783802410. L’instantané a 1783802455 − 1783802410 = 45 secondes : ses paires ont été calculées à partir de prix vieux de près d’une minute, et certaines peuvent déjà avoir disparu sur les plateformes.

Les carnets d’ordres ont leur propre horloge : dans /orderbooks/book et /orderbooks/coin/{coin}, chaque carnet a book_ts, age_sec (son âge en secondes) et stale: true lorsqu’il a plus de 30 secondes. Les carnets accusent un retard de 5 à 20 secondes sur la plateforme ; vérifiez donc l’âge des deux jambes : un écart de prix entre un carnet récent et un carnet ancien peut n’être qu’un écart de temps.

Pourquoi un seul champ ne suffit pas : la vérification en quatre points

Chaque champ referme une question, et l’on n’entre que lorsque toutes sont refermées. Un spread de 3 % avec les retraits fermés laisse la crypto bloquée sur la plateforme d’achat. Avec exhausted, votre taille ne sera pas exécutée. Avec un instantané de 50 secondes, la paire peut déjà avoir disparu.

PointChampsLa paire échoue si
1. Écart de prixspread_pctle spread moins deux frais est sous le seuil
2. Transfertwithdraw_enabled_buy, deposit_enabled_sell, contractles retraits ou les dépôts sont fermés, ou le contrat ne correspond pas
3. Carnet d’ordresorder_delta.status, order_delta.spread_pctle statut n’est pas ok ou ce qui reste est sous le seuil
4. Fraîcheurmeta.updated_at, age_sec, stalel’instantané ou un carnet est plus ancien que le seuil

La fonction prend une ligne data de /arbitrage/spot-spot, l’objet order_delta de la même paire de plateformes (None sur Trial et Start) et le meta de la réponse. Les seuils sont illustratifs : ajustez-les à vos frais et à votre plan.

import time

FEE = 0.1      # frais taker supposés par jambe, %
MIN_NET = 0.3  # au moins 0,3 % restant après frais
MAX_AGE = 60   # instantané de 60 secondes au plus


def check(row, od, meta):
    """Les points sur lesquels une paire Spot – Spot a échoué."""
    fails = []
    if row["spread_pct"] - 2 * FEE < MIN_NET:
        fails.append("1 : le spread ne couvre pas les frais")
    if not row["withdraw_enabled_buy"]:
        fails.append("2 : retraits fermés sur la plateforme d’achat")
    if not row["deposit_enabled_sell"]:
        fails.append("2 : dépôts fermés sur la plateforme de vente")
    if od is None:
        fails.append("3 : carnet non vérifié (Trial ou Start)")
    elif od["status"] != "ok":
        fails.append("3 : carnet — " + od["status"])
    elif od["spread_pct"] - 2 * FEE < MIN_NET:
        fails.append("3 : trop peu après le carnet")
    if time.time() - meta["updated_at"] > MAX_AGE:
        fails.append("4 : instantané plus ancien que MAX_AGE secondes")
    return fails

Une liste vide signifie que la paire a passé les quatre points. La paire LMN à 2 500 $ passe : 1,5 − 0,2 = 1,3 % sur la ligne, 0,7228 − 0,2 = 0,5228 % après le carnet, et un instantané de 45 secondes. À 10 000 $, la fonction renvoie « 3 : carnet — exhausted ». Le code ne peut pas vérifier le contrat : vous contrôlez l’adresse sur les pages de retrait et de dépôt des plateformes, et l’âge des carnets des deux jambes provient de /orderbooks/book.

La même vérification sur le tableau du site, sans code, se trouve dans la leçon Spread, profondeur, volume : lire le tableau, et l’interrogation de l’API en boucle dans la leçon 4.

Quelles données avec quel plan

PlanFraîcheurDonnées d’arbitrage
Trial, 20 $ par mois60 sSpot – Spot, Spot – Futures, Futures – Futures, taux et spread de funding, open interest, Fair – Last, pumps, recherche de cryptos
Start, 50 $30 sTout Trial plus les actions, les sections on-chain /onchain/{section}, l’arbitrage de prédictions en modes exact et dutch
Pro, 100 $10 sTous les endpoints : carnets d’ordres et Order-book Δ, DEX – Spot, DEX – Futures, Cross-chain, analytique de funding
Max, 200 $5 sLes mêmes endpoints que Pro, avec 15 requêtes par seconde

Un endpoint hors de votre plan renvoie 403 plan_restricted, et cette réponse ne consomme pas de quota. Les quotas d’appels et les limites de requêtes par seconde figurent sur la page des tarifs de Genesis API.

Pratique

  1. Prenez une paire

    Dans la documentation Spot — Spot, ouvrez le formulaire Essayer, collez votre clé et choisissez une ligne dont le spread est de 1 % ou plus.

  2. Appliquez les points 1 et 2

    Soustrayez deux frais supposés de 0,1 % de spread_pct et vérifiez withdraw_enabled_buy et deposit_enabled_sell. Comparez contract avec la réponse de /coins/search pour cette crypto.

  3. Appliquez le point 3

    Sur Pro ou Max, interrogez /orderbooks/spreads/spot-spot avec cette crypto et volume=1000, puis trouvez la ligne de la même paire de plateformes. Sur Trial et Start, ouvrez le carnet d’ordres dans le terminal de la plateforme.

  4. Appliquez le point 4

    Soustrayez meta.updated_at du temps unix actuel : date +%s l’affiche dans un terminal.

  5. Notez le verdict

    Quel point rejetterait la paire en premier, et quelle part du spread resterait sur 1 000 $.

Questions et réponses

De quelles données a-t-on besoin pour l’arbitrage crypto ?

Les prix de la crypto sur différentes plateformes et le spread entre eux, l’état des dépôts et des retraits avec le réseau et le contrat, les carnets d’ordres pour calculer l’exécution selon votre taille, et l’heure de l’instantané. L’arbitrage de funding ajoute les taux, les intervalles et les heures de paiement. Dans Genesis API, il s’agit de /arbitrage/*, /orderbooks/* et /funding/*.

Peut-on passer une transaction via Genesis API ?

Non. Genesis API ne fait que lire des données et ne passe pas d’ordres : vous ouvrez vous-même les transactions sur les plateformes.