持仓量

跟踪某大宗商品的期货持仓量。

接口

GET /commodity/v1/openInterest

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

查询参数

名称	类型	必填	默认	说明
symbol	string	是	—	商品代码，例如 XAU（黄金）、WTI（原油）。
period	string	否	1d	聚合周期。
limit	integer	否	30	返回的数据点数量。

响应 —— 200 OK

{
  "symbol": "XAU",
  "openInterest": "458213",
  "time": 1745884800000
}

错误

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

示例

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