Total Balance

GET /api/v1/crypto/accounts/{acc_id}/total-balance

Query the cash balance and digital asset positions for a specified crypto account.

Path Parameters

Parameter	Type	Required	Description
acc_id	uint64	Yes	Account ID

Response Parameters

Field	Type	Description
cash_list	list[CashItem]	List of fiat cash entries, one per currency
positions	list[PositionItem]	List of digital asset position entries, one per held asset

CashItem Fields

Field	Type	Description
currency	string	Currency code, e.g. USD, HKD
balance	string	Cash balance
available	string	Available amount. Amount available for trading, including withdrawable funds and unsettled funds available for trading but not withdrawal.
hold	string	Frozen cash
drawable	string	Withdrawable cash
cash_buypower	string	Cash buying power

PositionItem Fields

Field	Type	Description
symbol	string	Asset code, e.g. BTC, ETH
name	string	Asset name
side	string	Position direction: long / short
qty	string	Position quantity (negative for short positions)
qty_avbl	string	Available quantity
qty_hold	string	Frozen quantity

Request Example

curl -X GET "https://webapi.futunn.com/api/v1/crypto/accounts/123456/total-balance" \
  -H "X-Api-Key: <AppKey>" \
  -H "X-Timestamp: <timestamp_ms>" \
  -H "X-Nonce: <nonce>" \
  -H "Authorization: <signature_base64>"

Response Example

{
  "code": 0,
  "msg": "success",
  "data": {
    "cash_list": [
      {
        "currency": "USD",
        "balance": "9817.75",
        "available": "9817.75",
        "hold": "0.00",
        "drawable": "9817.75",
        "cash_buypower": "9817.75"
      }
    ],
    "positions": [
      {
        "symbol": "BTC",
        "name": "Bitcoin",
        "side": "long",
        "qty": "1.00278",
        "qty_avbl": "1.00278",
        "qty_hold": "0"
      }
    ]
  }
}

Error Response:

{
  "code": 1,
  "msg": "Error message."
}