Skip to main content
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.
Interface Withdraw de Blockradar

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 tableau assets 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 :
Les retraits depuis une child address prennent également en charge les opérations par lot via le tableau assets, en suivant le même format que les retraits par lot 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


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.success et withdraw.failed pour 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 success et errors
  • 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

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.