指数历史行情
公开接口指数行情 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年,格式YYYYMMDDend_date查询string否当日结束日期,默认当日,格式YYYYMMDD返回字段
字段类型说明
datestring交易日期,YYYY-MM-DDsymbolstring指数代码(裸码),如 000001open / 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(有该指数但区间没命中),便于区分「指数写错了」和「这段时间真没行情」。
Esc