API BNB Smart Chain : ce que vous pouvez créer
Ce qu'une API BNB Smart Chain (BSC) fournit : portefeuilles, transferts BNB et BEP-20, soldes et webhooks, avec exemples de requêtes et limites du RPC public.
Relu par Maurice Sobiera
Une API BNB Smart Chain est une interface web pour BNB Smart Chain (BSC), anciennement Binance Smart Chain. Elle permet de créer des portefeuilles, d’envoyer des BNB et des tokens BEP-20, de lire les soldes et de recevoir des dépôts, sans nœud BSC. Votre backend envoie des requêtes HTTPS ; le fournisseur gère la signature et la diffusion.
Cet article liste ce que couvre une telle API, montre deux requêtes contre les endpoints BSC de Chaingateway, et explique quand les endpoints RPC publics suffisent.
Que couvre une API BSC ?
Une API BSC couvre les opérations dont a besoin un backend de paiement ou de portefeuille. Les endpoints Chaingateway, tels que listés dans le fichier OpenAPI, se répartissent en cinq groupes :
| Groupe | Endpoints |
|---|---|
| Adresses | POST /api/v2/bsc/addresses crée un portefeuille, GET liste les portefeuilles, POST /api/v2/bsc/addresses/import importe une clé privée |
| Soldes | GET /api/v2/bsc/balances/{address} pour le BNB, GET /api/v2/bsc/balances/{address}/bep20/{contract_address} pour un token BEP-20 |
| Transferts | POST /api/v2/bsc/transactions pour le BNB, POST /api/v2/bsc/transactions/bep20 pour les tokens BEP-20, POST /api/v2/bsc/transactions/bep721 pour les NFT |
| Données de chaîne | Dernier bloc, bloc par numéro ou par hash, transaction, reçu, prix du gas, propriétaire d’un NFT et URI de token |
| Webhooks | Créer, mettre à jour et supprimer des webhooks, lister les notifications, lister les notifications échouées et les relancer |
Toutes les requêtes utilisent un token bearer dans l’en-tête Authorization. Envoyez X-Network: testnet pour utiliser le réseau de test. Sans cet en-tête, la requête part sur le mainnet.
Comment vérifier un solde et envoyer du BNB ?
Vérifiez le solde avec une requête GET, puis envoyez du BNB avec une requête POST. Les deux exemples utilisent l’URL de base https://app.chaingateway.io et un token de votre tableau de bord.
curl https://app.chaingateway.io/api/v2/bsc/balances/0x0000000000000000000000000000000000001000 \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "X-Network: testnet"La réponse contient le solde sous forme de chaîne décimale :
{"status": 200, "ok": true, "message": "Balance fetched", "data": "0.000000000000000000"}Pour envoyer du BNB depuis un portefeuille créé avec l’API, transmettez l’expéditeur, le destinataire, le montant et le mot de passe du portefeuille. Les champs de gas sont facultatifs.
curl -X POST https://app.chaingateway.io/api/v2/bsc/transactions \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "X-Network: testnet" \ -H "Content-Type: application/json" \ -d '{"from": "0x...", "to": "0x...", "amount": "0.001", "password": "wallet-password"}'Si l’expéditeur n’a pas assez de BNB pour le montant plus le gas, l’API renvoie le statut 422 avec le message insufficient funds du nœud. Un mot de passe de portefeuille erroné renvoie 401.
Comment lire le solde d’un token et une transaction ?
Lisez le solde d’un token BEP-20 avec l’adresse du portefeuille et l’adresse du contrat du token dans le chemin. Lisez une transaction avec son hash. Les deux sont des requêtes GET avec les mêmes en-têtes que ci-dessus.
# BEP-20 token balancecurl https://app.chaingateway.io/api/v2/bsc/balances/0xWalletAddress/bep20/0xTokenContract \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN"
# Transaction with decoded datacurl https://app.chaingateway.io/api/v2/bsc/transactions/0xTransactionHash/decoded \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN"
# Current gas pricecurl https://app.chaingateway.io/api/v2/bsc/gasprice \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN"Le endpoint de solde renvoie le montant du token sous forme de chaîne décimale : vous n’avez donc pas à le mettre à l’échelle vous-même avec les décimales du token. Le endpoint de transaction décodée renvoie une transaction en champs lisibles, au lieu de données hexadécimales brutes. Un hash inconnu renvoie une réponse 422 avec le message transaction not found.
GET /api/v2/bsc/transactions liste l’historique de vos propres transactions. Il ne liste que les transactions effectuées via l’API Chaingateway, car Chaingateway n’indexe pas vos adresses de lui-même. Utilisez un webhook pour voir les transferts entrants.
Si vous possédez déjà un portefeuille, POST /api/v2/bsc/addresses/import importe sa clé privée. Les portefeuilles importés et les nouveaux utilisent les mêmes endpoints d’envoi et de webhook.
Comment être averti des dépôts ?
Créez un webhook avec POST /api/v2/bsc/webhooks. Le champ url est obligatoire. Filtrez par to (une adresse de réception), par from, ou par contractaddress pour un token, et définissez type sur BNB, BEP20 ou BEP721. Lorsqu’une transaction correspondante est détectée, Chaingateway envoie les données de la transaction à votre URL.
Les webhooks ne sont pas relancés automatiquement. Une livraison échouée apparaît dans GET /api/v2/bsc/webhooks/notifications/failed, et POST /api/v2/bsc/webhooks/notifications/{id}/retry la renvoie. Rendez votre endpoint de réception idempotent, sur la base de l’identifiant de transaction, afin qu’une relance ne crédite pas un compte deux fois.
Qu’est-ce que BEP-20 ?
BEP-20 est le standard de token de BNB Smart Chain. Selon sa spécification, il dérive de l’ERC-20 d’Ethereum et impose les fonctions symbol(), decimals(), totalSupply(), balanceOf(), transfer(), transferFrom(), approve() et allowance(). C’est pourquoi le même code de portefeuille fonctionne pour les tokens sur BSC et sur Ethereum, et pourquoi les endpoints BSC de Chaingateway reprennent ceux d’Ethereum.
Quand les endpoints RPC publics suffisent-ils ?
BNB Chain publie des endpoints JSON-RPC publics pour le mainnet et le testnet. La documentation BNB Chain indique une limite de 10 000 requêtes par 5 minutes, et précise que eth_getLogs est désactivé sur les endpoints publics du mainnet.
Pour des prototypes et des lectures occasionnelles, cela suffit. Pour un service qui surveille de nombreuses adresses, il vous faut soit votre propre nœud, soit un fournisseur, soit une API qui vous pousse les événements. Pour la voie du nœud, voir comment dialoguer avec un nœud en JSON-RPC. Davantage d’informations côté Chaingateway figurent sur la page API BSC.
Comment nous rédigeons ces articles
Prêt à le construire vous-même ? Obtenir votre clé API — essai de 7 jours, sans carte bancaire — ou consultez API Binance Smart Chain pour la référence complète des endpoints.