Aller au contenu

Portail développeur Chaingateway

Le portail développeur Chaingateway documente une API REST pour créer des adresses, envoyer des transactions, lire des soldes et recevoir des webhooks sur Ethereum, TRON, BNB Smart Chain, Bitcoin, Polygon, Arbitrum et Solana. Commencez par le démarrage rapide : vous créez une clé API, envoyez une requête et passez du mainnet au testnet avec un seul en-tête.

Vous pouvez gérer des wallets, envoyer des coins natifs et des tokens, lire des données blockchain et vous abonner aux notifications de paiement via une seule interface REST. Le fichier OpenAPI répertorie plus de 200 opérations. Elles sont regroupées par chaîne, et le même schéma se répète sur les chaînes EVM.

TâcheEndpoint typiqueChaînes
Créer une adresse de walletPOST /api/v2/{chain}/addressesEthereum, BSC, Polygon, Arbitrum, TRON, Solana
Créer un wallet Bitcoin et ses adressesPOST /api/v2/bitcoin/walletsBitcoin
Envoyer des coins natifsPOST /api/v2/{chain}/transactionsles sept
Envoyer des tokensPOST /api/v2/{chain}/transactions/erc20, /bep20, /trc20, /SPLtoutes sauf Bitcoin
Lire les soldes et les blocsGET /api/v2/{chain}/balances/{address}les sept
Être notifié des paiementsPOST /api/v2/{chain}/webhookstoutes sauf Solana
Lire un prix de marchéGET /api/v2/market/price/{crypto}/{fiat}indépendant de la chaîne

Solana ne dispose d’aucun endpoint de webhook : les dépôts sur Solana doivent donc être détectés en lisant les soldes ou les transactions. Les wallets sont non custodiaux : soit vous choisissez un mot de passe qui protège la clé stockée, soit vous recevez la clé privée dans la réponse et la conservez vous-même. Gestion des wallets explique les deux modes.

Parcours d'intégration en quatre étapes : créer une clé API, créer une adresse, envoyer ou lire des transactions, recevoir des webhooks 1. Créer une clé API Dashboard, tokens API 2. Créer une adresse POST /api/v2/{chain}/addresses 3. Envoyer et lire des transactions POST et GET /api/v2/{chain}/transactions 4. Recevoir des webhooks POST /api/v2/{chain}/webhooks, votre serveurrépond 200
L'ordre habituel d'une intégration. Les étapes 3 et 4 peuvent se dérouler en parallèle.

Créez une clé API dans le dashboard, puis envoyez-la comme token Bearer dans l’en-tête Authorization. Un nouveau compte démarre avec un essai gratuit de 7 jours, sans carte bancaire ni vérification d’identité. La requête ci-dessous lit le numéro du dernier bloc Ethereum.

Fenêtre de terminal
curl --request GET \
--url https://app.chaingateway.io/api/v2/ethereum/blocks/number \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN'

Une requête sans token valide renvoie HTTP 401 avec le corps {"message":"Unauthenticated."}. Pour exécuter le même appel sur le réseau de test, ajoutez l’en-tête X-Network: testnet. Omettez l’en-tête, ou réglez-le sur mainnet, pour utiliser le réseau principal. Le démarrage rapide détaille la création du compte, les en-têtes et une requête POST dans quatre langages.

Sept blockchains sont disponibles, chacune avec un mainnet et un testnet. Les testnets sont Sepolia pour Ethereum, Nile pour TRON, le testnet de BNB Smart Chain, Bitcoin testnet3, Amoy pour Polygon, Arbitrum Sepolia et le devnet de Solana. Réseaux pris en charge liste tous les réseaux avec la valeur X-Network correspondante et explique les deux valeurs de l’en-tête.

La référence interactive se trouve sur chaingateway.io/docs. Elle est générée à partir du même fichier openapi.yaml que vous pouvez importer dans Postman, Insomnia ou un générateur de code. Chaque opération indique ses paramètres, les règles de validation des adresses et des exemples de réponses, y compris les corps d’erreur.

Les réponses partagent une même enveloppe JSON avec les champs status, ok et message. Les appels réussis ajoutent data, une validation échouée ajoute un objet errors. La FAQ montre des exemples des deux cas.

Chaque endpoint répond en JSON. Un appel réussi renvoie ok: true avec le statut HTTP et un champ data. L’exemple suivant est la réponse de GET /api/v2/ethereum/gasprice.

{
"ok": true,
"status": 200,
"message": "Successfully parsed",
"data": { "gasPrice": "12.28" }
}

Une validation échouée renvoie le statut 422 et nomme chaque champ rejeté. La même enveloppe porte les erreurs blockchain, par exemple des fonds insuffisants pour le gas. Un mauvais mot de passe de wallet renvoie 401 avec le message Wrong password provided. Écrivez votre client de façon à vérifier d’abord ok, puis à journaliser message et errors lorsque la valeur est false.

{
"status": 422,
"ok": false,
"message": "Data validation failed",
"errors": { "password": ["The password field is required."] }
}

Choisissez la page qui correspond à la tâche en cours :

Les conventions HTTP et de tokens utilisées dans cette documentation sont définies par des normes publiques :