Binance API / SAPI / Capital
BINANCE SAPI · CAPITAL

Withdrawal History API

Retrieve cryptocurrency withdrawal records for a Binance account, with optional filters for asset, status, custom order ID, and time range.

ENDPOINT
GET /sapi/v1/capital/withdraw/history
Authentication SIGNED
API Group Capital
Method GET
Response JSON

Overview

This endpoint returns historical outgoing cryptocurrency withdrawal records associated with a Binance account. It allows developers to verify transaction statuses, retrieve blockchain transaction hashes (txId), and reconcile payout activities.

To optimize data processing, queries can be filtered by cryptocurrency symbol, withdrawal status, custom client order ID (withdrawOrderId), or specific UTC time intervals.

01

Request Parameters

Parameters accepted by the endpoint.

ParameterTypeRequiredDescription
coinSTRINGOptionalCryptocurrency symbol to filter records, e.g. BTC, ETH, USDT.
withdrawOrderIdSTRINGOptionalFilter records by client-side custom withdrawal ID.
statusINTOptionalWithdrawal status filter: 0 Email Sent, 1 Cancelled, 2 Awaiting Approval, 3 Rejected, 4 Processing, 5 Failure, 6 Completed.
offsetINTOptionalNumber of records to skip before returning results.
limitINTOptionalMaximum number of records returned. Default is 1000, maximum is 1000.
startTimeLONGOptionalStart UTC timestamp in milliseconds.
endTimeLONGOptionalEnd UTC timestamp in milliseconds.
recvWindowLONGOptionalValid window time in milliseconds for signed requests.
timestampLONGRequiredCurrent request UTC timestamp in milliseconds.
i

Status Tracking

Status 6 indicates a fully processed and completed withdrawal. For ongoing transactions, poll this endpoint until status transitions from 4 (Processing) to 6 (Completed) or 5 (Failure).

02

Request Example

Example request using cURL.

cURL BASH
curl -X GET \
'https://api.binance.com/sapi/v1/capital/withdraw/history?coin=USDT&status=6×tamp=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
[
    {
        "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"
    }
]

Response Fields

FieldTypeDescription
idSTRINGBinance internal withdrawal ID.
amountSTRINGAmount of cryptocurrency withdrawn.
transactionFeeSTRINGNetwork transaction fee charged for the withdrawal.
coinSTRINGCryptocurrency symbol.
statusINTStatus code of the withdrawal.
addressSTRINGDestination blockchain address.
txIdSTRINGBlockchain transaction hash/identifier.
applyTimeSTRINGUTC creation time formatted as YYYY-MM-DD HH:MM:SS.
networkSTRINGBlockchain network used for the transfer.
withdrawOrderIdSTRINGCustom client withdrawal ID if provided during submission.
completeTimeSTRINGCompletion UTC timestamp formatted as YYYY-MM-DD HH:MM:SS.

04

How It Works

Typical workflow for querying withdrawal status.

01 Submit Withdrawal Obtain withdrawal ID or order ID.
 
02 Sign GET Request Include timestamp and HMAC SHA256 signature.
 
03 Fetch Records Query API endpoint with optional filters.
 
04 Extract TxID Save blockchain transaction hash upon completion.
✓

Practical tip

Store the returned txId in your database once the withdrawal reaches status 6 (Completed). This allows your application to provide direct block explorer links to end users.

Common Use Cases

Payout Verification

Verify whether outgoing automated payouts were successfully processed by Binance.

Audit & Accounting

Periodically sync withdrawal records with accounting software or transaction ledgers.

TxID Extraction

Retrieve blockchain transaction hashes to monitor external network confirmations.

⚡

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