---
title: "Withdraw History (supporting network) (USER_DATA)"
method: GET
path: "/sapi/v1/capital/withdraw/history"
tags: ["Wallet"]
---

# Withdraw History (supporting network) (USER_DATA)

`GET /sapi/v1/capital/withdraw/history`

## Request

- Base URL: `https://api.binance.com`
- URL: `https://api.binance.com/sapi/v1/capital/withdraw/history`
- Auth: API key in header `X-MBX-APIKEY`

Fetch withdraw history.

This endpoint specifically uses per second UID rate limit, user's total second level IP rate limit is 180000/second. Response from the endpoint contains header key X-SAPI-USED-UID-WEIGHT-1S, which defines weight used by the current IP.

- `network` may not be in the response for old withdraw.
- Please notice the default `startTime` and `endTime` to make sure that time interval is within 0-90 days.
- If both `startTime` and `endTime` are sent, time between `startTime` and `endTime` must be less than 90 days
- If withdrawOrderId is sent, time between startTime and endTime must be less than 7 days.
- If withdrawOrderId is sent, startTime and endTime are not sent, will return last 7 days records by default.

Weight(UID): 18000
Request Limit: 10 requests per second

## Query parameters

- `coin` string
- `withdrawOrderId` string
- `status` integer
- `startTime` integer
- `endTime` integer
- `offset` integer
- `limit` integer
- `recvWindow` integer
- `timestamp` integer, required
- `signature` string, required

## Response `200`

List of withdraw history

- object[]
  - `address` string, required
  - `amount` string, required
  - `applyTime` string, required
  - `coin` string, required
  - `id` string, required
  - `withdrawOrderId` string, required: will not be returned if there's no withdrawOrderId for this withdraw.
  - `network` string, required
  - `transferType` integer, required: 1 for internal transfer, 0 for external transfer
  - `status` integer, required
  - `transactionFee` string, required
  - `confirmNo` integer
  - `info` string: Reason for withdrawal failure
  - `txId` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized Request

## Changes

- **2023-09-19** `558ab69ec555`: 7 breaking, 2 warning
  - removed the enum value `0.00` from the `query` request parameter `status`
  - removed the enum value `1.00` from the `query` request parameter `status`
  - removed the enum value `2.00` from the `query` request parameter `status`
  - removed the enum value `3.00` from the `query` request parameter `status`
  - …5 more
- **2022-04-25** `f008d48ec623`: 2 breaking
  - the response property `items/confirmNo` became optional for the status `200`
  - the response property `items/info` became optional for the status `200`
- **2022-03-04** `f1d8926e955a`: 1 info
  - the `query` request parameter `coin` became optional
- **2021-11-24** `acf5d0d45f19`: 1 info
  - added the required property `items/info` to the response with the `200` status
- **2021-10-25** `a484ce871a72`: 7 breaking, 16 info
  - for the `query` request parameter `endTime`, the format changed from no format to `int64`
  - for the `query` request parameter `limit`, the format changed from no format to `int32`
  - for the `query` request parameter `offset`, the format changed from no format to `int32`
  - for the `query` request parameter `recvWindow`, the format changed from no format to `int64`
  - …19 more

[Operation history](https://skmtc.dev/binance/apis/binance-public-spot-api/changes/sapi/v1/capital/withdraw/history/get.md)

---

[API](https://skmtc.dev/binance/apis/binance-public-spot-api.md) - [All operations](https://skmtc.dev/binance/apis/binance-public-spot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/binance/apis/binance-public-spot-api/revisions/0dd2f133e12d?raw)