TqApi 初始化参数组合：回测、模拟与实盘怎么配
前言
天勤量化里，TqApi(...)一行参数往往决定策略跑在回测、本地模拟还是实盘柜台。我见过把TqAccount和TqBacktest混用导致构造失败，也见过回测脚本忘了TqAuth在模拟环境无法取数。下面整理我常用的初始化矩阵和容易踩坑的组合。
一、三种运行形态各自传什么
| 形态 | 典型构造 | 说明 |
|---|---|---|
| 历史回测 | TqApi(backtest=TqBacktest(...), auth=TqAuth(...)) | 时间由回测区间推进 |
| 本地模拟 | TqApi(TqSim(), auth=TqAuth(...)) | 撮合规则贴近内置模拟 |
| 快期模拟盘 | TqApi(TqKq(), auth=TqAuth(...)) | 与本地 TqSim 不同，按文档切换 |
| 实盘 | TqApi(TqAccount(...), auth=TqAuth(...)) | 需期货公司、账号、密码 |
TqAuth在多数联网场景下需要，用于行情与账户权限校验；具体以当前账户套餐为准。
二、最小示例对照
回测
fromdatetimeimportdatefromtqsdkimportTqApi,TqAuth,TqBacktest api=TqApi(backtest=TqBacktest(start_dt=date(2024,1,1),end_dt=date(2024,6,30)),auth=TqAuth("快期账户","密码"),)本地模拟
fromtqsdkimportTqApi,TqAuth,TqSim api=TqApi(TqSim(),auth=TqAuth("快期账户","密码"))实盘（示例为 CTP 类账户，柜台名以开户为准）
fromtqsdkimportTqApi,TqAuth,TqAccount api=TqApi(TqAccount("H某期货","资金账号","交易密码"),auth=TqAuth("快期账户","密码"),)三、错误组合与反例
- 同时传入互斥的
backtest与TqAccount作为第一交易单元，通常不符合单一运行态设计，应按阶段拆分脚本。 - 回测脚本中订阅了实盘才有的柜台能力，导致回测阶段报不支持。
- 未传
auth但能连上行情、无法交易或部分接口受限——先核对认证与套餐，再查网络。
四、从回测到模拟再到实盘的改动清单
建议主循环与信号函数保持不变，仅替换构造段：
- 交易单元：
TqBacktest→TqSim/TqKq→TqAccount - 合约代码：回测注意历史合约是否可交易，模拟/实盘用当前主力或指定月份
- 日志与风控：模拟起加入持仓校验；实盘前加只读监控运行数日
- 手续费：回测在
TqBacktest或策略内显式设置，实盘以实际为准
五、多账户时的构造
多账户使用TqMultiAccount等能力时，构造方式与单账户不同，需按官方多账户示例传入账户列表，并在下单时指定account。单账户策略不要提前引入多账户复杂度。
总结
TqApi初始化本质是选定“时间如何走、单子如何成交”。回测、模拟、实盘分脚本或分配置管理，主循环统一用wait_update，能显著降低迁移成本。
FAQ
1）回测必须写 TqAuth 吗？
需要行情权限时一般要；以本地环境与账户状态为准，报错先查认证。
2）TqSim 和 TqKq 能混在一个 api 里吗？
按文档选择其一作为交易单元；二者业务含义不同，不宜随意混用。
3）模拟盘可以不下单只读行情吗？
可以，用只读逻辑跑通订阅与wait_update，再逐步放开下单接口。
4）实盘构造函数里的期货公司名写错会怎样？
常见为连接失败或认证错误，需与开户券商名称一致。
5）回测结束如何退出？
回测推进到结束日期后wait_update会结束循环或抛结束相关异常，外层应捕获并api.close()释放资源。
风险提示
本文用于期货量化技术实践讨论，不构成投资建议。