加密钱包
获取加密货币提现记录
列出从 VelaFi 商户钱包发起的加密货币提现记录，按时间倒序排列，可按代币、clientId 和时间范围筛选。
GET
/
v2
/
assets
/
withdrawalOrders
获取加密货币提现记录
curl --request GET \
--url https://api-test.velafi.com/v2/assets/withdrawalOrders \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/withdrawalOrders"
headers = {"X-BH-TOKEN": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};
fetch('https://api-test.velafi.com/v2/assets/withdrawalOrders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api-test.velafi.com/v2/assets/withdrawalOrders")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": [
{
"orderId": 123,
"merchantId": 123,
"time": 123,
"crypto": "<string>",
"cryptoName": "<string>",
"address": "<string>",
"addressTag": "<string>",
"cryptoAmount": "<string>",
"fee": "<string>",
"feeCrypto": "<string>",
"arriveCryptoAmount": "<string>",
"status": 123,
"txId": "<string>",
"txIdUrl": "<string>",
"remark": "<string>"
}
]
}使用此接口跟踪从商户钱包提现到外部地址的加密货币提现记录，包括通过创建加密货币提现创建的提现。如需在提现进入最终状态时收到通知，请订阅加密货币提现事件。您也可以按
clientId 轮询此接口，直到 status 为 6、7 或 9，例如用于核对错过 Webhook 的提现。此列表中的稳定币支付退款不会触发该 Webhook。该列表还可能包含其他提现类记录，例如批量付款。提现到 VelaFi 钱包地址的操作会记为内部转账，并显示在加密货币转账记录中。结果按时间倒序排列，单次调用最多返回 pageSize 条记录。如需查找某一笔提现，请按 clientId 筛选。
所有请求都必须在
X-BH-TOKEN 请求头中携带通过 GET /v2/token/generate 获取的业务令牌。接口地址
GET https://api.velafi.com/v2/assets/withdrawalOrders
查询参数
number
必填
商户 ID。
string
按代币符号筛选，例如
USDT。string
按创建提现时您提供的
clientId 筛选。number
仅返回在此时间或之后创建的提现记录（Unix 毫秒时间戳）。
number
仅返回在此时间或之前创建的提现记录（Unix 毫秒时间戳）。
number
默认值:"10"
返回的最大记录数，取值范围
1 到 1000。默认为 10。响应字段
number
200 表示成功。string
成功时为
SUCCESS。array
显示 data 元素字段
显示 data 元素字段
number
提现记录 ID。与创建加密货币提现接口返回的
orderId 一致。number
被扣款钱包所属的商户。
number
提现记录的创建时间（Unix 毫秒时间戳）。
string
代币符号。
string
代币名称。目前与
crypto 相同。string
目标地址。
string
目标地址的 memo 或标签（如有）。
string
提现金额。
string
网络手续费。
string
手续费的计价代币。始终与
crypto 相同。string
cryptoAmount 减去 fee 后的金额。number
提现状态：
5— 处理中，包括因 VelaFi 内部审核而暂缓的提现6— 成功7— 失败9— 已取消0— 其他任何状态，例如提现正在等待子账户审批，或因风险信息请求 (RFI) 而暂缓
string
链上交易哈希（可用后返回）。
string
该交易的区块浏览器链接。
string
创建提现时您提供的
remark。示例
cURL
curl -G https://api.velafi.com/v2/assets/withdrawalOrders \
-H "X-BH-TOKEN: YOUR_TOKEN" \
--data-urlencode "merchantId=151209" \
--data-urlencode "clientId=withdraw-0001"
⌘I
获取加密货币提现记录
curl --request GET \
--url https://api-test.velafi.com/v2/assets/withdrawalOrders \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/withdrawalOrders"
headers = {"X-BH-TOKEN": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-BH-TOKEN': '<api-key>'}};
fetch('https://api-test.velafi.com/v2/assets/withdrawalOrders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api-test.velafi.com/v2/assets/withdrawalOrders")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": [
{
"orderId": 123,
"merchantId": 123,
"time": 123,
"crypto": "<string>",
"cryptoName": "<string>",
"address": "<string>",
"addressTag": "<string>",
"cryptoAmount": "<string>",
"fee": "<string>",
"feeCrypto": "<string>",
"arriveCryptoAmount": "<string>",
"status": 123,
"txId": "<string>",
"txIdUrl": "<string>",
"remark": "<string>"
}
]
}