查询历史分钟 K 线
分钟线按标的类别拆分为股票、ETF、交易所指数与申万指数四类独立接口。每个接口均支持 1min、5min、15min、30min、60min。
时间规范:推荐使用北京时间
YYYY-MM-DD HH:MM:SS。日期格式 YYYYMMDD 也可使用:起始日期默认从 09:30:00 开始,结束日期默认至 15:00:00。返回数据按 trade_time 从早到晚排列。申万指数分钟 K 线
POST
https://jinniu.ziyoutang.com/api/sw_mins查询申万行业指数历史分钟 K 线,需要开通“申万指数分钟线”权限。指数代码使用 .SI 后缀,例如申万 A 指为 801003.SI。
请求示例
curl -X POST 'https://jinniu.ziyoutang.com/api/sw_mins' \
-H 'Content-Type: application/json' \
-H 'X-Api-Key: YOUR_API_KEY' \
-d '{"ts_code":"801003.SI","freq":"1min","start_date":"2026-09-21 09:30:00","end_date":"2026-09-21 15:00:00","limit":241}'
请求字段
| 字段 | 必填 | 说明 |
|---|---|---|
| api_key | 是 | 个人中心生成的 API Key,也可使用请求头 X-Api-Key。 |
| ts_code | 是 | 单个申万指数代码,必须带 .SI 后缀,例如 801003.SI。 |
| freq | 是 | 周期:1min、5min、15min、30min、60min。 |
| start_date / end_date | 是 | 起止时间,推荐格式 YYYY-MM-DD HH:MM:SS,按北京时间解释。 |
| limit | 否 | 返回行数,1 至 5000,默认 5000;超过时请按时间范围分批查询。 |
| fields | 否 | 逗号分隔的返回字段;不填返回全部标准字段。 |
返回字段
| 字段 | 说明 |
|---|---|
| data.fields / data.items | 返回字段顺序及分钟 K 线二维数组。 |
| data.meta.matched_count / returned_count | 匹配行数、实际返回行数,单位:条。 |
| data.meta.truncated | 是否因 limit 截断;布尔值,无计量单位。 |
| ts_code / trade_time | 申万指数代码、K 线时间;时间格式为 YYYY-MM-DD HH:MM:SS,北京时间。 |
| open / close / high / low | 开盘、收盘、最高、最低点位,单位:点。 |
| vol | 成交量,单位:股。 |
| amount | 成交额,单位:元人民币。 |
返回示例
{"success":true,"message":"","data":{"fields":["ts_code","trade_time","open","close","high","low","vol","amount"],"items":[["801003.SI","2026-09-21 09:30:00",4644.318,4644.154,4644.318,4644.154,1438409200,22328654000]],"meta":{"matched_count":241,"returned_count":1,"truncated":true}}}
调用建议
- 不限制固定自然日跨度;数据量较大时按时间区间分批查询。
- 增量同步时记录本地最后一条
trade_time,下次从该时间之后开始请求。 - 同一时间范围与参数的重复请求不会产生新信息,应优先复用已保存结果。
- 如需多个周期,可按业务需要直接请求对应周期;不要将不同标的类型的代码混用到同一接口。