Skip to main content
En bref
L’API de Retrait de Blockradar vous permet d’envoyer des stablecoins depuis vos portefeuilles vers des adresses blockchain externes. Elle prend en charge les retraits individuels, les retraits par lots vers plusieurs destinataires et fournit une estimation des frais avant l’exécution.
Interface de Retrait Blockradar

Prérequis

Avant d’utiliser l’API de Retrait, assurez-vous d’avoir :
1

Clé API

Obtenez votre clé API depuis le Tableau de bord Blockradar. Naviguez vers Paramètres → Clés API pour en générer une.
2

Portefeuille Créé

Créez un portefeuille via l’API Créer Portefeuille ou le tableau de bord. Vous aurez besoin du walletId pour les opérations de retrait.
3

ID de l'Actif

Obtenez l’assetId du token que vous souhaitez retirer depuis Actifs dans le tableau de bord ou via l’API Obtenir Actifs.
4

Solde Suffisant

Assurez-vous que votre portefeuille dispose d’un solde suffisant de l’actif à retirer, plus de la monnaie native (ETH, BNB, MATIC, etc.) pour couvrir les frais de réseau.

Comment ça Fonctionne

L’API de Retrait envoie des stablecoins depuis votre portefeuille Blockradar vers n’importe quelle adresse blockchain externe :

Retrait Individuel

Envoyez des actifs à une adresse de destinataire avec un seul appel API.

Retrait par Lots

Envoyez des actifs à plusieurs destinataires en un seul appel API, réduisant les frais généraux 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 Signature Seule

Signez les transactions sans les diffuser pour des cas d’utilisation avancés comme la signature hors ligne ou la soumission personnalisée.

Portefeuille Principal vs Adresse Enfant

L’API de Retrait est disponible à deux niveaux :

Portefeuille Principal

Retirez directement depuis votre portefeuille principal. Idéal pour les opérations de trésorerie et la gestion centralisée des fonds.

Adresse Enfant

Retirez depuis des adresses enfants individuelles. Parfait pour les opérations spécifiques aux utilisateurs et la gestion séparée des fonds.

Endpoints


Retrait Individuel

Envoyez des actifs à une seule adresse de destinataire.

Paramètres de la Requête

Les paramètres marqués avec * sont requis pour les retraits individuels mais ne sont pas nécessaires si vous utilisez le tableau assets pour les retraits par lots.

Exemple de Retrait Individuel

Réponse de Retrait Individuel


Retraits par Lots

Envoyez des actifs à plusieurs destinataires en un seul appel API. Les retraits par lots sont exécutés séquentiellement, et chaque retrait est traité comme une transaction blockchain séparée.

Quand Utiliser les Retraits par Lots

  • Paiements en masse : Payez plusieurs employés, fournisseurs ou partenaires à la fois
  • Distributions : Envoyez des actifs à plusieurs adresses
  • Transferts multi-destinataires : Envoyez différents montants à différentes adresses
  • Efficacité opérationnelle : Réduisez les appels API et simplifiez la logique de paiement

Paramètres de Requête par Lots

Pour les retraits par lots, utilisez le tableau assets au lieu des paramètres individuels : Chaque élément du tableau assets :

Exemple de Retrait par Lots

Réponse de Retrait par Lots

Gestion des Échecs Partiels

Les retraits par lots supportent le succès partiel. Si certains retraits échouent, les autres seront quand même exécutés :

Règles de Retrait par Lots


Estimation des Frais de Réseau

Estimez toujours les frais avant d’exécuter des retraits pour garantir un solde suffisant en monnaie native et afficher des coûts précis aux utilisateurs.

Estimation de Frais Individuelle

Réponse de Frais Individuelle

Estimation de Frais par Lots

Estimez les frais pour plusieurs retraits à la fois :

Réponse de Frais par Lots

Champs de Réponse des Frais


Mode Signature Seule

Signez les transactions sans les diffuser sur la blockchain. Utile pour :
  • Signature hors ligne : Préparez les transactions pour une soumission ultérieure
  • Flux multi-signatures : Collectez les signatures avant la soumission
  • Inspection des transactions : Examinez les détails de la transaction avant la diffusion

Exemple de Signature Seule

Réponse de Signature Seule


Retraits depuis Adresse Enfant

Retirez depuis des adresses enfants individuelles au lieu du portefeuille principal :
Les retraits depuis adresse enfant supportent également les opérations par lots en utilisant le tableau assets, suivant le même format que les retraits par lots du portefeuille principal.

Événements Webhook

Surveillez l’achèvement des retraits via les webhooks :

Payload du Webhook


Exemple de Flux Complet

Voici une implémentation complète montrant le flux estimation des frais → confirmation utilisateur → retrait :

Réponses d’Erreur


Meilleures Pratiques

Sécurité

  • Validez les adresses : Vérifiez toujours les adresses des destinataires avant d’initier des retraits
  • Utilisez des références : Suivez les retraits avec des IDs de référence uniques pour la réconciliation
  • Implémentez les webhooks : Écoutez les événements withdraw.success et withdraw.failed pour confirmer le statut
  • Vérifiez AML : Blockradar examine automatiquement les adresses—examinez les transactions signalées

Gestion des Frais

  • Estimez avant d’exécuter : 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 l’efficacité : Regroupez plusieurs retraits pour réduire les appels API et les frais généraux opérationnels

Gestion des Erreurs

  • Gérez les échecs partiels : Dans les retraits par lots, vérifiez les tableaux success et errors
  • Implémentez les réessais : Utilisez le backoff exponentiel pour les échecs transitoires
  • Enregistrez toutes les transactions : Stockez les IDs de transaction et les hashes pour le débogage et la réconciliation

Performance

  • Utilisez des tailles de lot appropriées : Les lots plus grands réduisent les appels API mais augmentent le temps de requête individuelle
  • Mettez en cache les IDs d’actifs : Stockez les IDs d’actifs localement pour éviter les recherches répétées
  • Implémentez la limitation de débit : Respectez les limites de débit de l’API pour éviter le throttling

Référence API

Endpoints du Portefeuille Principal

Endpoints de l’Adresse Enfant


Support

L’API de Retrait fournit une interface flexible pour envoyer des stablecoins vers des adresses externes. Commencez par des retraits individuels et l’estimation des frais, puis intégrez les opérations par lots pour les paiements en masse à mesure que vos besoins augmentent.