§1概述
接口能力与数据说明
## 港股上市公司财务报表数据API 该接口提供港股上市公司利润表、资产负债表、现金流量表三大财务报表数据(含年报、中报),支持按股票代码、报告期、财务科目、日期范围等多条件查询。通过一个接口即可获取任意报表类型的财务指标。 ###  状态 覆盖港股全市场,持续维护更新。 ###  覆盖时间范围 回溯至港股股市最早的上市公司 ###  核心功能 - **三大报表合一**:利润表、资产负债表、现金流量表通过同一接口获取,无需切换。 - **多维度筛选**:支持按股票代码、报表类型、报告期、财务科目、日期范围灵活查询。 - **单股票历史全量**:按单只股票返回其全部历史报告期数据,便于时间序列分析。 - **科目级检索**:支持按具体财务科目名称(如“营业额”、“应收帐款”、“新增借款”)精确查询。 ###  适用场景 - 港股上市公司财务趋势分析(营收、利润、资产负债结构、现金流) - 量化选股中的财务因子构建(ROE、负债率、自由现金流等) - 财务预警与异常检测 - 跨市场(A股 vs 港股)财务数据对比 - 基本面投研数据库建设 ### 错误码说明 | 错误码 | 返回message | 含义 | | ---- | ---- | ---- | | 0 | success | 成功 | | 40001 | Missing valid token in request | 请求中缺少Token | | 40002 | Invalid token | Token无效 | | 50001 | Too Many Requests: API call frequency limit exceeded | 请求过多:超出 API 调用频率限制 | | 50002 | Unknown error | 未知错误 | ### 注意事项 - 当指定 period 时,返回该报告期的全部财务科目数据。 - 当指定 indicator_name 时,返回该科目在所有报告期的历史数据。 - 当指定 start_date 和 end_date 时,返回该时间段内所有报告期数据。 - 若同时指定多个条件,取交集。 - indicator_value 的单位与原始报表一致,通常为港元(HKD),不进行单位换算。不同科目值可能差异巨大,建议按需缩放。 - 报告期说明:港股年报通常以 1231 结尾(12月31日),中报以 0630 结尾(6月30日),部分公司可能采用非标准财年。 - 缺失数据处理:若某科目在特定报告期无数据,返回结果中不会出现该记录(不会返回0值或空值)。 ### 更新历史 | 版本 | 日期 | 变更说明 | | ---- | ---- | ---- | | v1.0.0 | 2026/4/22 | 初始版本发布 |
请求地址
GET https://apiopendata.com/api/hk-financials注册后可获取 API Key;如需更高调用配额、批量服务或专属支持,可联系销售顾问。
§2请求参数
调用接口所需的查询参数
§3数据字段
返回结果中的字段定义
§4代码示例
Python / R / Stata 调用示例
import requests
url = "https://api.cnopendata.com/v1/..."
headers = {"Authorization": "Bearer YOUR_API_KEY"}
params = {}
resp = requests.get(url, headers=headers, params=params)
data = resp.json()
print(data)§5开始使用
注册获取调用凭证,或联系销售获得机构级方案
