订单注意事项
API -> Precautions 里的选项会影响 API 下单时是否弹出或阻止订单风险提示。它们不是“提高收益”的设置,而是决定 TWS 是否跳过某些人工确认。
官方位置:
Global Configuration / 全局配置 -> API -> Precautions / 预防这些选项在做什么
Section titled “这些选项在做什么”官方列出的选项大多以 Bypass ... for API orders 开头,意思是“API 下单时跳过某类提示”。
| 设置类型 | 中文理解 | 风险 |
|---|---|---|
| Bypass Order Precautions for API orders | API 订单跳过一般订单提示 | 程序会更顺畅,但新手更容易忽略风险。 |
| Bypass Bond warning for API orders | 跳过债券相关警告 | 只适合理解债券风险的用户。 |
| Bypass negative yield confirmation | 跳过负收益率确认 | 债券、货币市场等产品可能出现用户不熟悉的收益率显示。 |
| Bypass order value cap | 跳过订单金额上限提醒 | 数量或价格填错时更危险。 |
| Bypass price-based volatility risk warning | 跳过价格波动风险提示 | 价格离谱的订单可能更容易提交。 |
| Bypass same side order pair warning | 跳过同方向配对交易警告 | 多订单策略可能更顺畅,但也可能隐藏重复下单。 |
| Bypass US Stocks market data in shares warning | 跳过美股行情股数单位提示 | 对行情和成交量单位理解不清时容易误判。 |
| Bypass Redirect Order warning for Stock API orders | 跳过股票订单重定向提示 | 订单可能被路由到不同目的地。 |
| Bypass Route Marketable to BBO warning | 跳过可成交订单按 BBO 路由的提醒 | 对路由和成交价理解不足时不建议关闭。 |
不同 TWS 版本、账户类型和产品权限看到的选项可能略有差异。理解原则比记住某个界面样式更重要:凡是 Bypass,都表示减少人工提示,让 API 订单更容易直接进入提交流程。
| 环境 | 建议 |
|---|---|
| 模拟账户学习 | 可以逐步勾选,方便测试 API 下单流程。 |
| 真实账户早期 | 不建议全部跳过,先保留必要提示。 |
| 自动化策略上线 | 只有在代码里已经做了订单校验、价格范围、数量限制和 WhatIf 预览后,再考虑跳过部分提示。 |
程序侧必须补上的保护
Section titled “程序侧必须补上的保护”如果关闭了部分订单提示,程序里至少要自己检查:
| 检查项 | 为什么重要 |
|---|---|
| 合约是否唯一 | 同一个 symbol 可能对应不同交易所、币种或产品类型。 |
| 数量是否合理 | 防止把 1 股写成 1000 股,或把手数单位理解错。 |
| 价格是否合理 | 限价单价格应和可用行情、最小价格增量匹配。 |
| 订单类型是否支持 | 不是所有产品都支持同一组订单类型和有效期。 |
whatIf 预览 | 可先让 TWS 返回保证金、佣金和拒单原因,再决定是否正式提交。 |
| 错误码和高级拒单信息 | 订单失败时要记录 errorCode、errorString 和 advancedOrderRejectJson。 |
在 Global Configuration -> API -> Precautions / 预防 页面,重点检查这些问题:
| 检查项 | 说明 |
|---|---|
哪些 Bypass 被勾选 | 勾选越多,API 订单越少被界面提示拦住。 |
| 是否仍保留关键风险提示 | 新手和真实账户早期不建议全部跳过。 |
程序是否有 whatIf、价格、数量和合约校验 | 跳过界面提示后,保护必须由程序补上。 |
这类设置会让 API 订单更少被界面提示拦住,但不代表订单一定安全。正式账户不建议直接照搬模拟账户的勾选状态。
官方文档在 Order Precautions 中列出多项 Bypass ... for API orders 设置,用于减少 API 下单时收到的订单提交提示。