BINANCE SAPI · CAPITAL

API de Historial de Retiros

Consulta los registros de retiros de criptomonedas de una cuenta de Binance, con filtros opcionales por activo, estado, ID de orden personalizado y rango de fechas.

ENDPOINT

GET /sapi/v1/capital/withdraw/history

Autenticación SIGNED

Grupo API Capital

Método GET

Respuesta JSON

Descripción General

Este endpoint devuelve el registro histórico de retiros salientes de criptomonedas vinculados a una cuenta de Binance. Permite a los desarrolladores comprobar el estado de cada transacción, obtener los hashes de transacción en la blockchain (txId) y conciliar pagos automáticos.

Para agilizar el procesamiento de datos, las consultas pueden filtrarse por símbolo de criptomoneda, estado del retiro, ID de orden personalizado del cliente (withdrawOrderId) o intervalos de tiempo específicos en formato UTC.

Parámetros de la Solicitud

Parámetros aceptados por el endpoint.

Parámetro	Tipo	Requerido	Descripción
`coin`	STRING	Opcional	Símbolo de la criptomoneda para filtrar los registros, ej. BTC, ETH, USDT.
`withdrawOrderId`	STRING	Opcional	Filtra los registros según el ID de retiro personalizado asignado por el cliente.
`status`	INT	Opcional	Filtro por estado del retiro: `0` Correo Enviado (Email Sent), `1` Cancelado (Cancelled), `2` Esperando Aprobación (Awaiting Approval), `3` Rechazado (Rejected), `4` Procesando (Processing), `5` Fallido (Failure), `6` Completado (Completed).
`offset`	INT	Opcional	Cantidad de registros a omitir antes de devolver los resultados (paginación).
`limit`	INT	Opcional	Cantidad máxima de registros devueltos. El valor predeterminado es 1000 y el máximo es 1000.
`startTime`	LONG	Opcional	Marca de tiempo UTC de inicio en milisegundos.
`endTime`	LONG	Opcional	Marca de tiempo UTC de finalización en milisegundos.
`recvWindow`	LONG	Opcional	Ventana de validez en milisegundos para solicitudes firmadas.
`timestamp`	LONG	Requerido	Marca de tiempo UTC actual de la solicitud en milisegundos.

Seguimiento del Estado

El estado 6 indica que el retiro fue procesado y completado exitosamente. En operaciones en curso, consulta este endpoint periódicamente hasta que el estado pase de 4 (Procesando) a 6 (Completado) o 5 (Fallido).

Ejemplo de Solicitud

Ejemplo de solicitud utilizando cURL.

cURL BASH

curl -X GET \
'https://api.binance.com/sapi/v1/capital/withdraw/history?coin=USDT&status=6&timestamp=YOUR_TIMESTAMP&signature=YOUR_SIGNATURE' \
-H 'X-MBX-APIKEY: YOUR_API_KEY'

Mantén la privacidad de tus credenciales API

Nunca coloques tu clave secreta de API de Binance en código del lado del navegador, repositorios públicos o aplicaciones cliente donde pueda quedar expuesta.

Respuesta

Ejemplo de respuesta devuelta por la API.

RESPONSE 200 OK

[
    {
        "id": "b70287bf59e64e52bfcb6d860d5dd132",
        "amount": "10.00000000",
        "transactionFee": "1.00000000",
        "coin": "USDT",
        "status": 6,
        "address": "TXXXXXXXXXXXXXXX",
        "txId": "0x5c79219c63ed49429c67ef691a3c75127609212c4ef213a887b46d0a876a39d8",
        "applyTime": "2026-03-15 11:20:05",
        "network": "TRX",
        "transferType": 0,
        "withdrawOrderId": "WITHDRAW_1001",
        "info": "Success",
        "confirmNo": 1,
        "walletType": 0,
        "txKey": "",
        "completeTime": "2026-03-15 11:22:10"
    }
]

Campos de la Respuesta

Campo	Tipo	Descripción
`id`	STRING	ID de retiro interno generado por Binance.
`amount`	STRING	Cantidad de criptomonedas retiradas.
`transactionFee`	STRING	Comisión de red cobrada por procesar el retiro.
`coin`	STRING	Símbolo de la criptomoneda.
`status`	INT	Código numérico que indica el estado del retiro.
`address`	STRING	Dirección de destino en la blockchain.
`txId`	STRING	Hash o identificador de la transacción en la blockchain.
`applyTime`	STRING	Fecha y hora UTC de creación en formato `YYYY-MM-DD HH:MM:SS`.
`network`	STRING	Red blockchain utilizada para efectuar la transferencia.
`withdrawOrderId`	STRING	ID de retiro personalizado definido por el cliente (si se incluyó al solicitar el retiro).
`completeTime`	STRING	Fecha y hora UTC de finalización en formato `YYYY-MM-DD HH:MM:SS`.

Cómo Funciona

Flujo de trabajo para consultar el estado de un retiro.

01 Enviar Retiro Consigue el ID de retiro o ID de orden.

02 Firmar GET Incluye marca de tiempo y firma HMAC SHA256.

03 Obtener Registros Consulta el endpoint con filtros opcionales.

04 Guardar TxID Guarda el hash de la blockchain al completarse.

✓

Consejo práctico

Guarda en tu base de datos el txId devuelto una vez que el retiro alcance el estado 6 (Completado). De esta manera, tu aplicación podrá ofrecer enlaces directos al explorador de bloques a tus usuarios finales.

Casos de Uso Comunes

Verificación de Pagos

Confirma si los pagos salientes automatizados fueron procesados correctamente por Binance.

Auditoría y Contabilidad

Sincroniza periódicamente los registros de retiro con tu software contable o libro mayor interno.

Extracción de TxID

Obtén el hash de transacción en la blockchain para dar seguimiento a las confirmaciones en la red externa.