账户总余额

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