港股基础信息数据

symbol 是现有查询参数，留空返回可用全市场记录，不提供关键词或分页查询。三个数值字段保留数值类型；来源明确未披露的兼容占位 0 不代表真实零值。市盈率为来源动态口径，不是涨跌幅。主快照缓存 12 小时，备用最多 30 天，备用可能较旧；返回不代表盘中实时行情。
按单个港股代码查询基础资料。
留空代码获取来源可用的全市场资料。
保留代码前导零及既有代码归一化表达。
返回证券代码与名称，便于关联证券资料。
返回来源最新报价，便于证券资料页展示。
返回来源总市值，便于整理公司规模资料。
返回来源动态市盈率，便于估值资料展示。
保留合法负市盈率，避免将负值误写为缺失。
数值字段保持数值类型，便于应用进一步整理。
可用于证券列表与单股资料展示。
可将证券代码与已有行情、公告资料关联。
可在应用保存查询快照后对照资料变化。

当前接口契约

接口详情：https://www.gugudata.com/api/details/stockhkbasicinfo

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	使用已授权的 APPKEY，兼容现有有效鉴权位置。此鉴权位置可选；整体鉴权要求及其他已支持位置以本操作说明为准。
symbol	string	否	无，留空返回全市场	单个港股代码，保留现有补齐及有效前缀表达；留空返回可用全市场资料。

正常响应字段

字段	类型	说明
DataStatus.RequestParameter	string	实际、可读业务请求参数，不包含凭据。
DataStatus.StatusCode	integer	成功为 100；参数错误为 501；处理或依赖失败为 901。
DataStatus.StatusDescription	string	业务状态说明。
DataStatus.ResponseDateTime	string	接口返回时间。
DataStatus.DataTotalCount	integer	实际结果数量。
Data	array	数据结果。
Data[].Symbol	string	港股证券代码，保留前导零。
Data[].StockName	string	证券名称。
Data[].Latest	number	来源最新报价，报价币种以证券及来源资料为准；明确缺失时以 0 占位。
Data[].MarketValue	number	来源总市值，不是涨跌额；金额单位及币种按来源证券口径，明确缺失时以 0 占位。
Data[].PERatio	number	来源动态市盈率，允许合法负值；明确缺失时以 0 占位。

业务状态说明

业务状态码	业务状态码解释	备注
100	成功	HTTP 200
501	参数错误	HTTP 400
901	处理、依赖失败或超时	HTTP 503
502	请求频率限制	HTTP 429
503	权益过期	HTTP 403
504	凭据无效或无权限	HTTP 401
505	调用额度不足	HTTP 403

返回响应

🟢200成功

application/json

成功（业务码 100）。

Bodyapplication/json

示例

{"DataStatus":{"RequestParameter":"symbol=09898","StatusCode":100,"StatusDescription":"请求成功","ResponseDateTime":"2026-10-23 15:06:19.203","DataTotalCount":1},"Data":[{"Symbol":"09898","StockName":"微博-SW","Latest":49.08,"MarketValue":12057609834,"PERatio":4.88}]}

🟠400参数错误（业务码 501）。

🔴503处理、依赖失败或超时（业务码 901）。

🟠429请求频率限制（业务码 502）。

🟠403权益过期（业务码 503）；调用额度不足（业务码 505）。

🟠401凭据无效或无权限（业务码 504）。

当前接口契约#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应字段

业务状态说明