港股上市公司公告 API 接口

港股上市公司公告 API 接口

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

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

1. 产品功能

• 支持所有港股公告查询；
• 包含 10 年全量公告数据；
• 返回公告原始文件信息；
• 公告文件可直接下载；
• 超高的查询效率，百万级数据毫秒级返回；
• 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
• 全面兼容 Apple ATS；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡；

2. API 文档

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

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

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/stock/hk/bulletin?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&pageindex=1&pagesize=10&language=en&sortorder=desc

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

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

3. 请求参数

参数名	参数类型	是否必须	默认值	备注
appkey	string	是	YOUR_APPKEY	付费后获取的 APPKEY
symbol	string	是	YOUR_VALUE	港股股票代码，具体值参见 港股股票代码参数枚举页面。支持一次查询多个股票，使用逗号隔开，参数格式为：00004,00012
pageindex	int	是	1	分页参数，从 1 开始，默认为 1
pagesize	int	是	10	分页参数，每页返回数量，最大 20 条，默认为 10
language	string	否	en	公告语言，可选 en | zh，en 英文，zh 繁体中文
sortorder	string	否	desc	公告时间排序，可选 desc | asc，表示按照发布时间倒序或正序查询

4. 返回参数

参数名	参数类型	备注
DataStatus.StatusCode	int	接口返回状态码
DataStatus.StatusDescription	string	接口返回状态说明
DataStatus.ResponseDateTime	string	接口数据返回时间
DataStatus.DataTotalCount	int	此条件下的总数据量，一般用于分页计算
Data.Symbol	string	港股股票代码
Data.StockName	string	股票名称
Data.Title	string	公告标题
Data.ShortText	string	公告简介
Data.LongText	string	公告详情
Data.FileSize	string	公告文件大小
Data.FileType	string	公告文件类型
Data.FileLink	string	公告文件链接
Data.BulletinDateTime	string	公告时间
Data.UniqueId	string	公告内部唯一 ID，中英文版本保持一致的唯一 ID

5. 错误码说明

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

6. 适用场景

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

7. 相关接口

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