期货实盘委托成交持仓对不上：天勤排查顺序与字段对照
前言
实盘里最耗时间的往往不是信号算错，而是委托有、成交没有、持仓却对不上这类状态问题。我见过策略日志写“已开多 2 手”，get_position却只有 1 手，最后发现是部分成交、重复报单、或平今平昨写错导致拒单。排查要有固定顺序，否则会在 print 里打转。
天勤TqSdk把委托、成交、持仓都挂在同一数据截面上，每次wait_update后可用get_order、get_trade、get_position拉齐。下面给一套从柜台回报到策略记忆的核对流程，并列出常见错位原因。
一、先定“以谁为准”
| 数据源 | 适合作为 |
|---|---|
get_trade | 已发生成交的真相 |
get_order | 在途与终态委托（含撤单、拒单） |
get_position | 交易所认可的持仓截面 |
| 策略自建变量 | 只能当缓存，不能当真相 |
一旦三者不一致，优先信 trade + position，回头改策略状态机，而不是强行改 position 理解。
二、推荐排查顺序（清单）
- 时间戳：最后一次
wait_update是什么时候？若主循环卡住，看到的是旧截面。 - 活跃委托：
orders = api.get_order()，筛status仍为未成、待撤的单。 - 当日成交：
trades = api.get_trade()，按合约汇总成交量。 - 持仓：
pos = api.get_position(symbol)，看pos_long、pos_short、pos（净仓）。 - 策略日志：同一时刻是否重复
insert_order或多次set_target_volume。 - 开平与方向：上期所等区分平今/昨的合约，
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后加：
api.wait_update()ifapi.is_changing(pos,"pos_long")orapi.is_changing(pos,"pos_short"):print("持仓",symbol,pos.pos_long,pos.pos_short,pos.pos)foroid,oinapi.get_order().items():ifo.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为主。
风险提示
本文用于技术排查说明，不构成投资建议。