> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 添加白名单地址

> 将目标地址添加到加密货币提现白名单。通过 API 提现只能发送至白名单地址。

通过 API 进行的加密货币提现只能发送至提现白名单中的地址。使用此端点为特定代币和网络添加地址。白名单条目归属于您的 API 用户，因此适用于其下的所有商户。

> [!NOTE]
>
> 所有请求都必须在 `X-BH-TOKEN` 请求头中携带访问令牌，并设置 `Content-Type: application/json`。请参阅[身份验证](https://docs.velafi.com/cn/api-reference/authentication.md)。

## 端点

`POST https://api.velafi.com/v2/user/whitelistAddress`

## 请求参数

**crypto** `string` *required*

代币符号，例如 `USDT`。必须是 VelaFi 当前已启用的代币。

**chainType** `string` *required*

网络名称，例如 `TRC20`。请使用[获取提现额度](https://docs.velafi.com/cn/api-reference/crypto-wallet/get-withdrawal-quota.md)返回的 `chainType`。

**address** `string` *required*

目标地址。必须是该网络的有效地址，否则请求将被拒绝。

**addressTag** `string`

Memo 或标签，适用于需要使用它的网络。向此条目提现时必须使用相同的 `addressTag`。

**remark** `string`

您为该地址设置的标签。

如果添加的地址在白名单中已存在相同的 `crypto`、`chainType`、`address` 和 `addressTag`，请求将因重复而被拒绝。

## 响应字段

**code** `number`

`200` 表示成功。

**msg** `string`

成功时为 `SUCCESS`。

**data** `object`

**data 字段**

**addressId** `number`

白名单条目的 ID。可用于删除该条目。

**crypto** `string`

代币符号。

**chainType** `string`

网络名称。

**address** `string`

白名单地址。

**addressTag** `string`

Memo 或标签。如无则为空字符串。

**remark** `string`

您为该地址设置的标签。

## 示例

```bash cURL theme={null}
curl -X POST https://api.velafi.com/v2/user/whitelistAddress \
  -H "X-BH-TOKEN: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "crypto": "USDT",
    "chainType": "TRC20",
    "address": "YOUR_DESTINATION_ADDRESS",
    "remark": "Treasury wallet"
  }'
```


## Related topics

- [获取提现额度](https://docs.velafi.com/cn/api-reference/crypto-wallet/get-withdrawal-quota.md)
- [删除白名单地址](https://docs.velafi.com/cn/api-reference/crypto-wallet/delete-whitelist-address.md)
- [获取白名单地址列表](https://docs.velafi.com/cn/api-reference/crypto-wallet/get-whitelist-addresses.md)
- [认证](https://docs.velafi.com/cn/api-reference/authentication.md)
- [创建 API 密钥](https://docs.velafi.com/cn/docs/guides/creating-api-key.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.