8.1 获取账户余额接口
#简要描述: 获取余额接口
- 请求方式: POST
- 请求接口: https://网关域名/funds/account/balance
- 请求媒体类型( JSON 数据格式 )Content-Type: application/json
查询参数
| 参数名称 | 类型 | 必填 | 参数含义 | 参数说明 |
|---|---|---|---|---|
| key | string | 是 | 商户 key | |
| accountId | string | 否 | 账户 ID | 示例:001 |
| sign | string | 是 | md5 签名 | 详见文档2 |
请求 json 样例
{
"key":"dNNTJZpgFVWlYrVv",
"sign":"9fbcd268617be6e2ae6099f05620e2a8"
}
返回值
| 参数名称 | 类型 | 参数含义 | 参数说明 |
|---|---|---|---|
| code | int | 请求状态 | 通信状态 成功返回:0,其它表示失败 |
| success | boolean | 成功状态 | true 成功 |
| message | string | 描述 | |
| data | json | 参数 | 参数详见下面说明 |
返回示例
{
"code": 0,
"success": true,
"message": null,
"data": {
"USDT": {
"balance": 10000,
"available": 10000,
"unavailable": 0
},
"CNY": {
"balance": 10009.76,
"available": 9233.83,
"unavailable": 775.93
}
}
}
data 参数说明
| 参数名称 | 类型 | 参数含义 | 备注 |
| CNY | object | 币种 | |
| └ balance | number | 余额 | |
| └available | number | 可用余额 | |
| └unavailable | string | 不可用余额 |