一、接口介绍
迅投QMT提供两个用于策略配置存储的函数:
write_config():写入策略配置。
read_config():读取策略配置。
- 据迅投官方说明,python3.6和python3.12都支持,但是需要QMT客户端版本是2.1.37以上才可以。
根据接口文档,配置内容会加密保存至终端本地配置库,支持两种Python调用方式:
- QMT内置Python:直接调用函数。
- 原生Python:通过
qmt_api 模块调用。
两种方式读写同一份配置数据。
这两个接口可用于保存策略参数、运行标记及少量需要跨启动恢复的状态信息,不需要自行调用Python文件读写函数。
下面介绍两个接口的使用方法,并结合实际测试说明其行为。

二、write_config:写入策略配置
2.1 函数说明
函数签名:
write_config(path, content)
参数说明:
| 参数 |
类型 |
说明 |
| path |
str |
配置键,用于标识一条配置 |
| content |
str |
需要保存的配置内容 |
虽然接口参数名称为 path,但它并不要求传入Windows文件路径。可以直接使用简单的字符串作为配置键。
例如:
write_config('test_key', 'hello')
表示将字符串 hello 保存到名为 test_key 的配置项中。
返回值:
| 返回值 |
含义 |
| 0 |
写入成功 |
| 1 |
存储失败 |
| -1 |
参数错误或打开配置库失败 |
2.2 QMT内置Python调用示例
#coding:gbk
def init(C):
key = 'test_key'
content = 'hello_qmt'
ret = write_config(key, content)
print('写入返回值:', ret)
if ret == 0:
print('配置写入成功')
else:
print('配置写入失败')
def handlebar(C):
pass
2.3 原生Python调用示例
原生Python需要从 qmt_api 导入:
#coding:gbk
from qmt_api import write_config
ret = write_config('test_key', 'hello_qmt')
print('写入返回值:', ret)
实测正常写入返回 0。
三、read_config:读取策略配置
3.1 函数说明
函数签名:
read_config(path)
参数说明:
| 参数 |
类型 |
说明 |
| path |
str |
配置键,与写入时使用的键一致 |
返回值:
| 返回值 |
含义 |
| str |
读取到的配置内容 |
| None |
配置键不存在或读取失败 |
3.2 QMT内置Python调用示例
#coding:gbk
def init(C):
value = read_config('test_key')
if value is None:
print('配置不存在或读取失败')
else:
print('读取配置:', value)
def handlebar(C):
pass
3.3 原生Python调用示例
#coding:gbk
from qmt_api import read_config
value = read_config('test_key')
print('读取结果:', repr(value))
需要区分:
- 读取到
'':表示配置内容为空字符串。
- 返回
None:表示配置不存在或读取失败。
建议使用 value is None 判断。
四、接口实测结果
4.1 基础读写测试
测试日期:2026年11月18日。
本次进行了25项专项测试,其中17项通过、7项参数异常检查需要进一步结合文档解释,另有1项持久性观察。
| 测试内容 |
实测结果 |
| 普通字符串 |
通过 |
| 数字字符串 |
通过 |
| 中文字符串 |
通过 |
| 多行文本、制表符 |
通过 |
| JSON格式字符串 |
通过 |
| 空字符串 |
通过 |
| 特殊符号 |
通过 |
| 1024字符内容 |
通过 |
| 4096字符内容 |
通过 |
| 同键覆盖写入 |
通过 |
| 相同内容重复写入 |
通过 |
| 不同配置键独立保存 |
通过 |
| 不存在的配置键 |
返回None |
测试确认,这两个接口可以正常存储常见字符串内容,且本次测试的4096字符内容能够完整写入和读取。
最大存储容量尚未验证。
4.2 参数错误测试
根据接口文档,write_config() 的两个参数均为字符串。
测试以下错误类型:
write_config(None, 'abc')
write_config(123, 'abc')
write_config('test_key', None)
write_config('test_key', 123)
实际抛出:
TypeError: write_config(): incompatible function arguments
read_config() 传入错误类型时同样会触发异常:
read_config(None)
read_config(123)
实际抛出 TypeError。
因此,实际使用时需要注意:错误参数类型可能直接触发Python异常,而不是返回文档中的 -1。
文档定义的存储失败返回值 1 和错误返回值 -1,本次未实际触发。
4.3 覆盖写入测试
使用相同配置键依次写入不同内容:
write_config('test_key', 'value_1')
write_config('test_key', 'value_2')
print(read_config('test_key'))
读取结果:
value_2
实测确认同键重复写入可以覆盖旧内容,重复写入相同内容也正常。
五、配置持久化与跨环境共享测试
5.1 跨策略运行读取
首先写入固定配置:
write_config('last_run', 'saved_state_001')
停止策略后,在另一份独立脚本中读取相同配置键:
value = read_config('last_run')
print(value)
示例预期结果:
saved_state_001
实际专项测试使用固定配置键及时间标记,已确认新脚本能够读取先前写入的内容。
这表明配置数据不会随着原策略结束而立即消失。
5.2 终端重启后读取
完成配置写入后,退出并重新启动投研终端,再运行读取测试。
测试中仍然成功读取之前保存的内容。
因此,本次测试确认配置内容能够跨策略运行和终端重启保留。
5.3 内置Python与原生Python共享配置
先在QMT内置Python中写入:
write_config('shared_key', 'written_by_strategy')
再在原生Python中读取:
from qmt_api import read_config
value = read_config('shared_key')
print(value)
示例预期输出:
written_by_strategy
实际测试中,原生Python成功读取内置Python此前保存的时间标记。
另外,原生Python自身的写入、读取、同键覆盖和中文JSON保存也均已测试通过。
目前确认:
- 内置Python写入、读取正常。
- 原生Python写入、读取正常。
- 内置Python写入的数据可以由原生Python读取。
- 原生Python写入后由内置Python反向读取,尚待单独取得最终验证日志。
六、应用示例:保存和恢复策略参数
例如,保存策略使用的仓位比例,重新启动策略时尝试恢复:
#coding:gbk
KEY = 'position_ratio'
def init(C):
value = read_config(KEY)
if value is None:
position_ratio = 0.2
print('未读取到配置,使用默认参数')
else:
try:
position_ratio = float(value)
except Exception:
position_ratio = 0.2
print('配置内容无效,使用默认参数')
print('当前仓位比例:', position_ratio)
ret = write_config(KEY, str(position_ratio))
print('配置保存返回:', ret)
def handlebar(C):
pass
该示例只演示参数保存和恢复,不执行交易委托。
实际策略中,也可以保存策略运行日期、交易信号标记、自定义风控参数等。
需要注意,订单、成交和持仓仍应以交易账户查询结果为准,不能单独依赖配置库中的历史标记。
七、注意事项
7.1 配置键不是本地文件路径
虽然函数参数名为 path,实际使用时可以直接传入简单的配置键:
write_config('test_key', 'hello')
read_config('test_key')
不需要提供Windows文件路径。
根据接口说明,配置内容会加密存放在终端本地配置库中,具体物理文件名、文件格式及存储目录尚未确认。
7.2 不需要自行读写文件
使用这两个接口,不需要自行调用:
open()
pandas.read_csv()
配置的读写操作由迅投QMT接口完成。
7.3 建议使用独立配置键
不同策略建议使用不同的键名,例如:
strategy_a_last_signal
strategy_a_position_ratio
strategy_b_last_signal
strategy_b_position_ratio
避免多个策略无意间使用相同的键并覆盖彼此的数据。
7.4 尚未验证的边界
- 最大存储容量。
- 不同账户、不同终端实例之间的数据隔离。
- 多个策略同时写入同一配置键时的行为。
- 终端升级或卸载后的数据保留情况。
- 配置库异常时的恢复机制。
- 是否支持删除配置项。
对于重要交易状态,建议结合订单、成交和持仓记录进行恢复校验。
八、总结
通过本次迅投QMT接口测试,可以得到以下结论:
write_config() 和 read_config() 均可正常使用。
- 支持QMT内置Python直接调用,以及原生Python通过
qmt_api 调用。
- 支持普通字符串、中文、JSON、空字符串及至少4096字符的测试内容。
- 相同配置键重复写入会覆盖旧内容。
- 不存在的配置键读取返回
None。
- 参数类型不匹配时,实测会抛出
TypeError。
- 配置数据支持跨策略运行及终端重启后读取。
- 原生Python可以读取内置Python此前写入的配置。
- 配置库的具体物理存储路径尚未确认。
这两个接口适合用于迅投QMT策略参数保存、简单配置管理与少量状态持久化。
对于需要在策略重启后恢复参数或运行标记的场景,可以考虑使用这两个配置读写接口。
以上结论基于2026年11月18日的实际测试,具体行为仍可能受到终端版本、权限及运行环境影响。