持仓量

跟踪某市场指数的期货/期权持仓量。

接口

GET /index/v1/openInterest

鉴权： 标准套餐。需携带与有效标准套餐（或更高）订阅绑定的平台 API 密钥（X-Primit-API-Key）。详见鉴权。

查询参数

名称	类型	必填	默认	说明
symbol	string	是	—	指数代码，例如 SPX、NDX。
period	string	否	1d	聚合周期。
limit	integer	否	30	返回的数据点数量。

响应 —— 200 OK

{
  "symbol": "SPX",
  "openInterest": "2310544",
  "time": 1745884800000
}

错误

HTTP	原因
401	缺少或无效的 X-Primit-API-Key。
403	无有效标准套餐（订阅已过期或未购买）。
404	symbol 不存在。
422	缺少 symbol。

示例

curl -s "https://api.pipai.org/index/v1/openInterest?symbol=SPX" \
  -H "X-Primit-API-Key: $PRIMIT_API_KEY"