ContractDetails 类参考

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

类的作用

合约详情返回对象，包含 Contract 本身以及交易时间、最小变动、有效交易所、行业分类等扩展信息。

常见使用位置

reqContractDetails() 成功后由 contractDetails() 回调逐条返回。

字段速查

字段	类型	中文解释
contract	Contract	合约对象，通常包含 symbol、secType、exchange、currency 等字段。
marketName	str	市场名称，通常由扫描器或合约详情返回。
minTick	float	最小报价变动单位。下单价格应符合对应 market rule。
orderTypes	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
validExchanges	str	交易所字段。合约定义、路由和条件触发都可能用到。
priceMagnifier	int	价格相关字段。填写前应确认最小价格增量和订单类型是否支持。
underConId	int	编号字段。用于把请求、订单、合约或成交关联起来。
longName	str	合约长名称，例如公司全称。
contractMonth	str	合约月份，多用于期货、期权等衍生品。
industry	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
category	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
subcategory	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
timeZoneId	str	合约所在交易时区。
tradingHours	str	合约交易时段字符串。
liquidHours	str	合约可交易的高流动性时段。
evRule	str	事件规则，普通股票/期权开发通常不用手工填写。
evMultiplier	int	事件规则乘数，通常来自合约详情或成交对象。
aggGroup	int	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
underSymbol	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
underSecType	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
marketRuleIds	str	市场规则 ID 列表，可再用 reqMarketRule() 查询最小价格增量。
secIdList	对象 / 列表 / 未设置	编号字段。用于把请求、订单、合约或成交关联起来。
realExpirationDate	str	时间或日期字段。TWS API 对日期格式、时区和空值比较敏感。
lastTradeTime	str	时间或日期字段。TWS API 对日期格式、时区和空值比较敏感。
stockType	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
minSize	Decimal	数量相关字段。注意不同产品可能使用股数、合约数、现金数量或 Decimal。
sizeIncrement	Decimal	数量相关字段。注意不同产品可能使用股数、合约数、现金数量或 Decimal。
suggestedSizeIncrement	Decimal	数量相关字段。注意不同产品可能使用股数、合约数、现金数量或 Decimal。
minAlgoSize	Decimal	数量相关字段。注意不同产品可能使用股数、合约数、现金数量或 Decimal。
lastPricePrecision	Decimal	价格相关字段。填写前应确认最小价格增量和订单类型是否支持。
lastSizePrecision	Decimal	数量相关字段。注意不同产品可能使用股数、合约数、现金数量或 Decimal。
cusip	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
ratings	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
descAppend	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
bondType	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
couponType	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
callable	bool	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
putable	bool	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
coupon	int	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
convertible	bool	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
maturity	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
issueDate	str	时间或日期字段。TWS API 对日期格式、时区和空值比较敏感。
nextOptionDate	str	时间或日期字段。TWS API 对日期格式、时区和空值比较敏感。
nextOptionType	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
nextOptionPartial	bool	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
notes	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
fundName	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
fundFamily	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
fundType	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
fundFrontLoad	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
fundBackLoad	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
fundBackLoadTimeInterval	str	时间或日期字段。TWS API 对日期格式、时区和空值比较敏感。
fundManagementFee	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
fundClosed	bool	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
fundClosedForNewInvestors	bool	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
fundClosedForNewMoney	bool	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
fundNotifyAmount	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
fundMinimumInitialPurchase	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
fundSubsequentMinimumPurchase	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
fundBlueSkyStates	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
fundBlueSkyTerritories	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
fundDistributionPolicyIndicator	FundDistributionPolicyIndicator	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
fundAssetType	FundAssetType	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
ineligibilityReasonList	对象 / 列表 / 未设置	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
eventContract1	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
eventContractDescription1	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。
eventContractDescription2	str	扩展字段。实际含义取决于所在接口和产品类型，建议结合对应请求或回调一起阅读。

易错点

• marketRuleIds 不是最小价格增量本身，需要再调用 reqMarketRule() 查询。
• tradingHours / liquidHours 是交易所时区字符串，不适合直接当作本地时间。

版本来源

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