Futures Account Balance V2

Type: USER-DATA

Weight: 5

GET /fapi/v2/balance

Collateral balances for the calling key's account on this deployment.

Only v2 exists. GET /fapi/v1/balance returns 404 — most Binance SDKs default to v2.

Request

GET /fapi/v2/balance?timestamp=<ms>&signature=<hex>

Parameters: none beyond timestamp / signature.

Response — 200

[
  {
    "accountAlias": "default",
    "asset": "USDT",
    "balance": "1000.00",
    "crossWalletBalance": "1000.00",
    "crossUnPnl": "12.3456",
    "availableBalance": "850.00",
    "maxWithdrawAmount": "850.00",
    "marginAvailable": true,
    "updateTime": 1714261234567
  }
]

Field	Notes
accountAlias	Always "default" — one wallet address is one account.
balance	available + frozen.
crossUnPnl	Sum of unrealised PnL over open positions at current mark price.
availableBalance	Free balance.
maxWithdrawAmount	Currently equals availableBalance (the real withdrawable amount, which subtracts open losses, is enforced by POST /api/v1/withdraw/request).

A user with no balance row yet receives a single placeholder row with balance: "0" so the array is never empty.

Authentication failures (INVALID_API_KEY, API_KEY_DISABLED, IP_NOT_ALLOWED, SIGNATURE_INVALID) apply to every signed endpoint and use Sparky's {"success":false,"error":{...}} envelope; see Error Codes.