Binance API / SAPI / Capital
BINANCE SAPI · CAPITAL

Deposit History API

Retrieve cryptocurrency deposit history for a Binance account, with optional filters for asset, status and time range.

ENDPOINT
GET /sapi/v1/capital/deposit/hisrec
Authentication SIGNED
API Group Capital
Method GET
Response JSON

Overview

This endpoint returns cryptocurrency deposit records associated with a Binance account. It can be used to monitor incoming blockchain deposits and reconcile them with internal application records.

The request can optionally be filtered by cryptocurrency, deposit status and a specific time range. This makes the endpoint useful for applications that need to periodically synchronize deposit activity.

01

Request Parameters

Parameters accepted by the endpoint.

ParameterTypeRequiredDescription
coinSTRINGOptionalCryptocurrency symbol used to filter deposit records, such as BTC, ETH or USDT.
statusINTOptionalDeposit status filter: 0 pending, 6 credited but cannot withdraw, 1 success.
startTimeLONGOptionalStart of the requested time range as a UTC timestamp in milliseconds.
endTimeLONGOptionalEnd of the requested time range as a UTC timestamp in milliseconds.
offsetINTOptionalNumber of records to skip before returning results.
limitINTOptionalMaximum number of records returned. Default is 1000 and the maximum is 1000.
recvWindowLONGOptionalDefines the period during which the signed request remains valid.
timestampLONGRequiredCurrent request timestamp in milliseconds.
i

Time range matters

When using startTime and endTime, make sure the requested interval complies with Binance API time-range limitations. For historical synchronization, applications should process deposits in manageable time windows.

02

Request Example

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

Keep API credentials private

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

03

Response

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

Response Fields

FieldTypeDescription
amountSTRINGAmount of cryptocurrency deposited into the Binance account.
coinSTRINGCryptocurrency symbol associated with the deposit.
networkSTRINGBlockchain network used for the deposit.
statusINTCurrent status of the deposit.
addressSTRINGBinance deposit address associated with the transaction.
addressTagSTRINGAdditional destination identifier when required by the selected asset or network.
txIdSTRINGBlockchain transaction identifier associated with the deposit.
insertTimeLONGTime when the deposit record was detected, represented as a timestamp in milliseconds.
transferTypeINTIndicates the type of transfer associated with the deposit record.
confirmTimesSTRINGBlockchain confirmation progress for the deposit.

04

How It Works

Typical flow for retrieving Binance deposit history.

01 Set Filters Select an asset or time range when required.
 
02 Sign Request Authenticate the USER_DATA request.
 
03 Query History Send the request to Binance.
 
04 Process Records Read deposit status and transaction details.
✓

Practical tip

For automated deposit monitoring, store the transaction ID and deposit status in your application database. This makes it possible to detect new deposits and track confirmation progress without repeatedly processing the same records.

Common Use Cases

Deposit Monitoring

Monitor incoming cryptocurrency deposits and their confirmation status.

Transaction Reconciliation

Match Binance deposit records with transactions stored in an external application or accounting system.

Deposit Automation

Automatically detect new deposits and trigger application workflows after confirmation.

⚡

Looking for Integration & API Docs?

Explore our official technical reference for Binance SAPI endpoints, including C2C ads management, deposit/withdrawal logs, automated payout webhooks, and REST API examples.

Explore Binance API Documentation→
💬
Telegram WhatsApp