获取IB历史期权数据异常：可获取合约详情但无历史数据

我来帮你排查这个问题——你能成功获取期权合约详情，但始终收不到历史数据，大概率是参数格式、回调注册或者合约设置的小问题，咱们一步步拆解修复：

1. 先修正contracts列表的初始化逻辑 #

你的代码里contracts = []是在发送请求之后才定义的，这会导致contractDetailsHandler执行时尝试往未定义的列表里加元素，理论上会抛出NameError。虽然你的输出里没显示这个错误，但这是明显的逻辑漏洞，得把初始化提前：

# 把这两行移到最前面，连接IB之前就初始化
contracts = []
DataWait = True

2. 检查历史数据请求的参数错误 #

这是最容易踩坑的地方：

a. Bar Size格式错了

IB API要求barSizeSetting必须是复数形式，你写的"30 min"要改成"30 mins"，少个s会导致IB识别不了你的请求，自然不会返回数据。

b. 过期合约必须开权限

你请求的是2018年6月到期的SPY期权，现在已经过期了，必须开启m_includeExpired才能查过期合约的历史数据，取消这行的注释：

contract.m_includeExpired = True

c. 时间参数要用UTC时区

IB服务器默认用UTC时间，你用本地时间生成的endtime可能导致请求的时间范围没有数据，改成UTC时间试试：

endtime = datetime.datetime.utcnow().strftime('%Y%m%d %H:%M:%S')

3. 修正历史数据回调的注册方式 #

你注册historicalData回调用的是message.historicalData，虽然理论上可行，但和其他回调的字符串注册方式统一更稳妥，避免潜在的导入问题：

# 把原来的注册代码改成字符串标识
con.register(contractHistDetailsHandler, 'HistoricalData')

4. 检查端口和权限 #

• 新版本IB Gateway的默认端口是4002，不是你写的4001，如果用的是新版Gateway，记得改端口；
• 如果你没有MIDPOINT数据权限，可以把whatToShow参数改成"BID"或"ASK"试试。

修正后的完整代码 #

from ib.ext.Contract import Contract
from ib.ext.ContractDetails import ContractDetails
from ib.opt import ibConnection, message
import time
import datetime
from time import sleep, strftime

twsPort = 7496
gatewayPort = 4002  # 新版Gateway端口

def watcher(msg):
    print("[watcher: ", msg, " ]")

def contractDetailsHandler(msg):
    print("[contractDetailsHandler:]")
    contractDetails = msg.contractDetails
    contract = msg.contractDetails.m_summary
    print(contractDetails.m_cusip, contractDetails.m_underConId, contractDetails.m_longName, 
          contractDetails.m_industry, contractDetails.m_category, contractDetails.m_subcategory, 
          contract.m_symbol, contract.m_secType, contract.m_strike, contract.m_right, 
          contract.m_exchange, contract.m_currency, contract.m_secIdType, contract.m_secId, "\n")
    contracts.append(contractDetails.m_summary)

def contractDetailsEndHandler(msg):
    print("[contractDetailsEndHandler:]")

def contractHistDetailsHandler(msg):
    global DataWait
    print("[contractHistDetailsHandler:]")
    print(f"拿到历史数据: {msg.date}, 开盘:{msg.open}, 最高:{msg.high}, 最低:{msg.low}, 收盘:{msg.close}, 成交量:{msg.volume}")
    contracts.append(msg)
    # 最后一条数据的date是"finished"，此时结束等待
    if msg.date == "finished":
        DataWait = False

# 提前初始化列表和等待标志
contracts = []
DataWait = True

con = ibConnection()
con.host = "127.0.0.1"
con.port = gatewayPort
con.clientId = 5

con.registerAll(watcher)
con.register(contractDetailsHandler, 'ContractDetails')
con.register(contractDetailsEndHandler, 'ContractDetailsEnd')
con.register(contractHistDetailsHandler, 'HistoricalData')

con.connect()

contract = Contract()
contract.m_exchange = "SMART"
contract.m_secType = "OPT"
contract.m_symbol = "SPY"
contract.m_currency = "USD"
contract.m_strike = 260
contract.m_right = "PUT"
contract.m_expiry = "20180615"
contract.m_includeExpired = True  # 启用过期合约查询

# 用UTC时间作为结束时间
endtime = datetime.datetime.utcnow().strftime('%Y%m%d %H:%M:%S')

con.reqContractDetails(1, contract)
# 修正barSize为"30 mins"，如果MIDPOINT权限不足可以改成"BID"
con.reqHistoricalData(2, contract, endtime, "14 D", "30 mins", "MIDPOINT", 0, 1)

i = 0
while DataWait and i < 90:
    i += 1 
    print(f"等待数据中... {i}/90")
    time.sleep(1)

time.sleep(1)
con.disconnect()
con.close()

print("\n最终获取的内容:")
for item in contracts:
    print(item)

额外调试技巧 #

• 打开TWS的Help > Message Log，查看详细的API交互日志，能看到IB服务器返回的所有信息，包括隐藏的错误；
• 先试试请求SPY股票（secType="STK"）的历史数据，排除期权权限或合约本身的问题。

内容的提问来源于stack exchange，提问作者Ivan