统一账户余额
统一账户余额
查询 Deepcoin 多账户体系下的余额,包括资金账户、现货账户、USDT 合约账户、币本位合约账户、体验金账户、返佣账户、事件合约账户、跟单账户和机器人账户。
该接口仅属于 v1 接口。它补充了 GET /deepcoin/account/balances 的能力;原接口通过 instType 按交易产品类型查询余额。
请求频率限制:10次/s / 300次/min
请求地址
GET /deepcoin/account/all-balances
请求参数
| 字段名 | 是否必填 | 类型 | 字段描述 |
|---|---|---|---|
| accountType | 否 | string | 账户类型,多个值用英文逗号分隔。支持:funding 资金账户、spot 现货账户、swapU USDT 合约账户、swap 币本位合约账户、bonus 体验金账户、rebate 返佣账户、event 事件合约账户、copyTrade 跟单账户、robot 机器人账户、all 全部账户。不传时,返回所有有非零余额的支持账户。 |
| ccy | 否 | string | 币种,多个值用英文逗号分隔,例如 USDT,BTC。不传时,返回匹配账户下所有非零币种。 |
响应参数
| 字段名 | 类型 | 字段描述 |
|---|---|---|
| uTime | string | 数据更新时间,Unix 毫秒时间戳 |
| summary | object | 本次返回账户的余额汇总 |
| summary.totalEqUsd | string | USD 计价总权益 |
| summary.totalAvailBalByCcy | object | 按币种聚合的总可用余额 |
| accounts | array | 账户余额列表 |
| accounts[].accountType | string | 账户类型 |
| accounts[].accountName | string | 账户展示名称 |
| accounts[].enabled | boolean | 账户是否启用 |
| accounts[].details | array | 账户下的币种余额明细 |
| accounts[].details[].ccy | string | 币种 |
| accounts[].details[].bal | string | 余额 |
| accounts[].details[].availBal | string | 可用余额 |
| accounts[].details[].frozenBal | string | 冻结余额 |
| accounts[].details[].unrealizedProfit | string | 未实现盈亏。现货、USDT 合约和币本位合约账户按币种聚合返回;其他账户无持仓盈亏时返回 0。 |
| accounts[].details[].equity | string | 总权益,等于 bal + unrealizedProfit |
| accounts[].details[].eqUsd | string | USD 计价权益 |
| accounts[].details[].uTime | string | 币种余额更新时间,Unix 毫秒时间戳 |
请求示例
GET /deepcoin/account/all-balances?accountType=funding,spot,swapU&ccy=USDT
响应示例
{
"code": "0",
"msg": "",
"data": {
"uTime": "1777449600000",
"summary": {
"totalEqUsd": "11845.50",
"totalAvailBalByCcy": {
"USDT": "11830.00"
}
},
"accounts": [
{
"accountType": "funding",
"accountName": "资金账户",
"enabled": true,
"details": [
{
"ccy": "USDT",
"bal": "1930.00",
"availBal": "1930.00",
"frozenBal": "0",
"unrealizedProfit": "0",
"equity": "1930.00",
"eqUsd": "1930.00",
"uTime": "1777449600000"
}
]
},
{
"accountType": "spot",
"accountName": "现货账户",
"enabled": true,
"details": [
{
"ccy": "USDT",
"bal": "9900.00",
"availBal": "9900.00",
"frozenBal": "0",
"unrealizedProfit": "15.50",
"equity": "9915.50",
"eqUsd": "9915.50",
"uTime": "1777449600000"
}
]
}
]
}
}