期货历史数据
期货、期权均使用独立权限与独立接口;返回统一采用 data.fields + data.items,每行按字段顺序排列。
期货分钟线
POST
https://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_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}}}