En bref
L’API Withdraw de Blockradar vous permet d’envoyer des actifs stablecoin depuis vos portefeuilles vers des adresses blockchain externes. Elle prend en charge les retraits individuels, les retraits par lot vers plusieurs destinataires, et fournit une estimation des frais avant l’exécution.
L’API Withdraw de Blockradar vous permet d’envoyer des actifs stablecoin depuis vos portefeuilles vers des adresses blockchain externes. Elle prend en charge les retraits individuels, les retraits par lot vers plusieurs destinataires, et fournit une estimation des frais avant l’exécution.

Prérequis
Avant d’utiliser l’API Withdraw, assurez-vous d’avoir :1
Clé API
Obtenez votre clé API depuis le Tableau de bord Blockradar. Accédez à Developers pour en générer une.
2
Portefeuille créé
Créez un portefeuille via l’API Create Wallet ou depuis le tableau de bord. Vous aurez besoin du
walletId pour les opérations de retrait.3
ID d'actif
Récupérez l’
assetId du token que vous souhaitez retirer depuis Assets dans le tableau de bord ou via l’API Get Assets.4
Solde suffisant
Assurez-vous que votre portefeuille dispose d’un solde suffisant de l’actif à retirer, ainsi que du token natif (ETH, BNB, MATIC, etc.) pour couvrir les frais de réseau.
Comment ça fonctionne
L’API Withdraw envoie des actifs stablecoin depuis votre portefeuille Blockradar vers n’importe quelle adresse blockchain externe :Retrait individuel
Envoyez des actifs à une adresse destinataire en un seul appel API.
Retrait par lot
Envoyez des actifs à plusieurs destinataires en un seul appel API, réduisant la surcharge et simplifiant les paiements en masse.
Estimation des frais
Calculez les frais de réseau avant l’exécution pour garantir un solde suffisant et afficher les coûts aux utilisateurs.
Mode Sign-Only
Signez les transactions sans les diffuser pour des cas d’usage avancés tels que la signature hors ligne ou l’envoi personnalisé.
Master Wallet vs Child Address
L’API Withdraw est disponible à deux niveaux :Master Wallet
Retirez directement depuis votre master wallet. Idéal pour les opérations de trésorerie et la gestion centralisée des fonds.
Child Address
Retirez depuis des child addresses individuelles. Parfait pour les opérations spécifiques aux utilisateurs et la gestion ségréguée des fonds.
Endpoints
Retrait individuel
Envoyez des actifs à une seule adresse destinataire.Paramètres de la requête
Les paramètres marqués d’un
* sont requis pour les retraits individuels mais ne sont pas nécessaires si vous utilisez le tableau assets pour les retraits par lot.Exemple de retrait individuel
Réponse du retrait individuel
Retraits par lot
Envoyez des actifs à plusieurs destinataires en un seul appel API. Les retraits par lot sont exécutés séquentiellement, et chaque retrait est traité comme une transaction blockchain distincte.Quand utiliser les retraits par lot
- Paiements en masse : Payez plusieurs employés, fournisseurs ou partenaires en une seule fois
- Distributions : Envoyez des actifs à plusieurs adresses
- Transferts multi-destinataires : Envoyez des montants différents à des adresses différentes
- Efficacité opérationnelle : Réduisez les appels API et simplifiez la logique de paiement
Paramètres de la requête par lot
Pour les retraits par lot, utilisez le tableauassets au lieu des paramètres individuels :
Chaque élément du tableau
assets :
Exemple de retrait par lot
Réponse du retrait par lot
Gestion des échecs partiels
Les retraits par lot prennent en charge le succès partiel. Si certains retraits échouent, les autres seront tout de même exécutés :Règles des retraits par lot
Estimation des frais réseau
Estimez toujours les frais avant d’exécuter des retraits afin de garantir un solde suffisant en token natif et d’afficher des coûts précis aux utilisateurs.Estimation des frais individuels
Réponse pour les frais individuels
Estimation des frais par lot
Estimez les frais pour plusieurs retraits à la fois :Réponse pour les frais par lot
Champs de la réponse de frais
Mode Sign-Only
Signez des transactions sans les diffuser sur la blockchain. Utile pour :- Signature hors ligne : Préparez les transactions pour un envoi ultérieur
- Flux multi-signatures : Collectez les signatures avant l’envoi
- Inspection de transaction : Vérifiez les détails de la transaction avant de la diffuser
Exemple de Sign-Only
Réponse Sign-Only
Retraits depuis une Child Address
Retirez depuis des child addresses individuelles plutôt que depuis la master wallet :Événements de Webhook
Surveillez l’achèvement des retraits via les webhooks :Payload du Webhook
Exemple de flux complet
Voici une implémentation complète du flux : estimation des frais → confirmation de l’utilisateur → retrait :Réponses d’erreur
Solde insuffisant
Solde insuffisant
Gas insuffisant
Gas insuffisant
Adresse invalide
Adresse invalide
Actif introuvable
Actif introuvable
Montant trop faible
Montant trop faible
Taille du lot dépassée
Taille du lot dépassée
Bonnes pratiques
Sécurité
- Validez les adresses : Vérifiez toujours les adresses des destinataires avant d’initier les retraits
- Utilisez des références : Suivez les retraits avec des identifiants de référence uniques pour la réconciliation
- Mettez en place des webhooks : Écoutez les événements
withdraw.successetwithdraw.failedpour confirmer le statut - Vérifiez l’AML : Blockradar filtre automatiquement les adresses ; examinez toute transaction signalée
Gestion des frais
- Estimez avant l’exécution : Appelez toujours l’endpoint network-fee avant les retraits
- Surveillez le solde natif : Assurez-vous d’avoir suffisamment d’ETH/BNB/MATIC pour les frais de gas
- Utilisez les lots pour plus d’efficacité : Regroupez plusieurs retraits pour réduire les appels API et la charge opérationnelle
Gestion des erreurs
- Gérez les échecs partiels : Dans les retraits par lot, vérifiez à la fois les tableaux
successeterrors - Mettez en place des nouvelles tentatives : Utilisez un backoff exponentiel pour les défaillances transitoires
- Journalisez toutes les transactions : Stockez les identifiants et hashes de transactions pour le débogage et la réconciliation
Performance
- Utilisez des tailles de lot appropriées : Des lots plus grands réduisent les appels API mais augmentent le temps de chaque requête
- Mettez en cache les IDs d’actifs : Stockez les IDs d’actifs localement pour éviter les recherches répétées
- Mettez en place une limitation de débit : Respectez les limites de débit de l’API pour éviter le throttling
Référence API
Endpoints Master Wallet
Endpoints Child Address
Support
- Email : [email protected]
- Documentation : Référence API
- Guide Webhooks : Webhooks
L’API Withdraw fournit une interface flexible pour envoyer des actifs stablecoin vers des adresses externes. Commencez par les retraits individuels et l’estimation des frais, puis intégrez les opérations par lot pour les paiements en masse à mesure que vos besoins grandissent.

