BINANCE SAPI · ACCOUNT

Account Snapshot API

Retrieve daily account balance snapshots for Spot, Margin, or Futures wallets over a specified historical time range.

ENDPOINT

GET /sapi/v1/accountSnapshot

Authentication USER_DATA / SIGNED

API Group Account

Method GET

Response JSON

Overview

This endpoint queries historical daily balance snapshots generated by Binance. It supports retrieving detailed asset breakdowns for SPOT, MARGIN, and FUTURES account types.

Portfolio managers, accounting software, and automated audit tools use this endpoint to track total asset valuations, individual coin balances, and historical portfolio growth without maintaining manual daily database logs.

Request Parameters

Parameters accepted by the endpoint.

Parameter	Type	Required	Description
`type`	STRING	Required	Account wallet type: `SPOT`, `MARGIN`, or `FUTURES`.
`startTime`	LONG	Optional	Start UTC timestamp in milliseconds.
`endTime`	LONG	Optional	End UTC timestamp in milliseconds.
`limit`	INT	Optional	Number of snapshot records to return. Default is `7`, minimum is `5`, maximum is `30`.
`recvWindow`	LONG	Optional	Time window in milliseconds for signed request validity.
`timestamp`	LONG	Required	Current request UTC timestamp in milliseconds.

Daily Snapshot Timing

Binance automatically generates account balance snapshots once per day at approximately 23:59:59 UTC. Historical records are preserved for up to 30 days.

Request Example

Example request using 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'

Keep API credentials private

Never place your Binance API secret in browser-side code, public repositories or client applications where it can be exposed.

Response

Example response returned by the 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
        }
    ]
}

Response Fields

Field	Type	Description
`code`	INT	Response status code (`200` indicates success).
`snapshotVos`	ARRAY	Array of daily balance snapshot records.
`snapshotVos[].type`	STRING	Snapshot category: `spot`, `margin`, or `futures`.
`snapshotVos[].updateTime`	LONG	UTC timestamp of the daily snapshot in milliseconds.
`snapshotVos[].data.totalAssetOfBtc`	STRING	Total account valuation converted to Bitcoin (BTC) equivalent.
`snapshotVos[].data.balances`	ARRAY	Detailed list of individual asset balances (free and locked amounts).

How It Works

Workflow for querying daily balance snapshots.

01 Select Wallet Type Choose SPOT, MARGIN, or FUTURES.

02 Set Time Limit Specify date range or record limit (max 30).

03 Sign Request Authenticate USER_DATA request with API signature.

04 Audit Balances Process total BTC value and individual coin balances.

Common Use Cases

Portfolio Tracking

Track daily changes in net account asset value over time to build portfolio performance charts.

Tax & Accounting Audits

Sync end-of-day balances with external financial reporting and automated crypto tax systems.

Risk Management

Verify historical collateral valuations across Spot, Margin, and Futures accounts.

Next Endpoint → Trade Fee API

Related Binance API Endpoints

📚

Part of the Spot Arbitrage Guide

This article is part of our complete learning guide covering professional cross-exchange cryptocurrency arbitrage.

Explore the Spot Arbitrage Guide →

📚

Part of the Binance P2P Automation Guide

This article is part of our complete learning guide covering Binance P2P automation, merchant tools, and automated trading.

Explore the Binance P2P Automation Guide →

Novelty