ETF 历史行情

公开接口

ETF 基金 · ETF 历史行情

查询 A 股 ETF 历史 K 线,日线取自本地行情库,其它周期按需实时取数;参数与返回结构同A 股历史行情。

接口地址

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

接口说明

查询 A 股 ETF 历史 K 线,日线取自本地行情库,其它周期按需实时取数。

返回体为记录数组(非信封结构),每条含 date、timestamp、open、close、high、low、volume、change_amount、chg_pct、amplitude,按日期升序。支持 adj 参数选择复权方式(none / back / front);除权日前后 back/front 价已平滑,不会出现因拆分红导致的断层式假涨跌幅。

代码格式非法返回 400,区间内无数据返回 404。

请求参数

参数位置类型必填默认说明
start_date查询string否近 1 年起始日期,格式 YYYYMMDD;不传或留空时默认近 1 年
end_date查询string否当日结束日期,格式 YYYYMMDD;不传或留空时默认当日
symbol查询string否510300ETF 代码(裸码,不带交易所后缀),如 510300
period查询string否dK 线周期;不传或留空时默认 d(日线),其它周期按需实时取数
adj查询string否none复权方式;不传或留空时默认 none(不复权,直接返回库内原始日线)。back 后复权:锚定上市首日,序列稳定不变,推荐用于回测与长期比较;front 前复权:锚定最新交易日,与行情软件显示一致,但历史数值会随每日最新价漂移。

返回字段

字段类型说明
datestring交易日期,YYYY-MM-DD
timestampnumber该交易日的毫秒级 Unix 时间戳(北京时间 00:00 起算)
opennumber开盘价
closenumber收盘价
highnumber最高价
lownumber最低价
volumenumber成交量
change_amountnumber涨跌额
chg_pctnumber涨跌幅(%)
amplitudenumber振幅(%)

接口示例

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

client = DataBull(api_key="YOUR_API_KEY")
result = client.get_etf_history(symbol="510300", start_date="20260101", end_date="20260630", adj="back")
print(result)

响应示例

JSON
[
  {
    "date": "2026-06-26",
    "timestamp": 1782403200000,
    "open": 4.112,
    "close": 4.123,
    "high": 4.135,
    "low": 4.098,
    "volume": 528130000.0,
    "change_amount": 0.011,
    "chg_pct": 0.2674,
    "amplitude": 0.9001
  }
]

错误码

状态码触发条件
400证券代码格式非法
404区间内无数据

说明

  • 默认 adj=none 为未复权收盘口径;支持 adj=back(后复权)/ adj=front(前复权),复权为服务端即时派生并同步重算涨跌额 / 涨跌幅 / 振幅,除权日不会出现断层式假涨跌幅(口径同A 股历史行情)。
  • start_date / end_date 不传或传空串时按近一年 / 当日补齐。
  • 该接口未开启结果缓存,每次请求均回源。