> 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/register-withdraw-whitelisted-address-v2.md).

# Register Withdraw Whitelisted Address v2

`POST` `/v2/capital/withdraw/address`

**Functionality:** Insert whitelisted addresses for withdrawal. To be used for withdrawal, an address must satisfy 2 conditions: APPROVED and pass the coolOffPeriod.

**Authentication:** Required

#### Request Body

<table><thead><tr><th>Parameter</th><th width="128.87109375">Type</th><th>Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>network</td><td>string</td><td><ul class="contains-task-list"><li><input type="checkbox" checked></li></ul></td><td>The blockchain network used for the transaction (e.g., "XRP_BSC").<br>Refer to <a data-mention href="/ajaib-exchange-open-api/api-references/capital/all-coins-information.md">All Coins Information</a>.</td></tr><tr><td>address</td><td>string</td><td><ul class="contains-task-list"><li><input type="checkbox" checked></li></ul></td><td>The withdrawal address for the specified network.</td></tr><tr><td>addressTag</td><td>string</td><td><ul class="contains-task-list"><li><input type="checkbox" checked></li></ul></td><td><p>Extra information required for certain networks (e.g., memo, destination tag).<br><br><strong>Note</strong> </p><p>Refer to network's <code>sameAddress</code> in <a data-mention href="/ajaib-exchange-open-api/api-references/capital/all-coins-information.md">All Coins Information</a>.</p><ul><li>if <code>sameAddress</code> is <code>true</code>, then <code>addressTag</code> is mandatory</li><li>if <code>sameAddress</code> is <code>false</code>, then <code>addressTag</code> must be NULL (must not send empty string)</li></ul></td></tr><tr><td>recvWindow</td><td>long</td><td><ul class="contains-task-list"><li><input type="checkbox"></li></ul></td><td>Number of milliseconds after timestamp the request is valid for. Refer to <a data-mention href="/ajaib-exchange-open-api/getting-started/timing-security.md">Timing Security</a>.</td></tr><tr><td>timestamp</td><td>long</td><td><ul class="contains-task-list"><li><input type="checkbox" checked></li></ul></td><td>Timestamp when client sends the request.</td></tr></tbody></table>

#### Response Body

| Name          | Type   | Description                                                                                                                                                                          |
| ------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| coin          | string | The cryptocurrency symbol (e.g., "BTC", "ETH").                                                                                                                                      |
| network       | string | The blockchain network name (e.g., "ETH", "BSC").                                                                                                                                    |
| address       | string | The withdrawal address for the specified coin.                                                                                                                                       |
| addressTag    | string | Extra information required for certain coins (e.g., memo, destination tag).                                                                                                          |
| status        | string | <p>The address approval status. Present in the response only while the status is <code>PENDING\_APPROVAL</code>. </p><p>Omitted once the address has been <code>APPROVED</code>.</p> |
| coolOffEndsAt | long   | Expiry timestamp of the address cool-down period, in milliseconds. Present only while the cool-down period is active.                                                                |

#### Error code

| Code  | Message                                                                                       |
| ----- | --------------------------------------------------------------------------------------------- |
| -1000 | An unknown error occurred while processing the request.                                       |
| -1004 | Server is busy, please wait and try again.                                                    |
| -1021 | Missing timestamp.                                                                            |
| -1021 | timestamp 1744965768000 is outside of the allowed time window \[1744965893139-1744965899139]. |
| -1021 | recvWindow cannot be more than 5000 milliseconds or be less than zero.                        |
| -1102 | A mandatory parameter was blank, empty, or malformed.                                         |
| -1130 | Invalid network.                                                                              |
| -1099 | Exchange user account not found.                                                              |
| -4007 | Address validation is not passed.                                                             |
| -4007 | Address is still in cool-off period.                                                          |
| -4008 | .Address tag is required.                                                                     |
| -4008 | Address tag must be null. Please leave address tag NULL in the request.                       |

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

```json
[
  {
    "coin": "BTC",
    "network": "BTC",
    "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
    "addressTag": "99999",
    "status": "PENDING_APPROVAL",
    "coolOffEndsAt": 1774538044000
  }
]
```

{% endtab %}

{% tab title="401 Unauthorized" %}

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

{% endtab %}
{% endtabs %}