WshEventData 类参考

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

类的作用

Wall Street Horizon 事件数据请求对象。

常见使用位置

reqWshEventData(reqId, data) 使用它请求事件数据。

字段速查

字段	类型	中文解释
conId	int	IBKR 合约 ID。它是最稳定的合约标识之一，建议先通过合约详情查询确认。
filter	str	事件数据过滤 JSON 字符串或条件。
fillWatchlist	bool	WSH 事件请求是否包含自选列表相关事件。
fillPortfolio	bool	WSH 事件请求是否包含投资组合相关事件。
fillCompetitors	bool	WSH 事件请求是否包含竞争对手事件。
startDate	str	开始日期。WSH 等事件接口使用。
endDate	str	结束日期。WSH 等事件接口使用。
totalLimit	int	WSH 事件最多返回条数。

易错点

• WSH 事件需要相应新闻/事件权限。
• filter 是 JSON 字符串，格式错误会导致请求失败或返回空结果。

版本来源

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