OrderState 类参考

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

类的作用

订单状态对象，包含状态、保证金变化、费用预估、拒单原因和完成状态。

常见使用位置

openOrder()、completedOrder()、WhatIf 订单预检查都会返回 OrderState。

字段速查

字段	类型	中文解释
status	str	订单状态，例如 Submitted、PreSubmitted、Filled、Cancelled。
initMarginBefore	str	保证金相关字段。WhatIf 和订单状态中常见，用来判断提交前后保证金变化。
maintMarginBefore	str	保证金相关字段。WhatIf 和订单状态中常见，用来判断提交前后保证金变化。
equityWithLoanBefore	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
initMarginChange	str	保证金相关字段。WhatIf 和订单状态中常见，用来判断提交前后保证金变化。
maintMarginChange	str	保证金相关字段。WhatIf 和订单状态中常见，用来判断提交前后保证金变化。
equityWithLoanChange	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
initMarginAfter	str	保证金相关字段。WhatIf 和订单状态中常见，用来判断提交前后保证金变化。
maintMarginAfter	str	保证金相关字段。WhatIf 和订单状态中常见，用来判断提交前后保证金变化。
equityWithLoanAfter	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
commissionAndFees	float	佣金和费用合计。可能在 WhatIf、成交费用报告或订单状态中出现。
minCommissionAndFees	float	佣金或费用相关字段。成交后可能由费用报告补充，提交前可能只是预估。
maxCommissionAndFees	float	佣金或费用相关字段。成交后可能由费用报告补充，提交前可能只是预估。
commissionAndFeesCurrency	str	佣金和费用使用的币种。
marginCurrency	str	保证金相关字段。WhatIf 和订单状态中常见，用来判断提交前后保证金变化。
initMarginBeforeOutsideRTH	float	保证金相关字段。WhatIf 和订单状态中常见，用来判断提交前后保证金变化。
maintMarginBeforeOutsideRTH	float	保证金相关字段。WhatIf 和订单状态中常见，用来判断提交前后保证金变化。
equityWithLoanBeforeOutsideRTH	float	编号字段。用于把请求、订单、合约或成交关联起来。
initMarginChangeOutsideRTH	float	保证金相关字段。WhatIf 和订单状态中常见，用来判断提交前后保证金变化。
maintMarginChangeOutsideRTH	float	保证金相关字段。WhatIf 和订单状态中常见，用来判断提交前后保证金变化。
equityWithLoanChangeOutsideRTH	float	编号字段。用于把请求、订单、合约或成交关联起来。
initMarginAfterOutsideRTH	float	保证金相关字段。WhatIf 和订单状态中常见，用来判断提交前后保证金变化。
maintMarginAfterOutsideRTH	float	保证金相关字段。WhatIf 和订单状态中常见，用来判断提交前后保证金变化。
equityWithLoanAfterOutsideRTH	float	编号字段。用于把请求、订单、合约或成交关联起来。
suggestedSize	Decimal	数量相关字段。注意不同产品可能使用股数、合约数、现金数量或 Decimal。
rejectReason	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
orderAllocations	对象 / 列表 / 未设置	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
warningText	str	订单警告文本。不能忽略，应展示或写入日志。
completedTime	str	时间或日期字段。TWS API 对日期格式、时区和空值比较敏感。
completedStatus	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。

易错点

• WhatIf 返回的保证金和费用是预估，不等于真实成交后最终费用。
• rejectReason 和 warningText 应写入日志并展示给用户。

版本来源

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