商户
获取加密资产余额
获取指定商户的加密货币钱包余额，或获取与你的 API key 关联的所有商户的汇总余额。
GET
/
v2
/
assets
/
account
/
assets
获取加密资产余额
curl --request GET \
--url https://api-test.velafi.com/v2/assets/account/assets \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/account/assets"
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/account/assets', 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/account/assets")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"canDeposit": true,
"balances": [
{
"asset": "<string>",
"assetId": "<string>",
"assetName": "<string>",
"total": "<string>",
"free": "<string>",
"locked": "<string>"
}
]
}
}使用此接口查询商户托管钱包中持有的加密资产余额。传入指定的
merchantId 可将结果限定为单个商户，传入 0 则返回与你的 API key 关联的所有商户的汇总余额。每个资产条目显示总余额、可用（free）部分以及锁定金额（为待处理订单预留）。
所有请求都必须包含
X-BH-TOKEN 请求头，其值为通过 GET /v2/token/generate 获取的业务令牌。接口地址
GET https://api.velafi.com/v2/assets/account/assets
查询参数
integer
必填
要查询的商户 ID。传入
0 可汇总与此 API key 关联的所有商户的余额。响应字段
number
HTTP 风格的响应码。
200 表示成功。string
可读的状态信息，例如
SUCCESS。object
示例
- 指定商户
- 汇总（所有商户）
cURL
curl -G https://api.velafi.com/v2/assets/account/assets \
-H "X-BH-TOKEN: YOUR_TOKEN" \
--data-urlencode "merchantId=12345"
Response
{
"code": 200,
"msg": "SUCCESS",
"data": {
"canDeposit": true,
"balances": [
{
"asset": "USDT",
"assetId": "USDT",
"assetName": "USDT",
"total": "1000",
"free": "800",
"locked": "200"
},
{
"asset": "BTC",
"assetId": "BTC",
"assetName": "BTC",
"total": "0.5",
"free": "0.3",
"locked": "0.2"
}
]
}
}
cURL
curl -G https://api.velafi.com/v2/assets/account/assets \
-H "X-BH-TOKEN: YOUR_TOKEN" \
--data-urlencode "merchantId=0"
Response
{
"code": 200,
"msg": "SUCCESS",
"data": {
"canDeposit": true,
"balances": [
{
"asset": "USDT",
"assetId": "USDT",
"assetName": "USDT",
"total": "5000",
"free": "4000",
"locked": "1000"
},
{
"asset": "BTC",
"assetId": "BTC",
"assetName": "BTC",
"total": "2",
"free": "1.5",
"locked": "0.5"
}
]
}
}
当
merchantId 为 0 时，API 会汇总绑定到同一账户的所有商户的余额。使用此方式可以获得整体资产视图，而无需逐一遍历各个商户 ID。⌘I
获取加密资产余额
curl --request GET \
--url https://api-test.velafi.com/v2/assets/account/assets \
--header 'X-BH-TOKEN: <api-key>'import requests
url = "https://api-test.velafi.com/v2/assets/account/assets"
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/account/assets', 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/account/assets")
.header("X-BH-TOKEN", "<api-key>")
.asString();{
"code": 123,
"msg": "<string>",
"data": {
"canDeposit": true,
"balances": [
{
"asset": "<string>",
"assetId": "<string>",
"assetName": "<string>",
"total": "<string>",
"free": "<string>",
"locked": "<string>"
}
]
}
}