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.

Ce que couvre l'API
Les endpoints reflètent les sections du site :
- Arbitrage — Spot - Spot, Spot - Futures, Futures - Futures, DEX - Spot, DEX - Futures, Crosschain et Arbitrage boursier.
- Carnets d'ordres — prix d'exécution pour un volume sur chaque marché, « Δ des ordres » pour les lignes d'arbitrage, carnet d'ordres d'un marché, historique d'exécution et slippage DEX (sur les forfaits API Pro et Max).
- Marchés de prédiction — arbitrage de prédictions et état des plateformes ; analytique, smart money, grosses transactions et classement des traders sur les forfaits API Pro et Max.
- Funding — taux de funding sur tous les exchanges, spread de funding et analytique historique du funding (sur les forfaits API Pro et Max).
- Marché — Fair - Last, CEX Pumps - Dumps, DEX Dumps, Suivi OI.
- On-chain — gros transferts, flux CEX, mint et bridges, wallets d'équipes, positions Perp. DEX, déblocages, claims, hacks ; sur les forfaits API Pro et Max aussi l'aperçu DEX, l'analytique et la fiche de la monnaie.
- IA et recherche — signaux Genesis AI+ et fiche complète de la monnaie.
- Compte — l'état de votre clé : forfait, quota consommé et limites.
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 API | Appels par mois | Fraîcheur des données |
|---|---|---|
| Trial | 500K | 60 s |
| Start | 2M | 30 s |
| Pro | 5M | 10 s |
| Max | 10M | 5 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
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.
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.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 esthttps://api.genesisarbitrage.com/v1. Un bon premier endpoint est/account/usage— il affiche votre forfait et le quota restant.Analyser la réponse
Une réponse réussie arrive dans une enveloppe unique : un tableau
dataet un blocmeta. 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
datacontient un tableau ou un objet, selon l'endpoint.metacontient le nombre d'éléments, l'heure de la dernière mise à jour des données, le délai de votre forfait en secondes et votre forfait.- Les valeurs vides sont
null. Les heures sont en secondes unix. - Les spreads et les taux sont des pourcentages : 0.92 signifie 0.92 %.
- Tous les paramètres de filtre sont optionnels : sans eux, un endpoint renvoie l'ensemble complet des données.
Erreurs et limites
| Code | Signification |
|---|---|
| 401 | La clé est absente, invalide ou révoquée |
| 403 | L'endpoint ne fait pas partie de votre forfait |
| 404 | L'endpoint ou la ressource est introuvable |
| 429 | Limite de requêtes dépassée — voir les en-têtes X-RateLimit et Retry-After |
| 500 | Erreur interne, réessayez plus tard |
| 503 | Les 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
- Clé API : obtenir, conserver, réémettre — où se trouve la clé dans votre profil et comment la protéger.
- Limites : quota, requêtes par seconde, fraîcheur — comment éviter les réponses 429.
- Réponses et erreurs : JSON, ETag, codes HTTP — l'enveloppe de réponse, le 304 et les nouvelles tentatives.
- Endpoints par groupe : arbitrage, carnets d'ordres, funding, marché et signaux IA, on-chain, marchés de prédiction et surebets.
- Genesis API pour les agents IA — la spécification OpenAPI, llms.txt et le function calling.
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.