Activité des wallets
Surveillez des adresses de wallets pour recevoir les transferts natifs et de tokens entrants et sortants.
API Webhook blockchain pour l’activité des wallets et les transferts de tokens
Les Webhooks d’adresse envoient les transferts des portefeuilles surveillés et les logs de contrats correspondants à votre récepteur HTTPS ; vérifiez les signatures, dédupliquez les événements et gérez les écarts avant de créditer un paiement.
Les événements antérieurs au bloc d’activation d’une adresse nécessitent une récupération historique distincte ; replay ne les récupère pas. Les transferts natifs internes sont exclus. Les confirmations doivent respecter la plage de chaque chaîne renvoyée par GET /v1/push/chains et comptent des blocs, pas les étiquettes safe ou finalized.
Livrez l’activité des adresses à votre endpoint
native.transfer livre les transferts natifs des transactions de premier niveau ; token.transfer livre les transferts ERC-20, ERC-721 et ERC-1155. log livre les autres logs dont le contrat émetteur ou topics[1]–topics[3] contiennent une adresse surveillée.
GET /v1/push/chains renvoie les chaînes actuellement prises en charge et leurs limites de confirmations. Appelez-le avec votre API key avant de choisir les chaînes d’un abonnement.
Un abonnement couvre plusieurs chaînes avec une URL de réception. Les développeurs et AI Agents ont les mêmes options de capacité et tarifs.
- Libre-service
Jusqu’à 1,000,000 adresses par abonnement. Disponible dès l’inscription.
Tarifs standard à l’usage
- Entreprise
10,000,000 / 100,000,000 adresses par abonnement.
Contactez-nous pour activer
Les deux offres utilisent les mêmes tarifs par adresse-jour et événement livré.
Exploitez l’activité des wallets et contrats
Paiements en stablecoins
Recevez les transferts ERC-20 de USDT / USDC, puis validez le contrat du token, le destinataire et le montant entier avant de créditer un paiement.
Événements de contrats
Surveillez un contrat pour recevoir ses logs, ou recevez les logs avec une adresse surveillée dans topics[1]–topics[3].
Transferts NFT
Traitez les transferts ERC-721 et ERC-1155 avec token_id et, pour les transferts par lots, batch_index.
Vérifiez, confirmez et récupérez les événements
- Vérifiez la signature HMAC-SHA256 sur `webhook-id.webhook-timestamp.raw-body` avec le secret de l’abonnement avant de traiter les événements ; utilisez le corps brut de la requête et ne parsez pas le JSON au préalable.
- La livraison se fait au moins une fois. Dédupliquez par id d’événement et renvoyez 2xx après avoir enregistré durablement le résultat du traitement. Les livraisons échouées sont réessayées tant que l’abonnement est online et que les événements sont dans la période de rétention.
- Définissez confirmations par chaîne dans les limites de GET /v1/push/chains. chain.reorg signale des blocs remplacés : marquez les anciens événements par ref, conservez les événements canoniques renvoyés automatiquement et dédupliquez par id.
- Replay relivre les correspondances stockées dans la plage rejouable. Il ne récupère pas l’activité antérieure à l’ajout d’une adresse ou chaîne à l’abonnement.
Tarifs
Le tableau reprend les poids CU et le quota gratuit d’adresses de GET /v1/plans. Les événements de données sont facturés par livraison ; les tentatives automatiques et événements de contrôle sont gratuits. Les livraisons replay sont facturées au tarif de l’événement.
Notifications webhook
Poids CU issus de GET /v1/plans. Les nouvelles tentatives automatiques sont gratuites.
Adresses gratuites par compte et par jour UTC : 1000
Le quota gratuit d’adresses par compte et par jour UTC est partagé par tous les groupes d’abonnement, quel que soit le forfait. Pour chaque groupe, on compte son nombre maximal d’adresses pendant ses périodes en ligne ce jour-là ; le quota est réparti par ID de groupe croissant. Une même adresse dans deux groupes compte deux fois ; le nombre de chaînes d’un groupe ne multiplie pas son nombre d’adresses. Un groupe hors ligne ou supprimé toute la journée ne contribue pas au décompte. Pour chaque groupe, le nombre restant après déduction de sa part du quota est multiplié par le poids CU `push.address_day` dans `method_weights`. Le quota actuellement configuré provient de la même politique tarifaire que la facturation des adresses-jours ; ce n’est ni une limite de capacité du compte ni un quota distinct par groupe.
| Méthode | Unité de facturation | CU |
|---|---|---|
| push.address_day | Jour d’adresse facturable | 33 |
| push.history | Requête d’historique réussie | 25 |
| push.log | Événement de données livré | 150 |
| push.native_transfer | Événement de données livré | 150 |
| push.token_transfer | Événement de données livré | 150 |