期货仓单日报

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

查询仓库或厂库仓单数量及变化。数量必须结合 unit 字段理解；缺失数值保留 null，不补零。需要开通“期货历史”权限，期限与期货历史分钟线一致；不包含实时权限。

参数	必填	说明
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 至 1000，默认 1000；全站设置与本接口限制取较小值。
offset	否	偏移行数，默认0，最大10000000。保持筛选条件不变，按 next_offset 继续；possibly_more=true 仅表示本页已满，可继续查询，直到返回不足 limit 条。
fields	否	逗号分隔的返回字段；不填返回默认字段。可选：`trade_date,symbol,fut_name,warehouse,pre_vol,vol,vol_chg,unit`。

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

调用示例

curl -X POST 'https://jinniu.ziyoutang.com/api/fut_wsr' \
  -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	不带交易所后缀的合约或产品代码；无单位。
fut_name	期货产品名称。
warehouse	仓库或厂库名称。
pre_vol	昨日仓单量，单位见 unit。
vol	日线/排名为成交量（手）；仓单为今日仓单量，单位见 unit。
vol_chg	成交量变化（手）；仓单接口为仓单增减，单位见 unit。
unit	仓单数量计量单位，以本字段为准。
data.meta.returned_count	实际返回数量，单位：条。
data.meta.limit / max_rows / offset / next_offset	本次分页大小、当前有效上限、偏移、下一页偏移；单位：条。末页 next_offset 为 null。
data.meta.possibly_more	本页是否已满；不代表一定存在下一条。

返回结构示例

{"data": {"fields": ["trade_date", "symbol", "fut_name", "warehouse", "pre_vol", "vol", "vol_chg", "unit"], "items": [], "meta": {"limit": 2, "next_offset": null, "offset": 0, "possibly_more": false, "returned_count": 0}}, "message": "", "success": true}

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