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.
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.

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
| Opération | Portefeuille Principal | Adresse Enfant |
|---|---|---|
| Retirer | POST /v1/wallets/{walletId}/withdraw | POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw |
| Frais de Réseau | POST /v1/wallets/{walletId}/withdraw/network-fee | POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw/network-fee |
| Signature Seule | POST /v1/wallets/{walletId}/withdraw/sign | POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw/sign |
Retrait Individuel
Envoyez des actifs à une seule adresse de destinataire.Paramètres de la Requête
| Paramètre | Type | Requis | Description |
|---|---|---|---|
assetId | string | Oui* | L’UUID de l’actif à retirer. Requis si le tableau assets n’est pas fourni. |
address | string | Oui* | L’adresse du portefeuille de destination. Requis si le tableau assets n’est pas fourni. |
amount | string | Oui* | Le montant du retrait. Doit être supérieur à 0. Requis si le tableau assets n’est pas fourni. |
reference | string | Non | Votre ID de suivi interne pour le retrait. |
note | string | Non | Un court message ou une remarque interne. Non visible sur la blockchain. |
metadata | object | Non | Paires clé-valeur personnalisées pour des détails de transaction supplémentaires. |
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 tableauassets au lieu des paramètres individuels :
| Paramètre | Type | Requis | Description |
|---|---|---|---|
assets | array | Oui | Tableau d’objets de retrait (max 20 par lot) |
assets :
| Champ | Type | Requis | Description |
|---|---|---|---|
id | string | Oui | L’UUID de l’actif à retirer |
address | string | Oui | L’adresse du portefeuille de destination |
amount | string | Oui | Le montant du retrait. Doit être supérieur à 0. |
reference | string | Non | Note de référence optionnelle pour ce retrait |
note | string | Non | Un court message ou une remarque interne. Non visible sur la blockchain. |
metadata | object | Non | Paires clé-valeur personnalisées pour des détails de transaction supplémentaires. |
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
| Règle | Valeur |
|---|---|
| Taille maximale du lot | 20 retraits par requête |
| Taille minimale du lot | 1 retrait |
| Ordre d’exécution | Séquentiel |
| Gestion des erreurs | Succès partiel (les échecs n’arrêtent pas les retraits suivants) |
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
| Champ | Description |
|---|---|
networkFee | Frais de gas en unités de token natif (retrait individuel) |
networkFeeInUSD | Frais de gas convertis en USD (retrait individuel) |
fees | Tableau des estimations de frais individuelles (retrait par lots) |
totalNetworkFee | Somme de tous les frais de réseau (retrait par lots) |
totalNetworkFeeInUSD | Frais de réseau total en USD (retrait par lots) |
transactionFee | Frais de transaction de la plateforme (si applicable) |
nativeBalance | Solde actuel en token natif |
nativeBalanceInUSD | Solde en token natif en USD |
estimatedArrivalTime | Temps de confirmation attendu en secondes |
errors | Tableau des estimations échouées (retrait par lots) |
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 :Événements Webhook
Surveillez l’achèvement des retraits via les webhooks :| Événement | Description |
|---|---|
withdraw.success | Retrait terminé et confirmé sur la blockchain |
withdraw.failed | Le retrait a échoué à l’exécution |
withdraw.cancelled | Le retrait a été annulé avant l’achèvement |
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
Solde Insuffisant
Solde Insuffisant
Gas Insuffisant
Gas Insuffisant
Adresse Invalide
Adresse Invalide
Actif Non Trouvé
Actif Non Trouvé
Montant Trop Faible
Montant Trop Faible
Taille du Lot Dépassée
Taille du Lot Dépassée
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.successetwithdraw.failedpour 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
successeterrors - 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
| Endpoint | Description |
|---|---|
| Retirer | Exécuter un retrait individuel ou par lots |
| Frais de Réseau | Estimer les frais de retrait |
| Signature Seule | Signer sans diffuser |
Endpoints de l’Adresse Enfant
| Endpoint | Description |
|---|---|
| Retirer | Exécuter un retrait individuel ou par lots |
| Frais de Réseau | Estimer les frais de retrait |
| Signature Seule | Signer sans diffuser |
Support
- Email : [email protected]
- Documentation : Référence API
- Guide Webhooks : Webhooks
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.

