期货日线

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

查询未复权的期货合约日线。成交量和持仓量单位为手，成交金额单位为万元人民币。2020年前后统计口径有双边转单边差异。需要开通“期货历史”权限，期限与期货历史分钟线一致；不包含实时权限。

参数	必填	说明
api_key	是	账户 API Key，也可通过 X-Api-Key 请求头传入。
ts_code	否	单个合约代码，如 CU2611.SHF；主力代码如 CU.SHF。使用 .SHF/.CFX/.ZCE/.DCE/.INE/.GFE 后缀。
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	否	逗号分隔的返回字段；不填返回默认字段。可选：`ts_code,trade_date,pre_close,pre_settle,open,high,low,close,settle,change1,change2,vol,amount,oi,oi_chg`。

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

调用示例

curl -X POST 'https://jinniu.ziyoutang.com/api/fut_daily' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"limit": 2, "trade_date": "20261015", "ts_code": "CU2611.SHF"}'

返回字段

字段	说明
ts_code	合约或主力连续代码；无单位。
trade_date	交易日期，YYYYMMDD；夜盘按交易所交易日归属。
pre_close	昨收盘价；单位为该合约报价单位。
pre_settle	昨结算价；单位为该合约报价单位。
open	开盘价；单位为该合约报价单位。
high	最高价；单位为该合约报价单位。
low	最低价；单位为该合约报价单位。
close	收盘价；单位为该合约报价单位。
settle	结算价；单位为该合约报价单位。
change1	收盘价相对昨结算价的变动记录；复权接口不重新计算。
change2	结算价相对昨结算价的变动记录；复权接口不重新计算。
vol	日线/排名为成交量（手）；仓单为今日仓单量，单位见 unit。
amount	成交金额，单位：万元人民币。
oi	持仓量，单位：手。
oi_chg	持仓量变化，单位：手。
data.meta.returned_count	实际返回数量，单位：条。
data.meta.limit / max_rows / offset / next_offset	本次分页大小、当前有效上限、偏移、下一页偏移；单位：条。末页 next_offset 为 null。
data.meta.possibly_more	本页是否已满；不代表一定存在下一条。

返回结构示例

{"data": {"fields": ["ts_code", "trade_date", "pre_close", "pre_settle", "open", "high", "low", "close", "settle", "change1", "change2", "vol", "amount", "oi", "oi_chg"], "items": [], "meta": {"limit": 2, "next_offset": null, "offset": 0, "possibly_more": false, "returned_count": 0}}, "message": "", "success": true}

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