账户余额 V2(USER-DATA)
类型:USER-DATA
GET /fapi/v2/balance
调用方 key 关联用户的全部资产余额——合约保证金账本(ledger.accounts)中每个资产一行;不包含现货钱包余额。(对应路径:/fapi/v2/balance。)
请求
GET /fapi/v2/balance
参数: 仅需标准签名三件套。
响应 — 200
[
{
"accountAlias": "5cfb031b-5936-4467-9533-cd2df576dbb8",
"asset": "USDC",
"balance": "100.000000",
"crossWalletBalance": "100.000000",
"availableBalance": "85.230000",
"updateTime": 1748275200000
}
]
| 字段 | 说明 |
|---|---|
accountAlias | 用户 UUID,所有 row 相同。 |
balance | available + locked 总额。 |
crossWalletBalance | 与 balance 相同(Rocky 使用全仓保证金)。 |
availableBalance | 可用余额。 |
updateTime | 服务端响应时间(毫秒),所有 row 相同。 |
crossUnPnl、maxWithdrawAmount、marginAvailable、每行updateTime差异 暂未支持。
错误
| HTTP | code | msg |
|---|---|---|
500 | -1000 | 数据库故障。 |
签名 / API key 错误(-1021、-1022、-1102、-2014、-2015)及限流(-1003,HTTP 429)适用于所有签名接口;见 错误码。