期货量化实盘连不上怎么办：天勤 TqAccount 权限与渐进开通
前言
模拟盘跑顺了再切实盘，常见卡点不是策略逻辑，而是TqAccount报权限类错误：期货公司不在支持列表、账户未开通程序化、专业版未生效、或构造参数写错。我帮同事对接实盘时，习惯先做「只读监控」脚本，确认能连上、能读到持仓和资金，再放开下单权限。
天勤TqSdk通过TqAccount对接 CTP 类实盘（具体支持范围以当期文档为准）。下面按报错类型、开通前要确认什么、最小只读脚本到渐进下单的顺序说明，代码只放在验证环节。
一、权限类错误先别当成策略 bug
典型现象：
- 创建
TqApi时或第一次wait_update时报认证、权限相关异常 - 能连模拟
TqSim/TqKq，换TqAccount立刻失败 - 能读行情，交易接口报无权限
应先对照快期客户端：同一资金账号能否登录、是否已申请程序化/实盘权限、期货公司是否与文档支持列表一致。不要在未确认权限前反复改策略信号。
二、开通前要核对的事项
| 项 | 说明 |
|---|---|
| 期货公司 | 文档列出的支持公司与你的开户公司一致 |
| 账户类型 | 仿真、快期模拟、实盘账户构造方式不同 |
| 专业版/套餐 | 部分能力随快期账户套餐变化 |
| 交易时段 | 非交易时段连接行为与拒单不同 |
| IP/白名单 | 部分机构要求服务器 IP 报备 |
向期货公司业务经理确认「程序化交易」是否已开通，比在社区反复问 SDK 版本更有效。
三、最小只读监控脚本
实盘第一步建议只订阅行情、读账户和持仓，不发单：
fromtqsdkimportTqApi,TqAuth,TqAccount auth=TqAuth("快期账户","快期密码")# 期货公司名、资金账号、密码以文档 TqAccount 构造为准account=TqAccount("期货公司","资金账号","交易密码")api=TqApi(account,auth=auth)symbol="SHFE.rb2510"quote=api.get_quote(symbol)pos=api.get_position(symbol)acc=api.get_account()whileTrue:api.wait_update()ifapi.is_changing(acc,"balance"):print("balance",acc.balance,"available",acc.available)print("pos",symbol,pos.pos_long,pos.pos_short)breakapi.close()能稳定打印资金与持仓后，再复制一份脚本加极小手数测试单（交易时段、限价贴近市价），并有人工复核。
四、渐进放开：只读 → 小单 → 全策略
- 只读运行至少一个完整交易日（含夜盘若你做夜盘）。
- 小单测试：1 手开平，核对
order、position与客户端一致。 - 接入原策略，但先限制最大手数、先关加仓逻辑。
- 全量参数前，确认日志、断线重连、紧急停止流程已演练。
模拟用的TqSim/TqKq与实盘TqAccount不要混在同一个未隔离的配置里，避免环境变量指错（配置分离另有专文）。
五、与模拟环境的差异
实盘有报单流控、平今平昨规则、保证金实时变化；策略里若只在启动时读一次get_account，盘中仍可能因资金不足拒单。实盘层要加：交易时段过滤、下单前资金检查、委托状态跟踪。
非 CTP 柜台（融航、杰宜斯等）构造方式不同，若你不在 CTP 路线，应对照对应reference文档，不要照搬TqAccount示例。
总结
实盘连不上时，应先把问题归到「权限与构造」而不是「信号逻辑」：期货公司是否在支持范围、程序化是否已开通、快期认证与专业版是否生效、TqAccount的期货公司名与资金账号是否与客户端一致。模拟能跑、实盘不能，几乎都是这几项之一，改均线或改周期解决不了。
天勤侧较稳妥的路径是只读监控（行情 +get_account+get_position）跑满至少一个含夜盘的交易日，再 1 手开平测试，最后才接入完整策略，并配合交易时段过滤、下单前资金检查、委托状态跟踪。TqSim、TqKq与TqAccount的配置要分文件或分环境变量存放，避免模拟脚本在实盘环境被误启。非 CTP 柜台需对照对应文档，不要照搬 CTP 示例。
落地时建议留存：期货公司书面开通记录、通过验证的只读脚本版本、小单测试当日的持仓与成交截图。换服务器、换 IP、升级 TqSdk 后，固定先跑只读再恢复下单；若出现权限类报错，按「客户端能否登录 → 构造参数 → 套餐范围」顺序排查，比反复重装 SDK 更省时间。
FAQ
1）模拟能跑实盘不能？
几乎总是权限或构造参数问题，不是 K 线订阅问题。
2）是否必须专业版？
以快期当期说明为准，实盘前在官网或客服确认。
3）多个实盘账户？
用多账户相关文档构造，勿混用一个全局 api 变量。
4）只读脚本会下单吗？
只要不调用insert_order/TargetPosTask就不会；注意勿误拷带下单的旧脚本。
风险提示
本文用于技术对接说明，不构成投资建议。实盘交易有风险，请遵守期货公司规定。