ExecutionFilter 类参考

ExecutionFilter 是 TWS API Reference 中的一个数据结构。本页按 IBKR TWS API Python 包 10.47.1 的字段核对，用中文解释常见用途。

类的作用

成交查询过滤器，用来限制 reqExecutions() 返回的账户、时间、合约和方向。

常见使用位置

作为 reqExecutions(reqId, execFilter) 的第二个参数。

字段速查

字段	类型	中文解释
clientId	int	API 客户端编号。同一 TWS 中不同程序应使用不同 clientId，避免订单和回调互相混淆。
acctCode	str	成交过滤器中的账户代码，用来只查询某个账户的成交。
time	str	时间字段。不同回调可能是 Unix 秒、交易所时间字符串或筛选时间。
symbol	str	合约代码，例如 AAPL、ES、EUR。
secType	str	证券类型，例如 STK、OPT、FUT、CASH、BAG。
exchange	str	交易所或路由目的地。股票常用 SMART 路由，但 primaryExchange 不应写 SMART。
side	str	编号字段。用于把请求、订单、合约或成交关联起来。
lastNDays	int	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
specificDates	对象 / 列表 / 未设置	时间或日期字段。TWS API 对日期格式、时区和空值比较敏感。

易错点

• 过滤条件越少，返回范围越大；生产环境应至少限定时间或账户。
• time 格式要按 TWS API 规则填写，避免因为格式错误返回空结果。

版本来源

Python API 中对应源码文件为 ibapi/execution.py。不同语言的类名和字段名可能略有大小写差异，但核心含义一致；写策略时应以自己安装的 API 版本为准。