交易员多空比

某commodity标的的大户（交易员）多空持仓比例。

接口

GET /commodity/v1/topLongShortRatio

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

查询参数

参数	类型	必填	默认	说明
symbol	string	是	—	例如 XAU。
period	string	否	1d	1h、4h、1d、1w 之一。
limit	integer	否	30	返回的数据点数量。

响应 —— 200 OK

[
  {
    "symbol": "XAU",
    "longShortRatio": "1.18",
    "longAccount": "0.5413",
    "shortAccount": "0.4587",
    "timestamp": 1745884800000
  }
]

错误

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

示例

curl -s "https://api.pipai.org/commodity/v1/topLongShortRatio?symbol=XAU&period=1d&limit=30" \
  -H "X-Primit-API-Key: $PRIMIT_API_KEY"