binance_get_withdraw_history
Retrieve crypto withdrawal history within a 90-day window, filterable by coin, status, or withdrawal ID, with network fees and completion times for reconciling outgoing transfers.
Instructions
List crypto withdrawals out of the account for one window (up to 90 days).
Calls GET /sapi/v1/capital/withdraw/history (SIGNED). This is a read — this
server can never submit a withdrawal: POST /sapi/v1/capital/withdraw/apply is on
the client's forbidden-path list and no tool exists for it.
⚠️ Cost: UID weight 18000 per call (a tenth of the 180000/min per-account
budget) and a hard limit of 10 requests per second on this endpoint — Binance
reports the per-second usage in X-SAPI-USED-UID-WEIGHT-1S. Do not poll it.
Each row includes transactionFee, the network fee Binance charged for that
withdrawal, so the true cost of moving funds out is readable here.
When to Use:
"Did my withdrawal go through, and what did it cost?" — a recent, bounded lookup.
Looking up specific withdrawals by
withdraw_order_idorid_list.
When NOT to Use:
For the full history since the account opened — use
binance_get_all_withdrawals, which budgets these expensive calls for you.For deposits — use
binance_get_deposit_history.To MAKE a withdrawal — impossible by design; use the Binance app.
Returns:
A markdown table (applyTime, completeTime, coin, amount, transactionFee, network,
status, walletType, txId, withdrawOrderId) plus per-coin totals including fees,
capped at 50 displayed rows; or the raw Binance array with
response_format="json".
Pagination:
limit is 1-1000 (Binance default 1000) and offset pages within the window.
id_list accepts at most 45 ids and is sent comma-separated.
Windows:
start_time/end_time together must span under 90 days — under 7 days when
withdraw_order_id is set (Binance's own rule; it also defaults to the last 7
days in that case). Both caps are enforced locally.
Examples: params = {"coin": "BTC", "status": "completed"} params = {"start_time": "2026-08-01", "end_time": "2026-09-01"} params = {"id_list": ["b6ae22b3aa844210a7041aee7589627c"], "response_format": "json"}
Error Handling: An over-wide window is rejected locally. -2015 means the key lacks Reading permission or this IP is not allowlisted. A 429 here means the 10 req/s ceiling was hit — back off, do not retry in a loop.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |