获取未平仓合约数

类型：NONE

权重：1

GET /fapi/v1/openInterest

状态：已实现。

从 ledger.positions 聚合未平仓量——该 symbol 所有正值（多头）qty 之和。在没有外部对手方的封闭系统中 sum(longs) == sum(abs(shorts))，因此只需对多头一侧求和，既足够又避免重复计数。

请求

参数	类型	必填
symbol	string	是

响应

字段	类型	说明
openInterest	string	多头 qty 之和（基础资产单位），decimal 字符串；无持仓时为 "0"。
time	int64	构造响应时的服务器时间（ms）。

{
  "symbol": "BTCUSDT",
  "openInterest": "12.500000000000000000",
  "time": 1782899500075
}

错误

HTTP	code	msg
400	-1100	未知 symbol。
400	—	symbol 缺失或格式错误：axum 的纯文本拒绝（Failed to deserialize query string: …），不是 {code,msg} JSON 形态。
500	-1000	数据库错误。

来源：rocky-backend/services/api-gateway/src/fapi/routes_market.rs（open_interest handler）。