港股历史行情数据 API 接口

港股历史行情数据 API 接口

接口详情官网地址: https://www.gugudata.com/api/details/stockhk

港股历史行情数据 API 所有港股历史交易行情数据，股票、港股、历史数据等关键词场景常会用到，适合用于证券行情与财报数据查询、投研分析与策略开发与监控告警与交易前筛选等业务场景，方便开发者直接在应用、脚本或数据流程中接入。

1. 产品功能

• 支持所有历史港股交易查询；
• 每日定时更新数据；
• 支持指定任意时间段查询；
• 超高的查询效率，千万级数据秒级返回；
• 支持查询所有交易数据的未复权、前复权、后复权数据；
• 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
• 全面兼容 Apple ATS；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡；

2. API 文档

接口地址: https://api.gugudata.com/stock/hk

返回格式: application/json; charset=utf-8

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/stock/hk?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&begindate=YOUR_VALUE&enddate=YOUR_VALUE&adjust=YOUR_VALUE

数据预览: https://www.gugudata.com/preview/stockhk

接口测试: https://api.gugudata.com/stock/hk/demo

3. 请求参数

参数名	参数类型	是否必须	默认值	备注
appkey	string	是	YOUR_APPKEY	付费后获取的 APPKEY
symbol	string	是	YOUR_VALUE	港股股票代码，具体值参见 港股股票代码参数枚举页面。支持一次查询多个股票，使用逗号隔开，参数格式为：00004,00012
begindate	string	是	YOUR_VALUE	股票交易开始时间，格式为 20200101
enddate	string	是	YOUR_VALUE	股票交易结束时间，格式为 20200101，与开始时间最大时间跨度支持 366 个自然日，获取全量数据请分批获取，数据量较大，请保持合理的请求频率
adjust	string	否	YOUR_VALUE	是否返回前复权、后复权数据。如果传递参数值为 pre，那么返回前复权数据（所有数据进行了前复权）；如果传递参数值为 after，那么返回后复权数据；默认值为空或不传递，返回未复权数据

4. 返回参数

参数名	参数类型	备注
DataStatus.StatusCode	int	接口返回状态码
DataStatus.StatusDescription	string	接口返回状态说明
DataStatus.ResponseDateTime	string	接口数据返回时间
DataStatus.DataTotalCount	int	此条件下的总数据量，一般用于分页计算
Data.Symbol	string	港股股票代码
Data.TimeKey	int	交易日期，格式为 20210101
Data.Open	double	开盘价，单位: 港元
Data.Close	double	收盘价，单位: 港元
Data.High	double	最高，单位: 港元
Data.Low	double	最低，单位: 港元
Data.TradingVolume	int	成交量，单位：股
Data.TradingAmount	double	成交额，单位：港元
Data.Swing	double	振幅，单位：%
Data.ChangePercent	double	涨跌幅，单位：%
Data.ChangeAmount	double	涨跌额，单位：港元
Data.TurnoverRate	double	换手率，单位：%

5. 错误码说明

状态码	错误说明	备注
100	正常返回	-
101	参数错误	-
102	请求频率受限	每秒请求不能超过 100 次
103	账号欠费	-
104	APPKEY 错误	请检查传递的 APPKEY 是否为开发者中心获取到的值
110	接口响应错误	-

6. 适用场景

• 适合用于证券行情与财报数据查询，快速补齐产品侧需要的 港股历史行情数据 数据能力。
• 适合用于投研分析与策略开发，减少手工整理、清洗与重复开发成本。
• 适合用于监控告警与交易前筛选，将接口结果直接接入后台系统、数据任务或内容处理流程。

7. 相关接口

• 前置接口：查询港股股票代码列表数据，支持分页查询（GET），包含股票编码、股票名称、股票中文名称。