Skip to main content

Account Balance V2

Type: USER-DATA

GET /fapi/v2/balance

All asset balances for the calling key's user — one row per asset in the perp margin ledger (ledger.accounts); spot wallet balances are not included. (External equivalent: /fapi/v2/balance.)

Request

GET /fapi/v2/balance

Parameters: none beyond the standard signing trio.

Response — 200

[
{
"accountAlias": "5cfb031b-5936-4467-9533-cd2df576dbb8",
"asset": "USDC",
"balance": "100.000000",
"crossWalletBalance": "100.000000",
"availableBalance": "85.230000",
"updateTime": 1748275200000
}
]
FieldNotes
accountAliasUser UUID. Same value across all rows.
balanceavailable + locked total.
crossWalletBalanceSame as balance (Rocky uses cross-margin).
availableBalanceFree balance.
updateTimeServer time at response (ms); identical on every row.

crossUnPnl, maxWithdrawAmount, marginAvailable, updateTime per-row variations are not yet supported.

Errors

HTTPcodemsg
500-1000Database failure.

Signature and API-key failures (-1021, -1022, -1102, -2014, -2015) and rate limiting (-1003, HTTP 429) apply to every signed endpoint; see Error Codes.