BINANCE SAPI · ACCOUNT

API de Instantánea de Cuenta

Consulta instantáneas diarias de balances para billeteras Spot, Margin o Futures a lo largo de un período histórico determinado.

ENDPOINT

GET /sapi/v1/accountSnapshot

Autenticación USER_DATA / SIGNED

Grupo API Account

Método GET

Respuesta JSON

Descripción General

Este endpoint consulta las instantáneas (snapshots) diarias de balance generadas automáticamente por Binance. Permite obtener un desglose detallado de activos para cuentas SPOT, MARGIN y FUTURES.

Gestores de portafolio, herramientas contables y sistemas de auditoría automatizados recurren a este endpoint para seguir la valuación total de activos, balances por criptomoneda y el rendimiento histórico de la cuenta sin necesidad de almacenar registros diarios manualmente.

Parámetros de la Solicitud

Parámetros aceptados por el endpoint.

Parámetro	Tipo	Requerido	Descripción
`type`	STRING	Requerido	Tipo de billetera o cuenta: `SPOT`, `MARGIN` o `FUTURES`.
`startTime`	LONG	Opcional	Marca de tiempo UTC de inicio en milisegundos.
`endTime`	LONG	Opcional	Marca de tiempo UTC de finalización en milisegundos.
`limit`	INT	Opcional	Cantidad de registros de instantáneas a devolver. Por defecto es `7`, mínimo `5` y máximo `30`.
`recvWindow`	LONG	Opcional	Ventana de tiempo de validez en milisegundos para solicitudes firmadas.
`timestamp`	LONG	Requerido	Marca de tiempo UTC actual de la solicitud en milisegundos.

Generación diaria de instantáneas

Binance genera automáticamente la instantánea del balance una vez al día, aproximadamente a las 23:59:59 UTC. Los registros históricos se conservan por hasta 30 días.

Ejemplo de Solicitud

Ejemplo de solicitud utilizando cURL.

cURL BASH

curl -X GET \
'https://api.binance.com/sapi/v1/accountSnapshot?type=SPOT&limit=7&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

{
    "code": 200,
    "msg": "",
    "snapshotVos": [
        {
            "data": {
                "balances": [
                    {
                        "asset": "BTC",
                        "free": "0.09905000",
                        "locked": "0.00000000"
                    },
                    {
                        "asset": "USDT",
                        "free": "1500.00000000",
                        "locked": "0.00000000"
                    }
                ],
                "totalAssetOfBtc": "0.12500000"
            },
            "type": "spot",
            "updateTime": 1638316799000
        }
    ]
}

Campos de la Respuesta

Campo	Tipo	Descripción
`code`	INT	Código de estado de la respuesta (`200` indica éxito).
`snapshotVos`	ARRAY	Arreglo con los registros de instantáneas diarias de balance.
`snapshotVos[].type`	STRING	Categoría de la instantánea: `spot`, `margin` o `futures`.
`snapshotVos[].updateTime`	LONG	Marca de tiempo UTC de la instantánea diaria en milisegundos.
`snapshotVos[].data.totalAssetOfBtc`	STRING	Valuación total de la cuenta convertida a su valor equivalente en Bitcoin (BTC).
`snapshotVos[].data.balances`	ARRAY	Lista detallada de los balances de cada criptomoneda (montos libres y bloqueados).

Cómo Funciona

Flujo de trabajo para consultar instantáneas diarias de balances.

01 Elegir Billetera Selecciona SPOT, MARGIN o FUTURES.

02 Definir Rango Indica fechas o límite de días (máximo 30).

03 Firmar Solicitud Autentica la petición USER_DATA con tu firma API.

04 Auditar Balances Procesa el valor total en BTC y cada activo.

Casos de Uso Comunes

Seguimiento de Portafolio

Analiza la evolución del valor neto de la cuenta a lo largo del tiempo para generar gráficos de rendimiento patrimonial.

Auditorías Contables y Fiscales

Sincroniza balances de cierre diario con reportes financieros externos y plataformas de cálculo tributario cripto.

Gestión de Riesgo

Comprueba valoraciones históricas de colateral y margen en cuentas Spot, Margin y Futures de forma unificada.