持仓量

单个交易对的当前持仓量。透传 Binance USDⓈ-M 永续合约 /fapi/v1/openInterest。

接口

GET /fapi/v1/openInterest

鉴权： 公开。

查询参数

参数	类型	必填	默认值	说明
symbol	string	是	—	大写永续合约符号。
period	string	否	5m	透传到 Binance。有效值与 Binance 接受的周期一致（5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d）。
limit	integer	否	10	透传到 Binance。

注意： Binance 官方 /fapi/v1/openInterest 端点只接受 symbol（返回最新快照）。period 与 limit 参数会被透传，但上游可能忽略。需要历史序列请使用 /openInterestHist。

响应 — 200 OK

{
  "symbol": "BTCUSDT",
  "openInterest": "12345.678",
  "time": 1745920800000
}

错误

HTTP	触发原因
422	缺少 symbol。
502	上游 Binance 请求失败。

示例

curl -s "https://api.pipai.org/fapi/v1/openInterest?symbol=BTCUSDT"