Etherscan API
L'explorateur de référence d'Ethereum, accessible en API sur des dizaines de chaînes.
Etherscan est l'explorateur de blocs de référence pour Ethereum et les chaînes compatibles EVM. Son API REST donne accès aux données on-chain — soldes, transactions, transferts de tokens, code et événements de contrats, prix du gas, statistiques réseau — sans avoir à faire tourner son propre nœud. Depuis la version V2, une seule clé API permet d'interroger plus de 60 chaînes (Ethereum, BNB Chain, Base, Arbitrum, Polygon…) en changeant simplement le paramètre chainid. Un plan gratuit existe, ce qui en fait un point d'entrée populaire pour les développeurs Web3, les outils de portefeuille et les explorateurs maison.
Que propose l'API Etherscan ?
Tarifs de l'API Etherscan
Abonnement mensuel par paliers, facturé selon la limite de débit (appels par seconde) et le quota d'appels par jour. Une seule clé donne accès à toutes les chaînes supportées sur les plans payants ; le plan gratuit ne couvre qu'une partie des chaînes.
Offre gratuite — Plan gratuit avec une clé API : jusqu'à 5 appels par seconde et 100 000 appels par jour, avec accès aux endpoints communautaires d'une sélection de chaînes (la couverture multichaîne complète est réservée aux plans payants). Une attribution est demandée.
Authentification & intégration
Clé API gratuite à générer dans le compte, transmise en paramètre de requête (apikey). Sur l'API V2, le paramètre chainid sélectionne la chaîne interrogée avec la même clé.
API REST en HTTP GET/POST organisée par modules (module=account, contract, gas, stats, logs, proxy…) et actions. Les réponses sont en JSON. La même clé fonctionne sur toutes les chaînes via le paramètre chainid (API V2 unifiée), ce qui remplace les API par chaîne séparées de la V1.
Cas d'usage de l'API Etherscan
- Afficher le solde et l'historique de transactions d'une adresse dans un portefeuille ou un dashboard.
- Récupérer l'ABI et le code vérifié d'un smart contract pour l'analyser ou l'appeler.
- Suivre les transferts de tokens ERC-20/721 d'une adresse pour de la comptabilité ou du tracking.
- Intégrer le prix du gas en temps réel pour estimer le coût d'une transaction.
- Interroger les journaux d'événements d'un contrat pour reconstruire un état applicatif.
- Couvrir plusieurs chaînes EVM (Base, Arbitrum, Polygon, BNB Chain) avec une seule intégration.
✓ Points forts
- Plan gratuit généreux (jusqu'à 100 000 appels/jour) idéal pour démarrer et prototyper.
- API V2 unifiée : une seule clé pour plus de 60 chaînes via le paramètre chainid.
- Données on-chain riches sans avoir à héberger ni synchroniser un nœud.
- Accès au code et à l'ABI des contrats vérifiés, précieux pour le développement et l'audit.
- Documentation claire et explorateur web associé pour vérifier visuellement les données.
⚠ Limites
- Limites de débit basses sur le plan gratuit (5 appels/s), vite atteintes sur un usage intensif.
- Couverture multichaîne complète et endpoints Pro réservés aux plans payants.
- API en lecture seule : pas d'envoi de transactions, hormis le relais JSON-RPC standard.
- Pas de flux temps réel natif (WebSocket) : il faut faire du polling pour suivre les nouveautés.
Questions fréquentes sur l'API Etherscan
Etherscan propose-t-il une API gratuite ?
Oui. Un plan gratuit permet jusqu'à 5 appels par seconde et 100 000 appels par jour avec une clé API, sur une sélection de chaînes. Les plans payants (à partir de 49 $/mois) augmentent les limites et couvrent toutes les chaînes.
Comment obtenir une clé API ?
Il suffit de créer un compte gratuit sur Etherscan puis de générer une clé API dans l'espace dédié. Cette clé est ensuite passée en paramètre apikey de chaque requête.
Une seule clé fonctionne-t-elle sur plusieurs chaînes ?
Oui, avec l'API V2. Une même clé interroge plus de 60 chaînes compatibles EVM en changeant le paramètre chainid (Ethereum, Base, Arbitrum, Polygon, BNB Chain, etc.), ce qui remplace les API séparées par chaîne de la V1.
Peut-on récupérer le code source d'un contrat ?
Oui, via le module contract : on peut récupérer l'ABI et le code source d'un smart contract dès lors qu'il a été vérifié sur Etherscan, ce qui est utile pour l'appeler ou l'auditer.
L'API permet-elle d'envoyer des transactions ?
Non, l'API Etherscan est essentiellement en lecture. Pour diffuser une transaction signée, il faut passer par le module proxy qui relaie les méthodes JSON-RPC standard d'Ethereum vers un nœud.
Y a-t-il un flux temps réel ?
Il n'y a pas de WebSocket natif : l'API fonctionne par requêtes REST. Pour suivre les nouveaux blocs ou transferts, on interroge périodiquement les endpoints concernés (polling).
