Passer au contenu principal
En bref
L’API de Retraits vous permet d’envoyer des stablecoins depuis vos portefeuilles principaux ou adresses secondaires vers n’importe quelle adresse externe. Elle supporte les retraits individuels et par lot, l’estimation des frais réseau et le mode signature uniquement pour les flux de garde personnalisée.

​
Prérequis

1

Clé API

Obtenez votre clé API depuis le Tableau de bord Blockradar.
2

Portefeuille avec Solde

Assurez-vous que votre portefeuille dispose d’un solde suffisant de l’actif à envoyer, plus le token natif pour les frais de gas.
3

ID d'Actif

Obtenez l’assetId spécifique au portefeuille depuis GET /v1/wallets/{walletId}/assets.

​
Portefeuille Principal vs Adresse Secondaire

Portefeuille Principal

Retirez directement depuis votre portefeuille principal. Idéal pour les opérations de trésorerie et les paiements sortants.

Adresse Secondaire

Retirez depuis des adresses utilisateur individuelles. Idéal pour liquider les fonds d’utilisateurs spécifiques.

​
Endpoints

OpérationPortefeuille PrincipalAdresse Secondaire
Frais RéseauPOST /v1/wallets/{walletId}/withdraw/network-feePOST /v1/wallets/{walletId}/addresses/{addressId}/withdraw/network-fee
RetirerPOST /v1/wallets/{walletId}/withdrawPOST /v1/wallets/{walletId}/addresses/{addressId}/withdraw

​
Étape 1 : Estimer les Frais Réseau

const fee = await fetch(
  `https://api.blockradar.co/v1/wallets/${walletId}/withdraw/network-fee`,
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
    body: JSON.stringify({
      assetId: 'asset_usdc_base_mainnet',
      amount: '100',
      recipientAddress: '0xDestinationExterne'
    })
  }
).then(r => r.json());

​
Étape 2 : Exécuter le Retrait

const withdrawal = await fetch(
  `https://api.blockradar.co/v1/wallets/${walletId}/withdraw`,
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
    body: JSON.stringify({
      assetId: 'asset_usdc_base_mainnet',
      amount: '100',
      recipientAddress: '0xDestinationExterne',
      reference: 'paiement-123',
      metadata: { userId: 'utilisateur_abc' }
    })
  }
).then(r => r.json());

​
Événements Webhook

ÉvénementDescription
withdrawal.successRetrait confirmé on-chain
withdrawal.failedRetrait échoué

​
Référence API

EndpointDescription
Frais Réseau - Portefeuille PrincipalEstimer le gas depuis le portefeuille principal
Retirer - Portefeuille PrincipalExécuter un retrait depuis le portefeuille principal
Frais Réseau - Adresse SecondaireEstimer le gas depuis l’adresse secondaire
Retirer - Adresse SecondaireExécuter un retrait depuis l’adresse secondaire