Skip to main content
En resumen
La API de Withdraw de Blockradar le permite enviar activos stablecoin desde sus billeteras a direcciones blockchain externas. Soporta retiros individuales, retiros por lotes hacia múltiples destinatarios, y proporciona estimación de comisiones antes de la ejecución.
Interfaz de Withdraw de Blockradar

Requisitos previos

Antes de utilizar la API de Withdraw, asegúrese de contar con:
1

Clave API

Obtenga su clave API desde el Dashboard de Blockradar. Diríjase a Developers para generar una.
2

Billetera creada

Cree una billetera mediante la API Create Wallet o desde el dashboard. Necesitará el walletId para las operaciones de retiro.
3

ID de activo

Obtenga el assetId del token que desea retirar desde Assets en el dashboard o mediante la API Get Assets.
4

Saldo suficiente

Asegúrese de que su billetera tenga suficiente saldo del activo a retirar, además del token nativo (ETH, BNB, MATIC, etc.) para cubrir las comisiones de red.

Cómo funciona

La API de Withdraw envía activos stablecoin desde su billetera de Blockradar a cualquier dirección blockchain externa:

Retiro individual

Envíe activos a una dirección de destinatario con una sola llamada API.

Retiro por lotes

Envíe activos a múltiples destinatarios en una sola llamada API, reduciendo la sobrecarga y simplificando los pagos masivos.

Estimación de comisiones

Calcule las comisiones de red antes de la ejecución para garantizar saldo suficiente y mostrar los costos a los usuarios.

Modo Sign-Only

Firme transacciones sin transmitirlas para casos de uso avanzados como firma offline o envío personalizado.

Master Wallet vs Child Address

La API de Withdraw está disponible en dos niveles:

Master Wallet

Retire directamente desde su master wallet. Ideal para operaciones de tesorería y gestión centralizada de fondos.

Child Address

Retire desde child addresses individuales. Perfecto para operaciones específicas de usuario y gestión segregada de fondos.

Endpoints


Retiro individual

Envíe activos a una sola dirección de destinatario.

Parámetros de la solicitud

Los parámetros marcados con * son requeridos para retiros individuales pero no son necesarios si está utilizando el array assets para retiros por lotes.

Ejemplo de retiro individual

Respuesta del retiro individual


Retiros por lotes

Envíe activos a múltiples destinatarios en una sola llamada API. Los retiros por lotes se ejecutan secuencialmente, y cada retiro se procesa como una transacción blockchain independiente.

Cuándo usar retiros por lotes

  • Pagos masivos: Pague a múltiples empleados, proveedores o socios a la vez
  • Distribuciones: Envíe activos a múltiples direcciones
  • Transferencias multi-destinatario: Envíe diferentes montos a diferentes direcciones
  • Eficiencia operativa: Reduzca las llamadas API y simplifique la lógica de pagos

Parámetros de la solicitud por lotes

Para retiros por lotes, utilice el array assets en lugar de parámetros individuales: Cada elemento del array assets:

Ejemplo de retiro por lotes

Respuesta del retiro por lotes

Manejo de fallos parciales

Los retiros por lotes admiten éxito parcial. Si algunos retiros fallan, los demás se ejecutarán igualmente:

Reglas de retiro por lotes


Estimación de comisiones de red

Estime siempre las comisiones antes de ejecutar retiros para asegurar saldo suficiente del token nativo y mostrar costos precisos a los usuarios.

Estimación de comisión individual

Respuesta de comisión individual

Estimación de comisiones por lotes

Estime comisiones para múltiples retiros a la vez:

Respuesta de comisión por lotes

Campos de la respuesta de comisión


Modo Sign-Only

Firme transacciones sin transmitirlas a la blockchain. Útil para:
  • Firma offline: Prepare transacciones para envío posterior
  • Flujos multi-firma: Recolecte firmas antes del envío
  • Inspección de transacciones: Revise detalles de la transacción antes de transmitirla

Ejemplo de Sign-Only

Respuesta de Sign-Only


Retiros desde Child Address

Retire desde child addresses individuales en lugar de la master wallet:
Los retiros desde child address también admiten operaciones por lotes utilizando el array assets, siguiendo el mismo formato que los retiros por lotes desde master wallet.

Eventos de Webhook

Monitoree la finalización de los retiros mediante webhooks:

Payload del Webhook


Ejemplo de flujo completo

A continuación se muestra una implementación completa del flujo: estimación de comisión → confirmación del usuario → retiro:

Respuestas de error


Mejores prácticas

Seguridad

  • Valide direcciones: Verifique siempre las direcciones de los destinatarios antes de iniciar retiros
  • Use referencias: Rastree los retiros con IDs de referencia únicos para conciliación
  • Implemente webhooks: Escuche los eventos withdraw.success y withdraw.failed para confirmar el estado
  • Verifique AML: Blockradar detecta automáticamente las direcciones; revise cualquier transacción marcada

Gestión de comisiones

  • Estime antes de la ejecución: Llame siempre al endpoint network-fee antes de los retiros
  • Monitoree el saldo nativo: Asegure suficiente ETH/BNB/MATIC para las comisiones de gas
  • Use lotes para mayor eficiencia: Agrupe múltiples retiros para reducir las llamadas API y la sobrecarga operativa

Manejo de errores

  • Maneje fallos parciales: En retiros por lotes, revise tanto los arrays success como errors
  • Implemente reintentos: Use backoff exponencial para fallos transitorios
  • Registre todas las transacciones: Almacene IDs y hashes de transacciones para depuración y conciliación

Rendimiento

  • Use tamaños de lote adecuados: Lotes más grandes reducen las llamadas API pero aumentan el tiempo de cada solicitud
  • Almacene los IDs de activos en caché: Guarde los IDs de activos localmente para evitar consultas repetidas
  • Implemente limitación de tasa: Respete los límites de tasa de la API para evitar throttling

Referencia API

Endpoints de Master Wallet

Endpoints de Child Address


Soporte

La API de Withdraw proporciona una interfaz flexible para enviar activos stablecoin a direcciones externas. Comience con retiros individuales y estimación de comisiones, e incorpore operaciones por lotes para pagos masivos a medida que sus necesidades crezcan.