Genesis Arbitrage

Genesis Arbitrage · · Mis à jour · 6 min de lecture

Démarrage rapide de Genesis API : clé, première requête et limites

En bref

  • Genesis API est un accès REST aux données de Genesis Arbitrage : spreads CEX et DEX, carnets d'ordres, funding, cross-chain, flux on-chain, marchés de prédiction et signaux Genesis AI+.
  • Trois étapes mènent à la première requête : un forfait, une clé dans votre profil et une requête GET avec l'en-tête X-API-Key.
  • Votre forfait définit le quota d'appels, les requêtes par seconde et le délai des données — de 60 secondes en Trial à 5 secondes en Max.

Genesis API fournit les données de Genesis Arbitrage sous forme d'API REST : spreads entre CEX et DEX, carnets d'ordres, funding, cross-chain, flux on-chain, marchés de prédiction et signaux Genesis AI+. Chaque outil du site est disponible comme endpoint distinct, dans un format JSON unique. Votre première requête nécessite un forfait API, une clé et un en-tête HTTP — aucun SDK n'est requis, tout langage disposant d'un client HTTP convient.

Démarrage rapide de Genesis API : clé, première requête et limites
Aperçu dans Genesis Arbitrage

Ce que couvre l'API

Les endpoints reflètent les sections du site :

Les jeux de données sont décrits sur la page Genesis API ; les paramètres et les champs de chaque endpoint figurent dans la documentation.

Forfaits et limites

L'API a ses propres forfaits, distincts de l'abonnement au site : Trial, Start, Pro et Max. Ils diffèrent par le quota d'appels, la limite de requêtes par seconde et la fraîcheur des données.

Forfait APIAppels par moisFraîcheur des données
Trial500K60 s
Start2M30 s
Pro5M10 s
Max10M5 s

Trial coûte 20 $ par mois, et Max autorise 15 requêtes par seconde. Les endpoints qui ne font pas partie de votre forfait renvoient une erreur 403 avec le code plan_restricted. Les requêtes au-delà des limites ne sont pas facturées : attendez la nouvelle période ou passez au forfait supérieur. Seules les réponses 200 consomment le quota : les erreurs et les réponses 304 sont gratuites. Les prix et le comparatif complet se trouvent sur la page Tarifs de Genesis API.

Votre première requête

  1. Choisir un forfait

    Sur la page Tarifs de Genesis API, choisissez un forfait et une période, puis cliquez sur « S'abonner ». Le paiement se fait en crypto, comme l'abonnement au site. Si un autre forfait API est déjà actif, payer un nouveau forfait le remplace et le reste est perdu — le site vous en avertit d'abord.

  2. Obtenir votre clé

    Dans votre profil, dans le bloc Genesis API, cliquez sur « Obtenir la clé ». Une clé gns_live_… apparaît dans la fenêtre « Votre clé API » — cliquez sur « Copier » et enregistrez-la. Elle n'est affichée qu'une seule fois.

  3. Faire une requête

    Envoyez un simple HTTP GET et passez la clé dans l'en-tête X-API-Key. L'URL de base est https://api.genesisarbitrage.com/v1. Un bon premier endpoint est /account/usage — il affiche votre forfait et le quota restant.

  4. Analyser la réponse

    Une réponse réussie arrive dans une enveloppe unique : un tableau data et un bloc meta. Si quelque chose ne va pas, consultez le tableau des erreurs ci-dessous.

Un exemple curl :

curl "https://api.genesisarbitrage.com/v1/account/usage" \
  -H "X-API-Key: gns_live_…"

La documentation propose un formulaire « Essayer » : collez votre clé, cliquez sur « Envoyer la requête » et consultez une réponse abrégée directement sur la page. La clé n'est stockée que dans votre navigateur.

Format de la réponse

Erreurs et limites

CodeSignification
401La clé est absente, invalide ou révoquée
403L'endpoint ne fait pas partie de votre forfait
404L'endpoint ou la ressource est introuvable
429Limite de requêtes dépassée — voir les en-têtes X-RateLimit et Retry-After
500Erreur interne, réessayez plus tard
503Les données sont en cours de reconstruction, réessayez dans quelques secondes — voir Retry-After

Les en-têtes X-RateLimit de chaque réponse indiquent votre limite de requêtes par seconde, le nombre de requêtes restantes dans la fenêtre actuelle et le moment où la fenêtre se réinitialise. Les en-têtes X-Quota indiquent le quota d'appels pour la période, ce qu'il en reste et le moment de sa réinitialisation. Chaque réponse contient aussi un X-Request-Id : en contactant le support, indiquez-le avec l'heure de la requête en UTC, l'endpoint et le statut. N'envoyez jamais la clé elle-même.

Et ensuite

Questions et réponses

En quoi Genesis API diffère-t-il des API gratuites des exchanges ?

Les API des exchanges renvoient les carnets d'ordres et les tickers d'une seule plateforme. Genesis API renvoie des spreads calculés sur des dizaines d'exchanges et de réseaux, des indicateurs de dépôt et de retrait, et des données nettoyées des paires illiquides.

Que se passe-t-il si je dépasse la limite ?

Le serveur répond par un 429 avec les en-têtes X-RateLimit et Retry-After. Les requêtes excédentaires ne sont pas facturées.

Puis-je changer de forfait API ?

Oui. Un nouveau forfait prend effet dès le paiement : les nouvelles limites et la fraîcheur s'appliquent immédiatement, le quota d'appels repart de zéro et le reste de l'ancien forfait est perdu. Renouveler le même forfait ajoute des jours à la durée en cours.

Puis-je utiliser les données dans mon propre produit ?

Oui, vous pouvez construire vos propres services, bots et tableaux de bord sur Genesis API. Vous ne pouvez pas revendre les données brutes telles quelles.