账户余额 (Balances)
获取用户资产余额。
接口信息
- Method:
GET - Path:
/api/v1/account/balances - Authentication: 需要身份验证
响应示例
{
"balances": [
{
"token": "USDT",
"available": "1000.00",
"frozen": "200.50",
"total": "1200.50"
},
{
"token": "USDC",
"available": "500.00",
"frozen": "0.00",
"total": "500.00"
}
]
}
响应字段说明
| 字段 | 类型 | 描述 |
|---|---|---|
| balances | array | 余额列表 |
Balance 对象字段
| 字段 | 类型 | 描述 |
|---|---|---|
| token | string | 资产名称(如 USDT, USDC) |
| available | string | 可用余额 |
| frozen | string | 冻结余额(用于订单保证金) |
| total | string | 总余额(available + frozen) |
余额状态说明
可用余额 (Available)
可用于以下操作的余额:
- 创建新订单
- 开仓/增加仓位
- 提现
冻结余额 (Frozen)
被以下操作锁定的余额:
- 挂单中的订单保证金
- 持仓中的抵押品
- 待处理的提现
说明
- 所有余额均为字符串格式以保证精度
- 系统支持多种抵押品资产(USDT, USDC 等)
- 余额实时更新,反映最新的账户状态
- 冻结余额会在订单取消或仓位平仓后自动释放