> 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/deposit-history.md).

# Deposit History

`GET` `/v1/capital/deposit/history`

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

**Authentication:** Required

#### URL Parameters

| Parameter  | Type   | Mandatory                                                                    | Description                                                                                                                                                         |
| ---------- | ------ | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| coin       | string | <ul class="contains-task-list"><li><input type="checkbox"></li></ul>         | The cryptocurrency symbol (e.g., "BTC", "ETH").                                                                                                                     |
| status     | string | <ul class="contains-task-list"><li><input type="checkbox"></li></ul>         | Deposit 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)                                                                                                          |
| txId       | string | <ul class="contains-task-list"><li><input type="checkbox"></li></ul>         | Transaction hash on the blockchain.                                                                                                                                 |
| 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 identifier for the deposit.                                          |
| amount       | string | Amount deposited.                                                           |
| coin         | string | The cryptocurrency symbol (e.g., "BTC", "ETH").                             |
| network      | string | The blockchain network used (e.g., "BTC", "ETH").                           |
| status       | string | Deposit status: `FAILED`, `IN_PROGRESS`, `SUCCESS`                          |
| address      | string | Deposit 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.                                              |
| insertTime   | long   | Time the deposit was initiated (timestamp in milliseconds).                 |
| completeTime | long   | Time the deposit was completed (timestamp in milliseconds).                 |

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

```json
[
  {
    "id": "717e774f-2531-4b4f-9f37-f99d8c2f2451",
    "amount": "0.001",
    "coin": "BNB",
    "network": "BNB",
    "status": "SUCCESS",
    "address": "bnb136ns6lfw4zs5hg4n85vdthaad7hq5m4gtkgf23",
    "addressTag": "101764890",
    "txId": "98A3EA560C6B3336D348B6C83F0F95ECE4F1F5919E94BD006E5BF3BF264FACFC",
    "txExplorer": "https://btcscan.org/tx/af9e9aec6f952c6c9b53caaeba95dff524278cba9ec4fc1f6fc2f46ddb461f9ad",
    "insertTime": 1661493146000,
    "completeTime": 1661493146000
  }
]
```

{% endtab %}

{% tab title="401 Unauthorized" %}

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

{% endtab %}
{% endtabs %}
