QMT 接口变更记录 - QuantX 文档

本页面记录 QMT 内置 Python 接口的版本变更历史，包括新增接口、参数变更、行为变更和废弃接口。所有版本号和变更内容均以当前客户端版本为准，用户应在使用前核验所使用的客户端版本对应的接口行为。

说明

本变更记录涵盖 QMT 内置 Python 的以下接口类别：

接口类别	包含内容
行情数据接口	`get_market_data_ex`、`get_history_data`、`get_full_tick`、`subscribe_quote` 等
交易接口	`passorder`、`order_volume`、`order_value`、`order_target` 等
委托查询接口	`get_trade_detail_data`、`get_orders` 等
回调接口	`init`、`handlebar`、`order_callback`、`deal_callback` 等
账户与持仓接口	`get_account`、`get_position`、`get_positions` 等

提示

以下变更记录为示例性记录，具体的版本号、变更内容和生效时间以当前客户端版本为准。建议在客户端更新后查阅服务机构发布的官方更新说明，确认接口变更对本策略的影响。

变更类型说明

变更类型	标识	说明
新增	`added`	新增的接口或参数
修改	`modified`	已有接口的参数或行为发生变更
废弃	`deprecated`	接口或参数已废弃，建议使用替代方案
修复	`fixed`	修复了已知问题

变更记录

行情数据接口变更

版本	变更类型	接口/参数	说明
以当前客户端版本为准	added	`get_market_data_ex`	新增多品种、多字段市场数据获取接口，返回字典格式的 DataFrame 数据，替代部分 `get_market_data` 的使用场景
以当前客户端版本为准	added	`get_full_tick`	新增获取完整 Tick 数据接口，返回包含最新价、买卖盘等字段的字典
以当前客户端版本为准	added	`subscribe_quote`	新增实时行情订阅接口，支持通过回调函数处理实时行情数据
以当前客户端版本为准	modified	`get_history_data`	参数 `count` 的最小值从 1 调整为支持 0（返回空列表），建议获取后检查返回值长度
以当前客户端版本为准	modified	`get_market_data_ex`	`start_time` 和 `end_time` 参数支持负整数（表示相对 Bar 偏移），具体偏移语义以当前客户端版本为准
以当前客户端版本为准	modified	`get_full_tick`	返回字典中的字段名可能因行情权限等级不同而有所差异，Level-2 权限下包含十档买卖盘数据

交易接口变更

版本	变更类型	接口/参数	说明
以当前客户端版本为准	added	`passorder`	新增 `quickTrade` 参数（第 9 个参数），支持同步/异步下单模式：0=不启用快速交易，1=异步快速，2=同步等待
以当前客户端版本为准	added	`passorder`	新增 `userOrderId` 参数（第 10 个参数），支持用户自定义委托号用于跟踪
以当前客户端版本为准	modified	`passorder`	`prType` 参数的行为在不同版本中可能略有差异，使用前请核验当前版本的价格类型定义
以当前客户端版本为准	modified	`order_volume`	`priceType` 参数新增对更多价格类型的支持，具体可用值以当前客户端版本为准
以当前客户端版本为准	added	`order_target`	新增按目标数量下单接口，自动计算差额
以当前客户端版本为准	added	`order_target_value`	新增按目标金额下单接口

回调接口变更

版本	变更类型	接口/参数	说明
以当前客户端版本为准	modified	`handlebar`	在回测模式下，所有历史 K 线都会触发 `handlebar`；在模拟信号和真实交易模式下，仅最新 K 线触发
以当前客户端版本为准	modified	`order_callback`	`order_info` 对象新增 `m_nTradedVolume` 和 `m_dTradedAmount` 字段，用于获取已成交数量和金额
以当前客户端版本为准	modified	`deal_callback`	`deal_info` 对象新增 `m_strOrderSysID` 字段，用于关联委托编号
以当前客户端版本为准	added	`order_callback`	`order_info` 对象新增 `m_strErrorInfo` 字段，委托被拒绝时包含错误信息

委托查询接口变更

版本	变更类型	接口/参数	说明
以当前客户端版本为准	modified	`get_trade_detail_data`	返回的委托对象支持通过属性访问字段（如 `order.m_strOrderID`），部分版本同时支持字典访问
以当前客户端版本为准	modified	`get_trade_detail_data`	委托状态码的终态定义可能因版本不同而有所差异，废单等特殊状态码以当前客户端版本为准
以当前客户端版本为准	added	`get_trade_detail_data`	新增 `'DEAL'` 数据类型查询，可查询当日成交记录

账户与持仓接口变更

版本	变更类型	接口/参数	说明
以当前客户端版本为准	modified	`get_account`	账户对象新增 `m_dProfit` 字段（当日盈亏），部分版本可能使用不同字段名
以当前客户端版本为准	modified	`get_position`	持仓对象新增 `m_dMarketValue` 字段（持仓市值），具体可用字段以当前客户端版本为准
以当前客户端版本为准	added	`get_positions`	新增批量获取所有持仓的接口，返回持仓字典

废弃接口说明

以下接口或参数已废弃，建议使用替代方案。废弃接口可能在后续版本中移除，请及时迁移。

废弃接口/参数	替代方案	废弃说明
`get_market_data`（部分用法）	`get_market_data_ex`	多品种、多字段场景建议使用 `get_market_data_ex`，返回 DataFrame 格式更便于处理
`ContextInfo.get_close_price()`（部分场景）	`get_market_data_ex(['close'], ...)`	批量获取收盘价时建议使用 `get_market_data_ex`，效率更高
旧版委托状态码常量	数字状态码	直接使用数字状态码（如 57、58、59），避免依赖可能变更的常量名

注意

使用废弃接口的策略可能在客户端更新后出现兼容性问题。建议定期检查本变更记录，及时迁移至推荐接口。废弃接口的具体移除时间以当前客户端版本为准。

已知问题

数据获取相关

问题描述	影响范围	临时解决方案
`get_market_data_ex` 在数据未下载时返回空字典	所有环境	调用前确保品种历史数据已下载，或在 `init` 中调用 `do_download_history_data`
`get_history_data` 返回的数据长度可能小于请求的 `count`	所有环境	获取后检查返回值长度，不足时跳过当前 Bar
`get_full_tick` 在非交易时间段返回 None	模拟信号、仿真交易、真实交易	检查返回值是否为 None，非交易时间段不做处理

交易相关

问题描述	影响范围	临时解决方案
`passorder` 的返回值与 `order_callback` 中的委托号可能不同步	仿真交易、真实交易	以 `order_callback` 中的委托号为准，同时通过 `get_trade_detail_data` 查询作为兜底
`get_trade_detail_data` 查询的是当日记录，跨日委托可能查不到	仿真交易、真实交易	跨日策略应在本地记录委托号和状态，不完全依赖查询接口
`order_callback` 在网络异常时可能不触发或延迟触发	仿真交易、真实交易	在 `handlebar` 中通过 `get_trade_detail_data` 主动查询委托状态作为补充

回调相关

问题描述	影响范围	临时解决方案
`handlebar` 在回测模式下的触发频率可能与模拟信号模式不同	回测环境	回测和模拟信号结果差异属正常现象，以模拟信号模式的表现为准
回调函数中的异常可能导致策略中断	所有环境	在回调函数中添加 `try-except` 块，捕获并记录异常

提示

以上已知问题的具体表现和影响程度可能因客户端版本不同而异，以当前客户端版本为准。如遇到未记录的问题，建议咨询服务机构获取技术支持。

版本核验建议

更新前核验：客户端更新前，查阅服务机构发布的更新说明，了解接口变更内容。
更新后测试：客户端更新后，在学习环境中运行策略，确认接口行为无变化。
仿真验证：如接口变更涉及交易相关接口，在仿真交易环境中重新验证委托和成交流程。
记录版本：记录当前使用的客户端版本号和核验日期，便于后续追溯。

客户端版本：以当前客户端版本为准
核验日期：2026-08-04
核验结果：[待填写]