BINANCE SAPI · CAPITAL

API de Historial de Depósitos

Consulta el historial de depósitos de criptomonedas de una cuenta de Binance, con filtros opcionales por activo, estado y rango de fechas.

ENDPOINT

GET /sapi/v1/capital/deposit/hisrec

Autenticación SIGNED

Grupo API Capital

Método GET

Respuesta JSON

Descripción General

Este endpoint devuelve los registros de depósitos de criptomonedas asociados a una cuenta de Binance. Es fundamental para monitorear depósitos entrantes en la blockchain y conciliarlos con los registros internos de tu aplicación o base de datos.

Puedes filtrar la solicitud de manera opcional por criptomoneda, estado del depósito y un rango de tiempo específico. Esto hace que el endpoint sea ideal para aplicaciones y servicios que necesitan sincronizar periódicamente la actividad de depósitos.

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 utilizado para filtrar los registros de depósito, como BTC, ETH o USDT.
`status`	INT	Opcional	Filtro por estado del depósito: `0` pendiente (pending), `6` acreditado pero no disponible para retiro (credited but cannot withdraw), `1` exitoso (success).
`startTime`	LONG	Opcional	Inicio del rango de tiempo solicitado como marca de tiempo UTC en milisegundos.
`endTime`	LONG	Opcional	Fin del rango de tiempo solicitado como marca de tiempo UTC en milisegundos.
`offset`	INT	Opcional	Cantidad de registros a omitir antes de comenzar a devolver resultados (paginación).
`limit`	INT	Opcional	Cantidad máxima de registros devueltos. El valor predeterminado es 1000 y el máximo permitido es 1000.
`recvWindow`	LONG	Opcional	Define el período durante el cual la solicitud firmada sigue siendo válida.
`timestamp`	LONG	Requerido	Marca de tiempo actual de la solicitud en milisegundos.

El rango de tiempo es importante

Al utilizar startTime y endTime, asegúrate de que el intervalo solicitado cumpla con los límites de tiempo establecidos por la API de Binance. Para procesos de sincronización histórica, es recomendable procesar los depósitos en ventanas de tiempo moderadas y controladas.

Ejemplo de Solicitud

Ejemplo de solicitud utilizando cURL.

cURL BASH

curl -X GET \
'https://api.binance.com/sapi/v1/capital/deposit/hisrec?coin=USDT&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

[
    {
        "amount": "8.73234",
        "coin": "BNB",
        "network": "BSC",
        "status": 1,
        "address": "0xd709f9d0bbc6b0e746a13142dfe353086edf87c2",
        "addressTag": "",
        "txId": "0xa9ebf3f4f60bc18bd6bdf4616ff8ffa14ef93a08fe79cad40519b31ea1044290",
        "insertTime": 1638342348000,
        "transferType": 0,
        "confirmTimes": "0/0"
    }
]

Campos de la Respuesta

Campo	Tipo	Descripción
`amount`	STRING	Cantidad de criptomoneda depositada en la cuenta de Binance.
`coin`	STRING	Símbolo de la criptomoneda correspondiente al depósito.
`network`	STRING	Red blockchain utilizada para efectuar el depósito.
`status`	INT	Estado actual del depósito.
`address`	STRING	Dirección de depósito de Binance asociada a la transacción.
`addressTag`	STRING	Identificador de destino adicional cuando lo requiere el activo o la red seleccionada.
`txId`	STRING	Hash o identificador de la transacción en la blockchain correspondiente al depósito.
`insertTime`	LONG	Marca de tiempo en milisegundos en la que se detectó y registró el depósito en el sistema.
`transferType`	INT	Indica el tipo de transferencia asociada al registro de depósito.
`confirmTimes`	STRING	Progreso de confirmaciones en la blockchain para el depósito.

Cómo Funciona

Flujo típico para consultar el historial de depósitos en Binance.

01 Definir Filtros Selecciona un activo o rango de fechas si es necesario.

02 Firmar Solicitud Autentica la petición tipo USER_DATA.

03 Consultar Historial Envía la solicitud a Binance.

04 Procesar Registros Lee el estado del depósito y los detalles de la transacción.

✓

Consejo práctico

Para la supervisión automatizada de depósitos, almacena el ID de transacción (txId) y el estado del depósito en la base de datos de tu aplicación. De esta forma podrás detectar depósitos nuevos y seguir el progreso de confirmaciones sin procesar repetidamente los mismos registros.

Casos de Uso Comunes

Monitoreo de Depósitos

Supervisa depósitos entrantes de criptomonedas y su progreso de confirmación en la red.

Conciliación de Transacciones

Cruza los registros de depósito de Binance con las transacciones registradas en tu sistema contable o backend externo.

Automatización de Acreditaciones

Detecta automáticamente depósitos nuevos y activa flujos de trabajo en tu aplicación una vez alcanzado el estado de confirmación.