Bar 类参考

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

类的作用

历史 K 线返回的一根 bar，包含开高低收、成交量、WAP 和样本数。

常见使用位置

historicalData()、historicalDataUpdate() 和部分实时 bar 逻辑会用到。

字段速查

字段	类型	中文解释
date	str	K 线时间。格式受 formatDate 和请求类型影响，历史 K 线可能带交易所时区。
open	float	K 线开盘价。
high	float	K 线最高价。
low	float	K 线最低价。
close	float	K 线收盘价。
volume	Decimal	成交量或成交量条件阈值。
wap	Decimal	成交量加权平均价。
barCount	int	K 线内包含的成交笔数或报价样本数量，具体含义随 whatToShow 变化。

易错点

• date 的格式受 formatDate 影响，不能假设永远是本地时区。
• volume 和 wap 可能是未设置值，尤其是没有权限或数据源不支持时。

版本来源

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