商户
获取加密货币划转记录
查询商户钱包之间内部加密货币划转的完整历史，可按代币代码、日期范围和客户端 ID 筛选。
GET
/
v2
/
assets
/
internalTransferOrders
获取加密货币划转记录
curl --request GET \
--url https://api-test.velafi.com/v2/assets/internalTransferOrders \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/internalTransferOrders"
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/internalTransferOrders', 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/internalTransferOrders")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": [
{
"id": "<string>",
"tokenId": "<string>",
"amount": "<string>",
"clientId": "<string>",
"merchantId": "<string>",
"fromMerchantId": "<string>",
"toMerchantId": "<string>"
}
]
}使用此接口获取涉及一个或多个商户钱包的内部加密货币划转历史。每笔完成的划转会生成两条记录——转出方的一条负数（借记）记录和接收方的一条正数（贷记）记录。使用
merchantId 筛选条件可将结果限定为单个商户。可与加密货币划转接口配合使用，构建完整的审计追踪。
所有请求都必须包含
X-BH-TOKEN 请求头，其值为通过 GET /v2/token/generate 获取的业务令牌。接口地址
GET https://api.velafi.com/v2/assets/internalTransferOrders
查询参数
number
按商户 ID 筛选记录。
string
按代币代码筛选，例如
USDT、BTC。string
按你提供的划转标识符筛选。
number
日期范围的开始时间，为毫秒级 Unix 时间戳。
number
日期范围的结束时间，为毫秒级 Unix 时间戳。
number
每页返回的记录数。
响应字段
number
HTTP 风格的响应码。
200 表示成功。string
可读的状态信息，例如
SUCCESS。array
示例
cURL
curl -G https://api.velafi.com/v2/assets/internalTransferOrders \
-H "X-BH-TOKEN: YOUR_TOKEN" \
--data-urlencode "merchantId=246" \
--data-urlencode "tokenId=USDT" \
--data-urlencode "pageSize=10"
Response
{
"code": 200,
"msg": "SUCCESS",
"data": [
{
"id": "4355",
"tokenId": "USDT",
"amount": "10",
"clientId": "crypto-transfer-001",
"merchantId": "61",
"fromMerchantId": "246",
"toMerchantId": "61"
},
{
"id": "4354",
"tokenId": "USDT",
"amount": "-10",
"clientId": "crypto-transfer-001",
"merchantId": "246",
"fromMerchantId": "246",
"toMerchantId": "61"
}
]
}
一笔划转会生成两条记录：一条属于转出方（
amount 为负数），一条属于接收方（amount 为正数）。merchantId 字段表明每条记录代表的是哪个商户的视角。⌘I
获取加密货币划转记录
curl --request GET \
--url https://api-test.velafi.com/v2/assets/internalTransferOrders \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/internalTransferOrders"
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/internalTransferOrders', 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/internalTransferOrders")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": [
{
"id": "<string>",
"tokenId": "<string>",
"amount": "<string>",
"clientId": "<string>",
"merchantId": "<string>",
"fromMerchantId": "<string>",
"toMerchantId": "<string>"
}
]
}