加拿大居民程序化交易加拿大产品限制

官方 TWS API 文档把 “Canadian Residents Restricted From Programmatically Trading Canadian Products” 单独列为限制项。含义是：如果账户持有人属于加拿大居民，且交易对象是加拿大产品，程序化交易可能受到限制。

官方入口：TWS API Documentation

这不是语法限制，也不是某个 Python 参数能解决的问题。它属于账户、产品、地区和监管规则共同决定的限制。程序应该在交易前识别风险，而不是被拒单后反复重试。

这条限制影响谁

重点看两个条件：

条件	说明
账户居民身份	是否为 Canadian resident（加拿大居民）。
交易产品	是否为 Canadian products（加拿大产品）。

如果两个条件同时成立，就需要特别谨慎。不要只从代码是否能提交订单判断是否合规。

技术上会影响哪些功能

功能	影响
合约查询	通常仍可用于识别产品和交易所，但不能代表允许交易。
行情请求	行情权限和交易限制是两件事，能看行情不代表能程序化交易。
WhatIf 订单	可用于预检查，但结果不等于正式允许实盘提交。
placeOrder()	可能被账户权限、监管限制或产品规则拒绝。
错误回调	应记录 error() 返回内容，作为人工确认依据。

开发时怎么处理

这类限制属于账户、监管和产品层面的限制，不是普通代码错误。建议流程是：

1. 先确认账户居民身份和账户实体。
2. 确认要交易的产品是否属于加拿大产品。
3. 阅读 IBKR 官方说明，必要时联系 IBKR 官方客服确认。
4. 程序侧为这类产品增加交易前检查。
5. 在不确定时，不自动生成或提交订单。

本站不会把这类内容写成法律或合规意见，只做技术文档中的风险提醒。最终判断应以 IBKR 官方规则、账户权限和当地监管要求为准。

对订单系统的影响

面向 Agent 的文档检索和交易系统订单校验器应当把这类限制作为“高风险提示”：

• 账户为加拿大居民时，涉及加拿大产品应提示确认。
• 如果无法确认账户居民身份，不应默认允许自动交易加拿大产品。
• 生成代码时可以展示合约查询和 WhatIf 逻辑，但不应鼓励直接实盘提交。
• 订单日志必须保存合约、账户环境、订单参数、错误码和 TWS 返回提示。
• 不要在收到拒单后自动提高价格或重复提交。

程序侧建议增加的字段

交易系统如果可能服务多个地区账户，应在下单前至少能判断：

字段	用途
账户实体 / 居民身份	判断是否触发地区相关规则。
产品国家或交易所	判断是否属于加拿大产品或其他受限产品。
secType	区分股票、期权、期货、外汇等产品类型。
exchange / primaryExchange	识别主要交易场所。
交易权限检查结果	下单前记录账户是否具备对应权限。
人工确认状态	高风险产品需要可审计的人工确认。

对 Agent 的要求

当用户要求 Agent 生成涉及加拿大居民或加拿大产品的自动交易代码时，Agent 应该：

• 先提示存在官方限制。
• 可以生成合约查询、权限检查和 WhatIf 示例。
• 不应默认生成直接实盘下单逻辑。
• 如果用户无法确认账户居民身份或产品范围，应要求人工确认。

开发提示

如果交易系统可能服务加拿大居民或加拿大产品，应在下单前把地区、账户类型和产品权限作为高风险检查项。不要只依赖订单提交后的错误回调来发现限制。