历史行情数据接口文档 - 金牛投研助手

快速开始

在个人中心创建 API Key。请求时优先将 Key 放入 X-Api-Key 请求头，不要把 Key 写进浏览器前端、公开仓库或截图。

基础地址：https://jinniu.lingxideai.com。日期使用 YYYYMMDD，例如 20260805。

查询历史日线

POSThttps://jinniu.lingxideai.com/api/daily-data

curl -X POST 'https://jinniu.lingxideai.com/api/daily-data' \\
  -H 'Content-Type: application/json' \\
  -H 'X-Api-Key: YOUR_API_KEY' \\
  -d '{
    "code": "000001.SZ",
    "start_date": "20260101",
    "end_date": "20260805",
    "adjustment": "qfq",
    "limit": 250
  }'

请求参数

参数	必填	说明
code	是	证券代码，带交易所后缀，例如 `000001.SZ`、`600519.SH`。
start_date	否	起始交易日，未填写时按返回条数向前读取。
end_date	否	结束交易日，未填写时读取当前数据版本的最新交易日。
adjustment	否	`none` 不复权，`qfq` 前复权，`hfq` 后复权；默认 `none`。
limit	否	返回条数，范围 1 至 6000；不填写时最多返回 6000 条。

日线接口每次调用最多返回 6000 条记录；数据量较大时请按日期区间分批查询。

返回结构与字段

{
  "success": true,
  "message": "",
  "data": {
    "code": "000001.SZ",
    "adjustment": "qfq",
    "count": 2,
    "daily_bars": [
      {
        "code": "000001.SZ", "date": "20260804",
        "open": 12.31, "high": 12.48, "low": 12.20, "close": 12.42,
        "previous_close": 12.28, "price_change": 0.14, "change_percent": 1.14,
        "volume": 1234567, "turnover": 1523400000, "adjustment_factor": 1.0
      }
    ]
  }
}

字段	含义
code	证券代码，带交易所后缀。
date	交易日期，格式为 `YYYYMMDD`。
open / high / low / close	开盘、最高、最低、收盘价格，单位：元/股。
previous_close	前一交易日收盘价，单位：元/股。
price_change	涨跌额，单位：元/股，未复权口径。
change_percent	涨跌幅，单位：百分比（%），未复权口径。
volume	成交量，单位：手（1 手 = 100 股）。
turnover	成交额，单位：千元人民币。
adjustment_factor	复权因子，无单位；选择前复权或后复权时，价格已按对应口径处理。

查询历史分钟 K 线

分钟线接口支持 1min、5min、15min、30min 和 60min。数据量较大时，请按时间区间分批查询。

POSThttps://jinniu.lingxideai.com/api/minute-data

curl -X POST 'https://jinniu.lingxideai.com/api/minute-data' \\
  -H 'Content-Type: application/json' \\
  -H 'X-Api-Key: YOUR_API_KEY' \\
  -d '{
    "code": "000001.SZ",
    "frequency": "5min",
    "start_time": "20260805",
    "end_time": "20260805",
    "limit": 1000
  }'

参数	必填	说明
code	是	证券代码，带交易所后缀，例如 `000001.SZ`。
frequency	是	周期仅支持 `1min`、`5min`、`15min`、`30min`、`60min`。
start_time	是	起始时间，支持 `YYYYMMDD`、`YYYYMMDDHHMMSS` 或 ISO 时间。
end_time	是	结束时间，格式同 `start_time`。
limit	否	返回条数，范围 1 至 8000；不填写时最多返回 8000 条。

单次最多返回 8000 条分钟 K 线，不限制固定自然日跨度；数据量较大时请按时间区间分批查询。

减少调用次数

尽量扩大单次查询的时间区间，并将 limit 设置为接近实际需要的条数，避免按天重复请求。
增量更新时记录本地最后一条数据时间，下次只查询该时间之后的数据。
相同参数不要重复调用；已获取的数据应保存在本地并优先读取本地结果。
同时需要多个周期时，可只获取 1min 数据，再在本地聚合生成 5min、15min、30min 和 60min。

返回示例

{
  "success": true,
  "message": "",
  "data": {
    "code": "000001.SZ",
    "frequency": "5min",
    "count": 1,
    "minute_bars": [
      {"code":"000001.SZ","frequency":"5min","time":"2026-08-05 09:35:00","open":12.31,"high":12.36,"low":12.28,"close":12.34,"volume":12345,"turnover":152340.0}
    ]
  }
}

time 为北京时间；open / high / low / close 单位为元/股；volume 为成交量（手）；turnover 为成交额（千元人民币）。

查看可用周期

GEThttps://jinniu.lingxideai.com/api/minute-data/status

请在请求头中传入 X-Api-Key。响应会返回支持的分钟周期和单次最大返回条数。

调用限制与错误码

接口仅提供历史行情数据，不提供盘中实时行情。
每个账户限制为每分钟 400 次、每日 100,000 次；日线与分钟线共享限额。账户到期、权限关闭或超限时，接口会拒绝请求。
日线单次最多返回6000条，分钟线单次最多返回8000条；删除或重新生成 API Key 不会重置账户调用次数。
分钟线不限制固定自然日跨度；超过单次返回量时请按时间范围分批查询。
请妥善保管 API Key。发现泄露时，在个人中心轮换 Key，旧 Key 会立即失效。
数据仅限研究、学习和个人使用，使用者应自行核验并遵守适用的法律、平台与数据使用规则。

错误码

400 参数错误，401 API Key 无效或已删除，403 账户期限或数据权限不满足，429 请求超过限额，503 行情数据暂不可用。错误响应包含 code、message 和 data 字段。

请求频率超限时，HTTP 429 响应头会返回 Retry-After；响应体的 data 会提供 limit_type、retry_after_seconds 和 reset_at，客户端应等待后再重试。