| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| appkey | string | 否 | 无 | 有效 APPKEY,无默认值;支持 Query、Header、Bearer,多处凭据须一致。 AppKey 整体必填;在本操作已声明支持的鉴权位置任选一个提供,本位置无需重复填写。多处填写时须一致。 |
| symbol | string | 否 | 无 | 无默认值,留空分页查询全市场;数字代码补齐 5 位,兼容 HK、HKG 和 .HK。 |
| pageIndex | integer | 否 | 1 | 页码,从 1 开始,最大 2147483647。 |
| pageSize | integer | 否 | 20 | 每页 1–100 条,默认 20。 |
| 字段 | 类型 | 说明 |
|---|---|---|
| DataStatus.RequestParameter | string | 本次真实归一化 symbol、pageIndex、pageSize 参数,不包含鉴权凭据。 |
| DataStatus.StatusCode | integer | 业务状态码:100 成功、101 参数错误、110 数据服务暂时不可用。 |
| DataStatus.StatusDescription | string | 业务状态说明。 |
| DataStatus.ResponseDateTime | string | 服务端生成响应的北京时间。 |
| DataStatus.DataTotalCount | integer | 筛选后的记录总数,不是当前页数量;未知代码与越界页可返回空数组。 |
| Data.Symbol | string | 5 位港股代码,保留前导零。 |
| Data.StockName | string | 股票简称。 |
| Data.Latest | number|null | 可用行情价格,单位港元;不承诺实时行情。 |
| Data.PBRatio | number|null | 可用市净率,允许真实负数;未取得时为 null。 |
| Data.Currency | string | 价格和市值币种为 HKD。 |
| Data.IssuedShares | integer | 来源提供的已发行总股数;不与法定股本互相代填。 |
| Data.IssuedHShares | int64|null | 来源提供的港股上市股数,单位为股;A+H 公司对应香港上市 H 股,其他公司不因此成为法律意义上的 H 股;缺失为 null。 |
| Data.AuthorizedShares | int64|null | 来源披露的法定股数;未披露时为 null,不用已发行股本代填。 |
| Data.LotSize | int64|null | 每手股数,未取得时为 null。 |
| Data.TotalMarketValue | number|null | 可用总市值,单位港元;未取得时为 null。 |
| Data.HKMarketValue | number|null | 可用港股市值,单位港元;未取得时为 null。 |
| Data.ReportDate | string | 来源财务资料的报告期,yyyy-MM-dd;不保证所有股数及行情均截至该日。 |
| Data.RetrievedAt | string | 股本快照获取时间,yyyy-MM-dd HH:mm:ss;不是行情时间。 |
| 业务状态码 | 业务状态码解释 | 备注 |
|---|---|---|
| 100 | 正常返回 | 无数据时 Data 为空数组 |
| 101 | 参数错误 | 请检查股票代码和分页参数 |
| 102 | 请求频率受限 | 请按套餐 QPS 控制请求频率 |
| 103 | 账号欠费 | |
| 104 | APPKEY 错误 | 请检查 APPKEY 及接口购买状态 |
| 110 | 数据服务暂时不可用 | 请稍后重试 |