持仓量

某美股标的相关期权/期货的持仓量。

接口

GET /stock/v1/openInterest

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

查询参数

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

响应 —— 200 OK

{
  "symbol": "AAPL",
  "openInterest": "1843221",
  "time": 1745884800000
}

错误

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

示例

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