> For the complete documentation index, see [llms.txt](https://ajaib.gitbook.io/ajaib-exchange-open-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajaib.gitbook.io/ajaib-exchange-open-api/api-references/capital/withdraw-history.md).

# Withdraw History

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

**Functionality:** Track fund movement and withdrawal status.

**Authentication:** Required

#### URL Parameters

| Name            | Type   | Mandatory                                                                    | Description                                                                                                                                                         |
| --------------- | ------ | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| coin            | string | <ul class="contains-task-list"><li><input type="checkbox"></li></ul>         | The cryptocurrency symbol (e.g., "BTC", "ETH").                                                                                                                     |
| withdrawOrderId | string | <ul class="contains-task-list"><li><input type="checkbox"></li></ul>         | Client's reference ID (if provided in the POST request).                                                                                                            |
| status          | string | <ul class="contains-task-list"><li><input type="checkbox"></li></ul>         | Withdrawal status: `FAILED`, `IN_PROGRESS`, `SUCCESS`.                                                                                                              |
| startTime       | long   | <ul class="contains-task-list"><li><input type="checkbox"></li></ul>         | Start timestamp (milliseconds). (Default: 90 days from current timestamp)                                                                                           |
| endTime         | long   | <ul class="contains-task-list"><li><input type="checkbox"></li></ul>         | End timestamp (milliseconds). (Default: current timestamp)                                                                                                          |
| recvWindow      | long   | <ul class="contains-task-list"><li><input type="checkbox"></li></ul>         | Number of milliseconds after timestamp the request is valid for. Refer to [this](https://ajaib.gitbook.io/ajaib-exchange-open-api/getting-started/timing-security). |
| timestamp       | long   | <ul class="contains-task-list"><li><input type="checkbox" checked></li></ul> | Timestamp when client sends the request.                                                                                                                            |

#### Response Body

| Name            | Type   | Description                                                                 |
| --------------- | ------ | --------------------------------------------------------------------------- |
| id              | string | Unique withdrawal ID.                                                       |
| withdrawOrderId | string | Client's reference ID (if provided in the POST request).                    |
| amount          | string | Amount withdrawn.                                                           |
| transactionFee  | string | Fee charged for the withdrawal.                                             |
| coin            | string | The cryptocurrency symbol (e.g., "BTC", "ETH").                             |
| network         | string | The blockchain network used for the transaction (e.g., "TRX").              |
| status          | string | Withdrawal status: `FAILED`, `IN_PROGRESS`, `SUCCESS`.                      |
| address         | string | The withdrawal recipient address.                                           |
| addressTag      | string | Extra information required for certain coins (e.g., memo, destination tag). |
| txId            | string | Transaction hash on the blockchain.                                         |
| txExplorer      | string | Transaction hash explorer url.                                              |
| applyTime       | long   | Time the withdrawal was initiated (timestamp in milliseconds).              |
| completeTime    | long   | Time the withdrawal was completed (timestamp in milliseconds).              |

{% tabs %}
{% tab title="200 OK" %}

```json
[
  {
    "id": "6ade16ad-cb43-403a-9933-44ed8fcf5105",
    "withdrawOrderId": "4b13cdb1-b799-4f2c-871d-2964a7cbfa3b",
    "amount": "0.01",
    "transactionFee": "0.0005",
    "coin": "BTC",
    "network": "BTC",
    "status": "SUCCESS",
    "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
    "txId": "b6bea17f39b34b528656c3776a3a393c8866323b2c870bd4138a075db1e06bbd",
    "txExplorer": "https://btcscan.org/tx/af9e9aec6f952c6c9b53caaeba95dff524278cba9ec4fc1f6fc2f46ddb461f9ad",
    "applyTime": 1661492146000,
    "completeTime": 1661493146000
  }
]
```

{% endtab %}

{% tab title="401 Unauthorized" %}

```json
{
  "code": -1002,
  "msg": "Unauthorized"
}
```

{% endtab %}
{% endtabs %}