期货实盘委托成交持仓对不上:天勤排查顺序与字段对照

前言

实盘里最耗时间的往往不是信号算错,而是 委托有、成交没有、持仓却对不上 这类状态问题。我见过策略日志写"已开多 2 手",get_position 却只有 1 手,最后发现是部分成交、重复报单、或平今平昨写错导致拒单。排查要有固定顺序,否则会在 print 里打转。

天勤 TqSdk 把委托、成交、持仓都挂在同一数据截面上,每次 wait_update 后可用 get_order、get_trade、get_position 拉齐。下面给一套从柜台回报到策略记忆的核对流程,并列出常见错位原因。

一、先定"以谁为准"

数据源 适合作为
get_trade 已发生成交的真相
get_order 在途与终态委托(含撤单、拒单)
get_position 交易所认可的持仓截面
策略自建变量 只能当缓存,不能当真相

一旦三者不一致,优先信 trade + position,回头改策略状态机,而不是强行改 position 理解。

二、推荐排查顺序(清单)

  1. 时间戳 :最后一次 wait_update 是什么时候?若主循环卡住,看到的是旧截面。
  2. 活跃委托 :orders = api.get_order(),筛 status 仍为未成、待撤的单。
  3. 当日成交 :trades = api.get_trade(),按合约汇总成交量。
  4. 持仓 :pos = api.get_position(symbol),看 pos_long、pos_short、pos(净仓)。
  5. 策略日志 :同一时刻是否重复 insert_order 或多次 set_target_volume。
  6. 开平与方向 :上期所等区分平今/昨的合约,offset 写错会拒单但策略以为已平。

把 2~4 在一张表里打快照,比逐行 print 高效。

三、天勤字段级快速对照

委托 (get_order 返回的 order 对象,字段以当前版本文档为准):

  • status:是否已全成、撤单、拒单
  • volume_orign / volume_left:原始手数与剩余
  • insert_date_time:报单时间,用于和成交对齐

成交 (get_trade):

  • volume、price、direction、offset
  • 与 order 的 order_id 关联(若字段存在)

持仓 (get_position):

  • pos_long、pos_short 分列;净仓用 pos
  • 浮动盈亏与 get_account 权益分开看,避免把浮盈当可用资金

在 wait_update 后加:

python 复制代码
api.wait_update()
if api.is_changing(pos, "pos_long") or api.is_changing(pos, "pos_short"):
    print("持仓", symbol, pos.pos_long, pos.pos_short, pos.pos)
    for oid, o in api.get_order().items():
        if o.status == "ALIVE":  # 以文档枚举为准
            print("在途", oid, o.direction, o.offset, o.volume_left)

ALIVE 等状态字以你安装的 TqSdk 文档为准,不同版本命名可能略有差异。

四、五种高频错位原因

现象 常见原因 处理
委托有、无成交 限价太远、非交易时段、资金不足 看 quote 买卖盘与 get_account 可用
成交有、持仓不对 部分成交、多合约 symbol 写错 按 trade 汇总,核对合约代码
持仓对、策略记错 用全局变量记仓,未在成交后更新 以 position 为准重算或每帧同步
重复开仓 每 tick 都下单,未用 is_changing 限频 K 线策略配合 datetime 变化判断
平不掉 平今/平昨顺序、锁仓规则 检查 offset 与 TargetPosTask 的 offset_priority

五、TargetPosTask 场景的额外检查

使用 TargetPosTask 时,下单撤单在 wait_update 里异步完成。若你手写日志在 set_target_volume 后立即打印 position,可能还没成交。

正确做法:等 is_changing(pos, ...) 或监听 task 的 trade_chan(文档中有成交通知 channel 可选参数)再记仓。

同一合约不要同时又用 insert_order,否则 task 内部状态与手动报单冲突,表现为委托列表混乱。

六、模拟与实盘核对差异

TqSim 进程内模拟与 TqKq 快期模拟账户不是同一套记录;团队对账要用 TqKq 或实盘账户,并在 APP 侧交叉验证。

回测结束用 BacktestFinished 捕获后导出成交统计,与实盘日志格式保持一致,方便横向对比。

总结

委托、成交、持仓对不上时,按 wait_update 是否新鲜 → 在途 order → trade 汇总 → position → 策略日志 顺序查,真相以 trade 和 position 为准。天勤在同一 API 截面提供三类对象,适合在 is_changing 触发时打结构化快照。

重点排查部分成交、重复报单、开平写错、TargetPosTask 后立即记仓、以及 TqSim 与 TqKq 混用。把核对脚本做成每日收盘后固定动作,比出问题时临时 grep 日志更省时间。

FAQ

1)get_order 空但策略下过单?

可能已全部成交或撤单完成;改查 get_trade 历史。也要确认是否连错账户实例(多账户模式要传 account 参数)。

2)净仓和多空对不上?

看是否同时有多空持仓(锁仓);有的策略看 pos,有的要看 pos_long/pos_short 分列。

3)回报延迟几秒算异常?

网络与交易所负载会导致延迟;若超过数十秒且无 wait_update,查主循环是否阻塞。

4)能否用 trade_log?

TqSim 等提供 trade_log 适合做模拟二次核对,实盘仍以实时 get_trade 为主。

风险提示

本文用于技术排查说明,不构成投资建议。

相关推荐
kyle~19 小时前
FastAPI --- 将业务能力以 API 的形式提供给外部系统
python·fastapi·前后端
aiotto资源分享19 小时前
Python 写 JSON 文件,程序中途退出会留下什么?
java·python·json·jsondecodeerror
梯度下降者20 小时前
Python信号量,条件变量,事件学习
python·条件变量·事件·信号量·线程通信
MSTcheng.21 小时前
【AI应用实战】用 FastAPI + SSE 做一个自己的 AI 聊天网页:流式输出、多轮对话与完整源码
人工智能·python·大模型·fastapi·sse·ai聊天助手
the局外人21 小时前
Python 实战检索优化:BM25、向量与重排
数据库·后端·python
__underline__21 小时前
冷门Python知识点006篇:Python 类体里的名字,能被"凭空造出来"
后端·python
用户0332126663671 天前
使用 Python 轻松移除 Excel 文档中的重复行
python·excel
LiaoWL1231 天前
从零搭一个 RAG 知识库(二):换上语义 Embedding——BGE 实测与阈值重校准
python·大模型·numpy·embedding·向量检索·rag
Dmz丶1 天前
前端转 AI 100 天 Day 48:向量数据库——100 万向量的毫秒级检索
python
青少儿编程课堂1 天前
蓝桥杯·全国青少年信息素养大赛·电子学会Python/C++考级:中国剩余定理解析
c++·python·算法·bfs·信息学竞赛