指数历史行情

公开接口

指数行情 Index · 指数历史行情

查询指定指数的历史日线数据,覆盖上证综指(000001)、深证成指(399001)、沪深 300(000300)、创业板指(399006)等核心宽基与板块指数。数据取自本地指数日线库,按交易日升序返回。index_code 用裸 6 位代码、不带交易所后缀。

接口地址

GET /cn/index/history
完整地址:https://api.databull.cn/cn/index/history

接口说明

查询指定指数的历史日线数据,按日期升序返回。

index_code 为**裸 6 位代码、不带交易所后缀**(如 000001 上证综指、000300 沪深 300)。传带后缀的 000001.SH 虽不报错但查不到数据,服务端会自动剥离后缀兼容。

返回体为记录数组(非信封结构),每条含 date、open、close、high、low、volume 等字段;区间内无数据时返回空数组 [],并在响应头 X-Empty-Reason 给出原因:index_not_found(库中根本没有该指数)或 no_data_in_range(有该指数但区间没命中)。

请求参数

参数位置类型必填默认说明
index_code查询string否000001指数代码(裸码,不带交易所后缀),如 000001(上证综指)、000300(沪深 300)
start_date查询string否近 1 年起始日期,默认近1年,格式YYYYMMDD
end_date查询string否当日结束日期,默认当日,格式YYYYMMDD

返回字段

字段类型说明
datestring交易日期,YYYY-MM-DD
symbolstring指数代码(裸码),如 000001
open / close / high / lownumber开盘价 / 收盘价 / 最高价 / 最低价
volumenumber成交量
turnovernumber成交额
rfa_amountnumber复权成交额
chg_pctnumber涨跌幅(%)
amplitudenumber振幅(%)
turnover_ratenumber换手率(%)
id / marketnumber / string内部字段:主键与数据来源市场,可直接忽略

接口示例

cURL
curl "https://api.databull.cn/cn/index/history?index_code=000001&start_date=20250101" \
  -H "Authorization: Bearer $DATABULL_API_KEY"
Python
from databull import DataBull

client = DataBull(api_key="YOUR_API_KEY")
result = client.get_index_history(index_code="000001", start_date="20260101", end_date="20260630")
print(result)

响应示例

JSON
[
  {
    "id": 1,
    "symbol": "000001",
    "open": 3120.45,
    "close": 3145.82,
    "high": 3152.1,
    "low": 3115.3,
    "amplitude": 1.18,
    "chg_pct": 0.81,
    "rfa_amount": 412300000000.0,
    "turnover_rate": 0.72,
    "turnover": 398200000000.0,
    "volume": 342100000.0,
    "date": "2026-06-26",
    "market": "cn"
  }
]

错误码

状态码触发条件
400日期格式错误、起始日期晚于结束日期,或指数代码为空
500服务端查询异常

说明

  • index_code 是裸 6 位代码(如 000001),不要带 .SH / .SZ 后缀。传 000001.SH 不会报错,但查不到数据(返回空数组);为兼容历史调用方,服务端会自动剥离后缀。
  • 日期参数必须为 YYYYMMDD,传 2026-09-01 会返回 400。
  • 区间内无数据时返回空数组 [],而不是 404。空结果会在响应头 X-Empty-Reason 标明原因:index_not_found(库中无该指数)或 no_data_in_range(有该指数但区间没命中),便于区分「指数写错了」和「这段时间真没行情」。