期货持仓排名

POSThttps://jinniu.ziyoutang.com/api/fut_holding

查询每日会员成交及多空持仓排名记录，不是分钟资金流。trade_date 或 symbol 至少填一个；SHFE 查询范围含部分能源中心合约。需要开通“期货历史”权限，期限与期货历史分钟线一致；不包含实时权限。

参数	必填	说明
api_key	是	账户 API Key，也可通过 X-Api-Key 请求头传入。
symbol	否	不带后缀的合约或产品代码，如 CU、CU2611。仓单使用产品代码。
exchange	否	交易所代码：CFFEX、DCE、CZCE、SHFE、INE、GFEX。
trade_date	否	交易日期，YYYYMMDD 或 YYYY-MM-DD。
start_date	否	起始交易日期，YYYYMMDD 或 YYYY-MM-DD。
end_date	否	截止交易日期，YYYYMMDD 或 YYYY-MM-DD。
limit	否	1 至 2000，默认 2000；全站设置与本接口限制取较小值。
offset	否	偏移行数，默认0，最大10000000。保持筛选条件不变，按 next_offset 继续；possibly_more=true 仅表示本页已满，可继续查询，直到返回不足 limit 条。
fields	否	逗号分隔的返回字段；不填返回默认字段。可选：`trade_date,symbol,broker,vol,vol_chg,long_hld,long_chg,short_hld,short_chg`。

日期、代码和筛选条件不满足要求时返回 HTTP 400，并附英文原因。除合约信息外，需提供合约/产品代码、交易日期或日期范围；持仓排名至少填 trade_date 或 symbol。空值保留 null。

调用示例

curl -X POST 'https://jinniu.ziyoutang.com/api/fut_holding' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"exchange": "SHFE", "limit": 2, "symbol": "CU", "trade_date": "20261015"}'

返回字段

字段	说明
trade_date	交易日期，YYYYMMDD；夜盘按交易所交易日归属。
symbol	不带交易所后缀的合约或产品代码；无单位。
broker	会员/期货公司名称；可能包含汇总记录。
vol	日线/排名为成交量（手）；仓单为今日仓单量，单位见 unit。
vol_chg	成交量变化（手）；仓单接口为仓单增减，单位见 unit。
long_hld	持买仓量，单位：手。
long_chg	持买仓变化，单位：手。
short_hld	持卖仓量，单位：手。
short_chg	持卖仓变化，单位：手。
data.meta.returned_count	实际返回数量，单位：条。
data.meta.limit / max_rows / offset / next_offset	本次分页大小、当前有效上限、偏移、下一页偏移；单位：条。末页 next_offset 为 null。
data.meta.possibly_more	本页是否已满；不代表一定存在下一条。

返回结构示例

{"data": {"fields": ["trade_date", "symbol", "broker", "vol", "vol_chg", "long_hld", "long_chg", "short_hld", "short_chg"], "items": [], "meta": {"limit": 2, "next_offset": null, "offset": 0, "possibly_more": false, "returned_count": 0}}, "message": "", "success": true}

SDK：client.fut_holding(...)；MCP 工具：fut_holding。调用频率、并发及错误处理统一见调用规则。