賬戶總餘額

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

查詢指定加密貨幣賬戶的現金餘額和數字資產持倉。

路徑參數

參數	類型	必填	說明
acc_id	uint64	是	賬戶 ID

響應參數

字段	類型	說明
cash_list	list[CashItem]	法幣現金信息列表，每個幣種一條
positions	list[PositionItem]	數字資產持倉信息列表，每個幣種持倉一條

CashItem 字段

字段	類型	說明
currency	string	幣種代碼，如 USD、HKD
balance	string	現金結餘
available	string	可用金額，可用於交易的金額。包含可提金額及未結算可用但不可提的金額。
hold	string	現金凍結金額
drawable	string	現金可提金額
cash_buypower	string	現金購買力

PositionItem 字段

字段	類型	說明
symbol	string	持倉代碼，如 BTC、ETH
name	string	幣種名稱
side	string	持倉方向：long（多倉）/ short（空倉）
qty	string	持倉數量（空倉時為負數）
qty_avbl	string	可用數量
qty_hold	string	凍結數量

請求示例

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>"

響應示例

{
  "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"
      }
    ]
  }
}

失敗響應：

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