港股历史行情

公开接口

港股 HK Stock · 港股历史行情

查询港股历史 K 线。返回结构与 A 股历史行情一致。

接口地址

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

接口说明

查询港股历史 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否00700港股代码,如 00700
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/hk/stock/history?start_date=20250101&end_date=20261231" \
  -H "Authorization: Bearer $DATABULL_API_KEY"
Python
import requests

url = "https://api.databull.cn/hk/stock/history"
params = {
    "start_date": "20250101",
    "end_date": "20261231",
}
headers = {"Authorization": "Bearer YOUR_API_KEY"}

resp = requests.get(url, params=params, headers=headers, timeout=10)
resp.raise_for_status()
print(resp.json())

响应示例

JSON
[
  {
    "date": "2026-06-26",
    "timestamp": 1782403200000,
    "open": 512.0,
    "close": 519.5,
    "high": 522.0,
    "low": 510.5,
    "volume": 18350000.0,
    "change_amount": 7.5,
    "chg_pct": 1.4646,
    "amplitude": 2.2448
  }
]

错误码

状态码触发条件
400证券代码格式非法
404区间内无数据
403当前套餐不包含该市场数据,升级套餐后可用

说明

  • 支持 adj=back / adj=front 复权(默认 none 不复权),复权为服务端即时派生并同步重算涨跌额 / 涨跌幅 / 振幅,除权日不会出现断层式假涨跌幅。
  • 港股无涨跌停限制,amplitude 可能显著大于 A 股。
  • 该接口属于「港股」数据域,需付费套餐(专业版及以上)方可调用;免费版仅覆盖 A 股。