期货程序化开平标志错了总拒单：天勤 last_msg 排查思路

前言

期货报单除了买/卖方向，还要告诉交易所是「开仓」还是「平仓」，部分交易所还要区分平今、平昨。方向对了、开平错了，柜台会拒单。天勤里若用 TargetPosTask，开平顺序 largely 由 offset_priority 和当前 get_position 自动计算；若手写 insert_order，必须自己填 offset 参数。常见错误包括：空仓发平仓、平今手数超过今仓，或同一合约同时用 task 和 insert_order 导致状态混乱。

拒单后信息在委托对象的 last_msg 里，是中文或英文说明文字；status 变为 FINISHED 且 volume_left 等于原始手数时，常表示完全未成交结束。下面说明字段含义、典型场景、如何用 get_position 反推该怎么报。

一、名词对照

名称	在天勤里
`insert_order`	手写报单函数，参数含 direction、offset
`offset`	OPEN、CLOSE、CLOSETODAY 等开平标志
`TargetPosTask`	自动算开平，用户不直接填 offset
`offset_priority`	task 的平今昨开顺序
`get_position`	持仓对象
`pos`	净持仓
`pos_long` / `pos_short`	多空分列，锁仓要看
`status`	ALIVE=在途，FINISHED=结束
`volume_left`	未成交手数
`volume_orign`	原始委托手数
`last_msg`	柜台状态说明，拒单原因常在此
`is_error`	是否错单标记，False 也不一定无错

二、典型拒单场景

无仓却 CLOSE：净 pos 为 0 仍发平仓。
平今超过今仓：上期所等区分平今平昨，今仓不够。
锁仓结构复杂：净 pos 为 0 但 pos_long>0，平今昨判断不同。
task 与 insert_order 混用：官方禁止，易重复或错单。

python 复制代码

order = api.get_order(order_id)
while True:
    api.wait_update()
    if api.is_changing(order, "status") or api.is_changing(order, "last_msg"):
        if order.status == "FINISHED" and order.volume_left == order.volume_orign:
            handle_reject(order)  # 解析 last_msg，勿盲目重报

handle_reject 内维护「消息关键词 → 动作」表，按团队期货公司文案更新。

三、拒单后先读 position

python 复制代码

pos = api.get_position(symbol)
# 把策略目标与 pos.pos 对齐，再决定是否 set_target_volume

若用 TargetPosTask，可 set_target_volume(pos.pos) 同步 task，再设新目标，避免在错误持仓假设上继续 OPEN。

四、交易所差异（简述）

上期所等：平今、平昨分开，offset_priority 重要。中金所等：指令层面不区分平今昨，按先开先平规则，见 task 源码注释。股指平今成本可通过 offset_priority="昨开" 等方式降低频率，但不能替代正确持仓认知。

总结

开平标志错了，表现就是 last_msg 里出现资金、持仓、开平相关提示，而 volume_left 一点没减少。天勤的 TargetPosTask 适合不想手填 offset 的趋势调仓；手写 insert_order 则要自己保证 offset 与 get_position 一致，且勿与 task 混用。把常见 last_msg 整理成表、拒单后先同步持仓再重试，按步骤排查，而不是反复盲报浪费报单额度。

FAQ

1）刚下单 status 为空？

正常，继续 wait_update，勿立刻判失败。

2）部分成交算拒单吗？

volume_left 部分减少，按部分成交处理。

3）模拟盘文案一样吗？

大体接近，以实盘期货公司为准。

4）task 内部发什么 offset？

由天勤按交易所规则和持仓计算，用户不直接设。

风险提示

以上内容用于报单排查参考，不构成投资建议。