港股报价

接口简介

本接口提供港股市场指定股票的实时行情数据查询服务。通过传入股票代码（Symbol），可获取包括最新价、涨跌额、成交量、成交额、买卖盘口（Bid/Ask）、今日高低点及52周极值等核心金融指标。数据以 JSON 格式返回，支持单次请求批量查询多只股票，适用于需要高频或批量获取港股基础行情的业务场景。

适用场景

• 金融资讯应用：为APP或网站提供港股列表页的实时价格刷新功能。
• 量化交易辅助：作为策略系统的基础数据源，监控特定标的的价格波动与成交量变化。
• 投资组合管理：实时计算持仓市值，展示账户盈亏情况。
• 市场数据分析：收集历史分时数据前的实时快照，用于分析市场情绪与资金流向。

请求与返回说明

请求方式：POST 请求参数：

• symbol (必填, String)：港股代码，多个代码使用英文逗号分隔，例如 08026,02203。

返回结果：

• code：业务状态码，200 表示成功。
• data：包含各股票详情的对象集合，键名为股票代码。
• price：实时价格
• change / changeRate：涨跌额与涨跌率
• volume / value：成交量与成交额
• bid / ask：买一价与卖一价
• high / low：今日最高/最低价
• 52week_high / 52week_low：52周最高/最低价
• update_time：数据更新时间戳

接入建议

1. 批量查询优化：建议将同一批次需要更新的股票代码合并为一个请求，以减少网络开销和 API 调用次数。
2. 缓存策略：港股交易时段内数据变动频繁，非交易时段数据静止。建议根据 update_time 判断数据新鲜度，避免无效轮询。
3. 异常处理：请检查返回的 code 字段而非仅依赖 HTTP 状态码。若某只股票停牌或代码错误，对应键值可能为空或返回特定错误信息，需做好容错处理。
4. 时区注意：返回的时间戳通常为 Unix 时间戳，前端展示时需转换为用户本地时区或港股交易时区（HKT）。