API 服务架构升级说明：请更新至文档最新请求地址

尊敬的用户，您好：

为进一步提升数据服务的稳定性、高峰时段响应能力，并保障长周期历史与专题类数据的完整供给，麦蕊智数近期完成了 API 服务架构升级：实时/近端数据与历史全量、列表及专题数据采用分层部署。与此同步，官网 API 文档已更新各接口的正式请求地址。

请您在方便时核对现有集成，以文档最新「API 地址」为准更新程序中的域名配置。

一、升级背景（您需要了解什么）

• 职责分离：盘中高频实时查询与盘后/长周期历史查询分流，避免相互抢占资源，降低高峰延迟与偶发超时。
• 数据完整性：历史 K 线、财务报表、专题数据等由专用数据节点提供，更适合全量、长区间查询。
• 文档对齐：每个接口在文档中标注唯一推荐域名，便于集成与排障，减少因域名混用导致的异常。

二、两个域名的分工（请按文档选用）

域名	适用场景	典型接口
api.mairuiapi.com	盘中实时、最新行情、单股/指数常规调用	单股实时 /hsrl/ssjy/{code}/、最新 K 线 /hsstock/latest/、交易时段历史 K 线等
a.mairuiapi.com	历史全量、列表类、财务报表、专题及批量类数据	历史 K 线（非交易时段亦建议用此域名）、列表/股池、财务/指标、批量实时等

路径、licence 鉴权及查询参数（如 st、et、lt）均不变，通常仅需调整主机名。文档中若单独列出「历史数据 URL」，长周期查询请优先使用该地址。

三、强烈建议改用 a.mairuiapi.com 的接口（文档已标注）

以下类型接口在文档中的正式地址为 a.mairuiapi.com。若程序仍固定访问 api.mairuiapi.com，可能无法正常返回数据，请尽快按文档更新：

• 批量/全市场实时：/hsrl/ssjy_more/、/hsrl/ssjy/all/、/hsrl/real/all/
• 特色行情：涨跌停表现 /hsstock/lup/limit/、集合竞价表现 /hsstock/lup/auction/
• 专题数据：问董秘 /hsstock/interactiveqa/、交易所公告 /hsstock/announcement/、订单流 /hsstock/orderflow/
• 京市 A 股财务报表：/bj/financial/{表类型}/{code}/（资产负债表、利润表、现金流量表等）
• 历史与列表类（文档 api_url 已改 a 域名者）：如股票/指数列表、财务与指标历史、部分历史技术指标等，请以文档为准

四、仍可使用 api.mairuiapi.com 的接口

以下场景无需变更，继续按原方式调用即可：

• 单只股票/指数实时行情、五档、latest 最新 K 线
• 交易时段内的历史 K 线（沪深/指数/京市，路径与参数不变）
• 涨跌股池（涨停/跌停/强势/次新/炸板等，交易时段）
• 文档「API 地址」仍标注为 api.mairuiapi.com 且未提供「历史数据 URL」的接口

说明：部分历史类接口在非交易时段，主站可能引导至历史节点；为减少跳转与便于运维，仍建议直接使用文档中的 a 域名。

五、建议您完成的技术处理（Checklist）

1. 对照文档：打开 沪深基础数据 API 文档，逐条核对业务所用接口的「API 地址」与「历史数据 URL」（如有）。
2. 更新配置：将代码、脚本、定时任务中的域名常量或环境变量改为文档标明的域名；避免全项目写死单一域名。
3. 优先 HTTPS：生产环境建议使用 https://api.mairuiapi.com 与 https://a.mairuiapi.com。
4. 回归测试：对关键接口做联调，确认状态码为 200 且数据结构未变；若返回「接口已停用 / 请使用 a 域名」类提示，说明域名需调整。
5. HTTP 客户端：若使用自定义重定向逻辑，请以文档指定域名为最终请求目标，勿依赖临时跳转。

六、常见问题

Q：只改域名，路径和 licence 要改吗？
A：一般不需要。与文档示例保持一致即可。

Q：历史 K 线用 api 还是 a？
A：短区间、盘中补数可用 api；长周期、全量、盘后批量建议用文档中的 a.mairuiapi.com 或「历史数据 URL」。

Q：如何确认文档是否最新？
A：以官网文档页实时展示为准；集成时建议定期（如每季度）核对一次域名配置。

七、联系我们

升级过程中如有集成疑问、批量迁移需要协助，欢迎通过官网客服或工单联系我们，并提供：接口路径、当前使用的域名、返回状态码或错误信息。

感谢您对麦蕊智数的理解与支持！

麦蕊智数 MyData 团队
2026 年 6 月