Obtenez la spécification API Chaingateway

La spécification OpenAPI de Chaingateway est une description lisible par machine de l'API REST au format OpenAPI 3.0.3. Elle liste les endpoints des sept chaînes, la forme de leurs requêtes et réponses, et l'authentification par token Bearer. Chaingateway est une API REST : il n'y a donc aucune application à installer.

Que contient la spécification OpenAPI ?

Elle décrit 202 opérations sur 164 chemins : un endpoint de compte, un endpoint de prix, et des endpoints d'adresses, de transactions, de soldes, de blocs et de webhooks pour sept chaînes. Parmi elles, 116 opérations sont en GET, 68 en POST, 12 en DELETE et 6 en PUT.

Chaîne Opérations Standards de token Opérations de webhook
Bitcoin 21 Aucune 8
Ethereum 31 ERC-20, ERC-721 8
BNB Smart Chain 31 BEP-20, BEP-721 8
TRON 40 TRC-10, TRC-20, TRC-721 8
Solana 15 SPL Aucune
Polygon 31 ERC-20, ERC-721 8
Arbitrum 31 ERC-20, ERC-721 8

Le fichier est en YAML, d'environ 1 Mo, en version de spécification 2.1.0. Le serveur est https://app.chaingateway.io. Chaque endpoint utilise l'authentification HTTP Bearer, et vous créez le token sous API tokens dans votre tableau de bord. Ces nombres datent du 5 novembre 2026 et changent quand des endpoints sont ajoutés.

Comment générer un client à partir de la spécification ?

Pointez un générateur de code OpenAPI vers le fichier. La commande ci-dessous crée un client TypeScript avec OpenAPI Generator, et l'option -g choisit le langage.

npx @openapitools/openapi-generator-cli generate \
  -i https://chaingateway.io/openapi.yaml \
  -g typescript-fetch \
  -o ./chaingateway-client

Remplacez typescript-fetch par le générateur de votre langage, par exemple python ou php. Exécutez un appel sur testnet avant de vous fier au code généré. OpenAPI Generator : liste des générateurs

Comment importer la spécification dans Postman ou Insomnia ?

Les deux outils importent directement un fichier OpenAPI. Choisissez l'option d'import, puis collez l'URL https://chaingateway.io/openapi.yaml ou sélectionnez le fichier téléchargé. Renseignez l'en-tête Authorization avec votre token Bearer, et ajoutez X-Network: testnet pendant vos tests.

Comment appeler l'API sans client généré ?

Envoyez votre token Bearer dans l'en-tête Authorization vers https://app.chaingateway.io. Ajoutez X-Network: testnet pour utiliser testnet. Omettez l'en-tête, ou mettez mainnet, pour mainnet.

curl https://app.chaingateway.io/api/account \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Network: testnet"

GET /api/account permet de vérifier rapidement qu'un token fonctionne.

À quoi ressemblent les réponses et les erreurs dans la spécification ?

Les opérations réussies renvoient HTTP 200 ou 201, et les exemples enveloppent le résultat dans une enveloppe avec les champs status, ok, message et data. Sur les 202 opérations, la spécification documente 401 (non authentifié) 50 fois, 422 (par exemple validation des données échouée ou fonds insuffisants) 70 fois, 404 cinq fois et 400 une fois.

Un exemple de 401 affiche « Unauthenticated. » dans le champ message. Lisez d'abord le code d'état, puis le message.

Existe-t-il une version lisible de la spécification ?

Oui. La référence interactive de l'API affiche le même fichier : vous pouvez lire les endpoints, essayer des requêtes et copier des exemples avant de générer le moindre code. Ouvrir la référence de l'API

Quelles parties de la spécification sont obsolètes ?

Les opérations Tron Paymaster figurent toujours dans le fichier, au nombre de cinq. Paymaster est obsolète et remplacé par TronFuel : laissez-les de côté dans les nouvelles intégrations. Solana n'a aucun endpoint de webhook.

Prêt à développer ?

Chaque intégration repose sur la même API REST Chaingateway — essai gratuit de 7 jours, sans carte bancaire, sans KYC. Les offres démarrent à 49 €/mois et couvrent les sept chaînes prises en charge.