> ## 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.

# 获取加密货币提现记录

> 列出从 VelaFi 商户钱包发起的加密货币提现记录，按时间倒序排列，可按代币、clientId 和时间范围筛选。

使用此接口跟踪从商户钱包提现到外部地址的加密货币提现记录，包括通过[创建加密货币提现](https://docs.velafi.com/cn/api-reference/crypto-wallet/create-crypto-withdrawal.md)创建的提现。如需在提现进入最终状态时收到通知，请订阅[加密货币提现事件](https://docs.velafi.com/cn/api-reference/webhooks/crypto-withdraw-message-push.md)。您也可以按 `clientId` 轮询此接口，直到 `status` 为 `6`、`7` 或 `9`，例如用于核对错过 Webhook 的提现。此列表中的稳定币支付退款不会触发该 Webhook。该列表还可能包含其他提现类记录，例如批量付款。提现到 VelaFi 钱包地址的操作会记为内部转账，并显示在[加密货币转账记录](https://docs.velafi.com/cn/api-reference/merchant/query-crypto-transfers.md)中。结果按时间倒序排列，单次调用最多返回 `pageSize` 条记录。如需查找某一笔提现，请按 `clientId` 筛选。

> [!NOTE]
>
> 所有请求都必须在 `X-BH-TOKEN` 请求头中携带通过 `GET /v2/token/generate` 获取的业务令牌。

## 接口地址

`GET https://api.velafi.com/v2/assets/withdrawalOrders`

## 查询参数

**merchantId** `number` *required*

商户 ID。

**crypto** `string`

按代币符号筛选，例如 `USDT`。

**clientId** `string`

按创建提现时您提供的 `clientId` 筛选。

**startTime** `number`

仅返回在此时间或之后创建的提现记录（Unix 毫秒时间戳）。

**endTime** `number`

仅返回在此时间或之前创建的提现记录（Unix 毫秒时间戳）。

**pageSize** `number` (default: 10)

返回的最大记录数，取值范围 `1` 到 `1000`。默认为 `10`。

## 响应字段

**code** `number`

`200` 表示成功。

**msg** `string`

成功时为 `SUCCESS`。

**data** `array`

**data 元素字段**

**orderId** `number`

提现记录 ID。与创建加密货币提现接口返回的 `orderId` 一致。

**merchantId** `number`

被扣款钱包所属的商户。

**time** `number`

提现记录的创建时间（Unix 毫秒时间戳）。

**crypto** `string`

代币符号。

**cryptoName** `string`

代币名称。目前与 `crypto` 相同。

**address** `string`

目标地址。

**addressTag** `string`

目标地址的 memo 或标签（如有）。

**cryptoAmount** `string`

提现金额。

**fee** `string`

网络手续费。

**feeCrypto** `string`

手续费的计价代币。始终与 `crypto` 相同。

**arriveCryptoAmount** `string`

`cryptoAmount` 减去 `fee` 后的金额。

**status** `number`

提现状态：

* `5` — 处理中，包括因 VelaFi 内部审核而暂缓的提现
* `6` — 成功
* `7` — 失败
* `9` — 已取消
* `0` — 其他任何状态，例如提现正在等待子账户审批，或因风险信息请求 (RFI) 而暂缓

**txId** `string`

链上交易哈希（可用后返回）。

**txIdUrl** `string`

该交易的区块浏览器链接。

**remark** `string`

创建提现时您提供的 `remark`。

## 示例

```bash cURL theme={null}
curl -G https://api.velafi.com/v2/assets/withdrawalOrders \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  --data-urlencode "merchantId=151209" \
  --data-urlencode "clientId=withdraw-0001"
```


## Related topics

- [加密货币提现事件](https://docs.velafi.com/cn/api-reference/webhooks/crypto-withdraw-message-push.md)
- [创建加密货币提现](https://docs.velafi.com/cn/api-reference/crypto-wallet/create-crypto-withdrawal.md)
- [获取加密货币充值记录](https://docs.velafi.com/cn/api-reference/crypto-wallet/get-crypto-deposit-history.md)
- [获取加密货币划转记录](https://docs.velafi.com/cn/api-reference/merchant/query-crypto-transfers.md)
- [获取加密货币列表](https://docs.velafi.com/cn/api-reference/basic-configuration/get-list-of-crypto-currencies.md)


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