API REFERENCE

期货分钟线

期货历史数据

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

期货分钟线

POSThttps://jinniu.ziyoutang.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 至 5000,默认 5000。
fields否可选字段:ts_code,trade_time,open,close,high,low,vol,amount,oi。

请求示例

curl -X POST 'https://jinniu.ziyoutang.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_timestring合约代码、交易时间(北京时间);文本字段,无计量单位。
open / close / high / lownumber开盘、收盘、最高、最低价;单位为合约报价单位,例如元/吨、元/克或指数点,以交易所合约规则为准。
volnumber成交量,单位:手。
amountnumber成交金额,单位:元人民币。
oinumber持仓量,单位:手。
data.meta.matched_count / returned_countnumber匹配行数、实际返回行数,单位:条。
data.meta.truncatedboolean是否因 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}}}