跳到主要内容

账户余额 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 相同。
balanceavailable + locked 总额。
crossWalletBalance与 balance 相同(Rocky 使用全仓保证金)。
availableBalance可用余额。
updateTime服务端响应时间(毫秒),所有 row 相同。

crossUnPnl、maxWithdrawAmount、marginAvailable、每行 updateTime 差异 暂未支持。

错误

HTTPcodemsg
500-1000数据库故障。

签名 / API key 错误(-1021、-1022、-1102、-2014、-2015)及限流(-1003,HTTP 429)适用于所有签名接口;见 错误码。