遇到“返回空数据”时的焦急心情

对于刚开始学习 QMT 量化的新手来说，最郁闷的事情莫过于辛辛苦苦写好了策略代码，点击运行后却发现 get_market_data_ex 返回的是空列表，或者 K 线图上一片空白。很多人的第一反应是“我的代码写错了”或者“券商软件坏了”。其实，QMT 获取不到行情 90% 的原因都不在代码逻辑本身，而在软件配置和环境状态。

排查第一步：客户端登录与连接状态

QMT 是一个基于客户端的量化系统。如果你的客户端没有正常登录，或者与柜台服务器的连接中断，任何行情函数都会失效。

* 检查重点： 观察客户端左下角或顶部的状态灯。如果是红色或提示“未登录”，请重新输入资金账号登录。

* 权限确认： 确认你的账户是否已经开通了量化交易权限。部分券商虽然允许你下载软件，但如果不激活量化功能，行情源是不会下发的。

排查第二步：行情数据是否已补充下载

这是最常见的原因。QMT 默认不会自动下载所有历史 K 线数据。如果你在策略中调用 2020 年的数据，但你从未在本地下载过，系统就会返回空。

* 解决方法： 在 QMT 客户端的“数据管理”菜单中，找到“历史数据下载”。选择对应的品种（如沪深A股）、周期（日线或分钟线）以及时间范围，点击下载。

* 注意： 如果你使用的是 miniQMT (XtQuant)，则需要调用 download_history_data 函数先进行异步下载，等待数据落地后才能读取。

排查第三步：标的代码格式是否正确

QMT 对标的代码有严格的后缀要求。

* 上海证券： .SH 或 .XSHG（例如 600570.SH）

* 深圳证券： .SZ 或 .XSHE（例如 000001.SZ）

如果不带后缀或者后缀写错，函数将无法识别标的，直接返回空值。

排查第四步：回测与实盘模式的 subscribe 参数

在调用 get_market_data_ex 等函数时，有一个关键参数是 subscribe（订阅）。

* 回测模式： 通常建议设置 subscribe=False，因为回测使用的是本地已经下载好的静态数据。

* 实盘模式： 必须确保已经通过 subscribe_quote 成功订阅了该品种。如果没有订阅就直接获取实时行情，大概率会拿到空数据。

排查第五步：周期与字段匹配

如果你请求的是“分钟线”数据，但本地只有“日线”数据，也会导致返回空。另外，检查你请求的字段（如 close, open, volume）是否在当前品种的支持范围内。

总结与专业建议

排查 QMT 行情问题就像修电路，要从电源（登录）查到线路（数据下载），最后才看灯泡（代码）。如果你按照上述步骤操作后依然无法获取行情，或者遇到“数据解析失败”、“行情服务未授权”等报错，建议不要盲目修改代码。

联系客户经理可以帮您快速定位问题。我们可以从后台检查您的账户权限是否完整，行情源配置是否正确，甚至可以协助您进行软件环境的远程排查。如果您在量化入门阶段遇到任何工具使用的门槛，欢迎随时咨询，让我们帮您跨过技术障碍。

以上内容仅供投资者教育和软件功能理解参考，不构成投资建议，不构成收益承诺，也不构成避免损失的保证。量化工具、行情接口、数据下载、软件环境等功能，可能因系统、网络、行情、交易规则、参数设置、权限状态等因素影响而无法按预期执行，具体以实际账户权限、软件环境及系统记录为准。请结合自身情况审慎使用。