API REFERENCE

股票分钟线

查询历史分钟 K 线

分钟线按标的类别拆分为股票、ETF、交易所指数与申万指数四类独立接口。每个接口均支持 1min、5min、15min、30min、60min。

时间规范：推荐使用北京时间 YYYY-MM-DD HH:MM:SS。日期格式 YYYYMMDD 也可使用：起始日期默认从 09:30:00 开始，结束日期默认至 15:00:00。返回数据按 trade_time 从早到晚排列。

股票分钟 K 线

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

请求示例

curl -X POST 'https://jinniu.ziyoutang.com/api/stk_mins' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"ts_code":"000001.SZ","freq":"1min","start_date":"2026-08-20 09:30:00","end_date":"2026-08-20 09:31:00","limit":2}'

请求字段

字段必填说明
api_key是个人中心生成的 API Key，也可使用请求头 X-Api-Key。
ts_code是单只股票代码，带交易所后缀，例如 000001.SZ。
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 线二维数组，每一行按 fields 的顺序排列。
data.meta.matched_count请求时间范围内匹配的总行数，单位：条。
data.meta.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": [["000001.SZ", "2026-08-05 09:35:00", 12.31, 12.34, 12.36, 12.28, 1234500, 15234000.0]], "meta": {"matched_count": 240, "returned_count": 1, "truncated": true}}
}

调用建议

  • 不限制固定自然日跨度；数据量较大时按时间区间分批查询。
  • 增量同步时记录本地最后一条 trade_time，下次从该时间之后开始请求。
  • 同一时间范围与参数的重复请求不会产生新信息，应优先复用已保存结果。
  • 如需多个周期，可按业务需要直接请求对应周期；不要将不同标的类型的代码混用到同一接口。