Saltar al contenido principal
En resumen
La API de Retiros te permite enviar stablecoins desde tus billeteras principales o direcciones secundarias a cualquier dirección externa. Soporta retiros individuales y por lotes, estimación de tarifas de red y modo solo-firma para flujos de custodia personalizada.

​
Requisitos Previos

1

Clave API

Obtén tu clave API desde el Dashboard de Blockradar.
2

Billetera con Saldo

Asegúrate de que tu billetera tenga suficiente saldo del activo que deseas enviar, más el token nativo para las tarifas de gas.
3

ID de Activo

Obtén el assetId específico de la billetera desde GET /v1/wallets/{walletId}/assets.

​
Billetera Principal vs Dirección Secundaria

Billetera Principal

Retira directamente desde tu billetera principal. Ideal para operaciones de tesorería y pagos salientes.

Dirección Secundaria

Retira desde direcciones individuales de usuario. Ideal para liquidar fondos de usuarios específicos.

​
Endpoints

OperaciónBilletera PrincipalDirección Secundaria
Tarifa de RedPOST /v1/wallets/{walletId}/withdraw/network-feePOST /v1/wallets/{walletId}/addresses/{addressId}/withdraw/network-fee
RetirarPOST /v1/wallets/{walletId}/withdrawPOST /v1/wallets/{walletId}/addresses/{addressId}/withdraw

​
Paso 1: Estimar la Tarifa de Red

Siempre estima el costo de gas antes de ejecutar un retiro. 
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: '0xDestinoExterno'
    })
  }
).then(r => r.json());

​
Paso 2: Ejecutar el Retiro

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: '0xDestinoExterno',
      reference: 'pago-123',
      metadata: { userId: 'usuario_abc' }
    })
  }
).then(r => r.json());

​
Eventos Webhook

EventoDescripción
withdrawal.successRetiro confirmado on-chain
withdrawal.failedRetiro fallido

​
Referencia de API

EndpointDescripción
Tarifa de Red - Billetera PrincipalEstimar gas desde billetera principal
Retirar - Billetera PrincipalEjecutar retiro desde billetera principal
Tarifa de Red - Dirección SecundariaEstimar gas desde dirección secundaria
Retirar - Dirección SecundariaEjecutar retiro desde dirección secundaria