持仓量历史

历史持仓量序列。透传 Binance USDⓈ-M 永续合约 /futures/data/openInterestHist。

接口

GET /openInterestHist

鉴权： 公开。

查询参数

参数	类型	必填	默认值	说明
symbol	string	是	—	大写永续合约符号。
period	string	否	5m	5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d 之一。
limit	integer	否	10	Binance 最大 500。

响应 — 200 OK

数组（Binance 结构）：

[
  {
    "symbol": "BTCUSDT",
    "sumOpenInterest": "12345.678",
    "sumOpenInterestValue": "827654321.00",
    "timestamp": 1745920800000
  }
]

错误

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

示例

curl -s "https://api.pipai.org/openInterestHist?symbol=BTCUSDT&period=1h&limit=24"