insert_order 报单类型怎么选：限价、FAK 与 FOK 期货场景
前言
在天勤量化里，insert_order是程序化下单的核心接口。报单类型选错，常见后果是撤单狂增、部分成交后敞口裸露，或回测里假设能成交而实盘挂在板上。下面按期货里常用的限价、FAK、FOK 等说明适用场景，并给出最小调用片段。
一、类型与场景对照
| 类型 | 行为要点 | 常见适用 |
|---|---|---|
| 限价 | 价格不低于卖价/不高于买价才排队成交 | 常规建仓、流动性好的主力合约 |
| 市价（若柜台支持） | 追求速度，滑点不确定 | 强平、紧急减仓 |
| FAK | 立即成交可成交部分，剩余撤销 | 需要快速试探深度、允许部分成交 |
| FOF / FOK | 全部立即成交否则全部撤销 | 套利腿同时成交、减少单腿风险 |
不同期货公司柜台对市价、FAK、FOK 支持可能不同，实盘前应在模拟环境逐项验证。
二、限价单最小示例
order=api.insert_order(symbol="SHFE.rb2510",direction="BUY",offset="OPEN",volume=1,limit_price=quote.ask_price1,# 示例：买开用卖一价挂单)注意：
direction与offset组合要符合当前持仓（开平今昨规则因交易所而异）。limit_price应在涨跌停范围内，否则会被拒单。
三、FAK / FOK 使用边界
FAK：适合“能成交多少算多少”，剩余不挂单。用于对深度不确定但希望减少挂单时间的场景。
FOK：适合多腿套利——一条腿 FOK 失败则不应让另一腿单独裸露。实现上常配合同步逻辑与撤单回滚。
若策略在回测里按“全部成交”假设，而实盘用 FAK，必须分开评估绩效，不能同一套滑点参数硬套。
四、与 TargetPosTask 的分工
- insert_order：精细控制每一笔价格、类型，适合手工规则强、挂单逻辑复杂的策略。
- TargetPosTask：声明目标净持仓，由底层拆单调仓，适合趋势类“调到 N 手”的需求。
需要严格限价入场时多用insert_order；需要维持目标仓位、容忍分批成交时可用TargetPosTask。
五、下单前检查清单
- 交易时段是否允许该合约交易
limit_price是否有效、是否触及涨跌停- 资金是否足够（可用
account字段） - 是否重复下单（本地状态机记录已报单 id）
- 模拟与实盘账户对象是否一致
总结
报单类型是执行层策略的一部分。限价求可控，FAK/FOK 求时序与完整性；先在同一柜台模拟验证支持情况，再写入生产策略。
FAQ
1）insert_order 返回后就算成交吗？
否。需跟踪order状态直至成交或撤销，用is_changing(order)更新本地状态。
2）平今和平昨怎么写 offset？
按交易所规则与当前持仓的今昨仓字段选择，写错会被拒单。
3）回测里限价单一定按 limit_price 成交吗？
回测撮合有自身假设，见回测文档；与实盘仍有差异。
4）FAK 部分成交后敞口怎么办？
策略层要有补单或对冲逻辑，不能假设“反正差不多成交了”。
5）挂单价格用对手价还是本方价？
主动成交用对手价，被动挂单用本方价；取决于你是吃单还是排队。
风险提示
本文用于期货量化技术实践讨论，不构成投资建议。