期货分钟线

查询单个期货合约历史分钟行情及可用持仓量。

数据范围: 单个受支持的境内期货合约的历史区间
包含内容: 分钟时间、开高低收、成交量、成交额及可用持仓量；字段缺失保留空值
时间覆盖: 1分钟历史已核实可查 2010-01-04（CU1002.SHF 样例），并持续更新；各品种、合约及周期起点不同，持仓量等字段可能缺失
数据频率: 1 / 5 / 15 / 30 / 60 分钟

期货历史数据

期货、期权均使用独立权限与独立接口；返回统一采用 data.fields + data.items，每行按字段顺序排列。

POSThttps://jinniu.lingxideai.com/api/fut_mins

请求参数

参数	必填	说明
ts_code	是	单个期货合约代码，带交易所后缀，例如 `CU2310.SHF`。
freq	是	`1min`、`5min`、`15min`、`30min` 或 `60min`。
start_date / end_date	是	起止时间，推荐 `YYYY-MM-DD HH:MM:SS`，也支持 `YYYYMMDD`。
limit	否	1 至 6000，默认 6000。
fields	否	可选字段：`ts_code,trade_time,open,close,high,low,vol,amount,oi`。

请求示例

curl -X POST 'https://jinniu.lingxideai.com/api/fut_mins' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"C1305.DCE","freq":"1min","start_date":"2013-01-04 09:30:00","end_date":"2013-01-04 09:31:00","limit":2}'

返回参数

字段	类型	说明
ts_code / trade_time	string	合约代码、交易时间（北京时间）；文本字段，无计量单位。
open / close / high / low	number	开盘、收盘、最高、最低价；单位为合约报价单位，例如元/吨、元/克或指数点，以交易所合约规则为准。
vol	number	成交量，单位：手。
amount	number	成交金额，单位：元人民币。
oi	number	持仓量，单位：手。
data.meta.matched_count / returned_count	number	匹配行数、实际返回行数，单位：条。
data.meta.truncated	boolean	是否因 `limit` 截断；布尔值，无计量单位。

返回示例

{"success":true,"message":"","data":{"fields":["ts_code","trade_time","open","close","high","low","vol","amount","oi"],"items":[["CU2310.SHF","2023-08-25 15:00:00",68920,68930,68940,68910,373,128543250,146733]],"meta":{"matched_count":100,"returned_count":100,"truncated":false}}}