BINANCE SAPI · CAPITAL

API de Retiro de Criptomonedas

Envía una solicitud para retirar criptomonedas desde una cuenta de Binance hacia una dirección externa en la blockchain o hacia una billetera interna de Binance.

ENDPOINT

POST /sapi/v1/capital/withdraw/apply

Autenticación SIGNED

Grupo API Capital

Método POST

Respuesta JSON

Descripción General

Este endpoint procesa solicitudes de retiro de criptomonedas salientes. Admite selección de red blockchain, identificadores personalizados de retiro por parte del cliente, gestión de Memo/Tag para redes específicas y la elección entre fondos de la billetera Spot o de Fondos (Funding Wallet).

Para ejecutar este endpoint con éxito, es obligatorio contar con una firma criptográfica válida y tener habilitado el permiso correspondiente (Enable Withdrawals) en los ajustes de tu API key.

Parámetros de la Solicitud

Parámetros aceptados por el endpoint.

Parámetro	Tipo	Requerido	Descripción
`coin`	STRING	Requerido	Símbolo de la criptomoneda a retirar, por ejemplo BTC, ETH, USDT.
`withdrawOrderId`	STRING	Opcional	Identificador personalizado definido por el cliente para el seguimiento interno del retiro.
`network`	STRING	Opcional	Red blockchain utilizada para el retiro. Si se omite, se usará la red predeterminada.
`address`	STRING	Requerido	Dirección de la billetera de destino en la blockchain.
`addressTag`	STRING	Opcional	Identificador secundario de destino (Memo/Tag) para monedas como XRP, XLM o BNB.
`amount`	NUMBER	Requerido	Monto de criptomonedas a retirar.
`transactionFeeFlag`	BOOLEAN	Opcional	Cuando es `true`, la comisión de red se deduce del monto a enviar. Por defecto es `false`.
`walletType`	INT	Opcional	Origen de los fondos: `0` Billetera Spot, `1` Billetera de Fondos (Funding). Por defecto es `0`.
`recvWindow`	LONG	Opcional	Ventana de tiempo válida en milisegundos para solicitudes firmadas.
`timestamp`	LONG	Requerido	Marca de tiempo UTC actual de la solicitud en milisegundos.

Habilitar permisos de retiro en la API

Para utilizar este endpoint, tu clave API de Binance debe tener activada explícitamente la opción Enable Withdrawals dentro de la configuración de restricciones de acceso por IP.

Ejemplo de Solicitud

Ejemplo de solicitud POST utilizando cURL.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/capital/withdraw/apply' \
-H 'X-MBX-APIKEY: YOUR_API_KEY' \
-d 'coin=USDT&network=TRX&address=TXXXXXXXXXXXXXXX&amount=100&timestamp=YOUR_TIMESTAMP&signature=YOUR_SIGNATURE'

Respuesta

Ejemplo de respuesta devuelta tras una solicitud exitosa.

RESPONSE 200 OK

{
    "id": "721384200820719104"
}

Campos de la Respuesta

Campo	Tipo	Descripción
`id`	STRING	Identificador único de la transacción de retiro generado por Binance.

Cómo Funciona

Flujo de trabajo para enviar un retiro a través de la API de Binance.

01 Verificar Destino Valida la dirección y compatibilidad de red.

02 Preparar Payload Define moneda, monto y Memo/Tag si aplica.

03 Firmar POST Envía la firma HMAC SHA256 y API key.

04 Rastrear Estado Monitorea con el ID devuelto vía History API.

Casos de Uso Comunes

Pagos Automatizados

Ejecuta retiros programados del sistema o liquidaciones automáticas directo desde la lógica de tu servidor.

Rebalanceo de Billeteras

Mueve fondos automáticamente entre cuentas del exchange y billeteras de liquidez externas.

Transferencias Internas

Envía fondos de forma transparente a través de las redes admitidas con identificadores personalizados de tu sistema.