使用IBKR Python API获取期权数据失败，无价格返回求排查

尝试用Python调用IBKR API下载TSLA期权数据但未成功，以下是两段测试代码及对应输出：

第一段代码 #

from ibapi.client import EClient
from ibapi.wrapper import EWrapper
from ibapi.contract import Contract

import threading
import time


class IBapi(EWrapper, EClient):
    def __init__(self):
        EClient.__init__(self, self)
    def tickPrice(self, reqId, tickType, price, attrib):
        if tickType == 2 and reqId == 1:
            print('The current ask price is: ', price)

def run_loop():
    app.run()

app = IBapi()
app.connect('127.0.0.1', 7497, 123)

#Start the socket in a thread
api_thread = threading.Thread(target=run_loop, daemon=True)
api_thread.start()

time.sleep(1) #Sleep interval to allow time for connection to server

#Create contract object
contract = Contract()
contract.symbol = 'TSLA'
contract.secType = 'OPT'
contract.exchange = 'SMART'
contract.lastTradeDateOrContractMonth = '2023120'
contract.strike = 100
contract.right = 'C'
contract.multiplier = '100'


#Request Market Data
app.reqMktData(1, contract, '', False, False, [])

time.sleep(9) #Sleep interval to allow time for incoming price data
app.disconnect()

输出结果 #

ERROR -1 2104 Market data farm connection is OK:usfarm.nj
ERROR -1 2104 Market data farm connection is OK:cashfarm
ERROR -1 2104 Market data farm connection is OK:usfarm
ERROR -1 2106 HMDS data farm connection is OK:ushmds
ERROR -1 2158 Sec-def data farm connection is OK:secdefnj

第二段代码（重写tickOptionComputation回调） #

from ibapi.client import EClient
from ibapi.wrapper import EWrapper
from ibapi.contract import Contract

import threading
import time


class IBapi(EWrapper, EClient):
    def __init__(self):
        EClient.__init__(self, self)
    def tickOptionComputation(self, reqId, tickType, tickAttrib, impliedVol, delta, optPrice, pvDividend, gamma, vega, theta, undPrice):
             super().tickOptionComputation(reqId, tickType, tickAttrib, impliedVol, delta,
                                          optPrice, pvDividend, gamma, vega, theta, undPrice)
             print("TickOptionComputation. TickerId:", reqId, "TickType:", tickType, "TickAttrib:", (tickAttrib), "ImpliedVolatility:", (impliedVol), "Delta:", (delta), "OptionPrice:", (optPrice), "pvDividend:", (pvDividend), "Gamma: ", (gamma), "Vega:", (vega), "Theta:", (theta), "UnderlyingPrice:", (undPrice))

def run_loop():
    app.run()

app = IBapi()
app.connect('127.0.0.1', 7497, 123)

#Start the socket in a thread
api_thread = threading.Thread(target=run_loop, daemon=True)
api_thread.start()

time.sleep(1) #Sleep interval to allow time for connection to server

#Create contract object
contract = Contract()
contract.symbol = 'TSLA'
contract.secType = 'OPT'
contract.exchange = 'SMART'
contract.lastTradeDateOrContractMonth = '2023120'
contract.strike = 100
contract.right = 'C'
contract.multiplier = '100'


#Request Market Data
app.reqMktData(1, contract, '', False, False, [])

time.sleep(9) #Sleep interval to allow time for incoming price data
app.disconnect()

输出结果 #

ERROR -1 2104 Market data farm connection is OK:usfarm.nj
ERROR -1 2104 Market data farm connection is OK:cashfarm
ERROR -1 2104 Market data farm connection is OK:usfarm
ERROR -1 2106 HMDS data farm connection is OK:ushmds
ERROR -1 2158 Sec-def data farm connection is OK:secdefnj

问题排查与解决步骤 #

1. 修正期权合约参数 #

• 到期日格式错误：lastTradeDateOrContractMonth必须是YYYYMMDD格式，你写的2023120不合法。TSLA 2023年12月的期权到期日为12月15日（每月第三个周五），应改为'20231215'。
• 补充货币参数：添加contract.currency = 'USD'，明确合约计价货币，避免IBKR无法识别合约。

2. 确认市场数据权限 #

• 登录IBKR账户，检查是否订阅了美股期权的实时市场数据（如US Options权限）。无对应权限会导致无法获取数据。

3. 检查TWS/IB Gateway API设置 #

• 开启Active X and Socket Clients选项；
• 确认端口匹配：TWS模拟盘端口为7497，实盘为7496；IB Gateway模拟盘为4001，实盘为4002，确保代码中端口与TWS/Gateway设置一致；
• 允许本地IP访问，或设置为Allow connections from localhost only。

4. 完善回调函数 #

• 覆盖更多回调函数（如tickSize、tickGeneric、error），查看是否有错误提示或数据返回；
• 不要限制tickPrice的tickType，先打印所有类型的tick数据，确认是否有数据返回。

5. 避免固定Sleep时间 #

• 使用事件（threading.Event）替代固定sleep，等待回调触发后再断开连接，避免因网络延迟导致数据未接收完成。

修正后的示例代码 #

from ibapi.client import EClient
from ibapi.wrapper import EWrapper
from ibapi.contract import Contract

import threading
import time


class IBapi(EWrapper, EClient):
    def __init__(self):
        EClient.__init__(self, self)
        self.data_received = threading.Event()

    def tickPrice(self, reqId, tickType, price, attrib):
        print(f"tickPrice - reqId:{reqId}, tickType:{tickType}, price:{price}")
        if tickType in [1,2,4]: # BID, ASK, LAST
            self.data_received.set()

    def tickOptionComputation(self, reqId, tickType, tickAttrib, impliedVol, delta, optPrice, pvDividend, gamma, vega, theta, undPrice):
        print(f"TickOptionComputation - reqId:{reqId}, OptionPrice:{optPrice}, UnderlyingPrice:{undPrice}")
        self.data_received.set()

    def error(self, reqId, errorCode, errorString):
        print(f"Error - reqId:{reqId}, code:{errorCode}, msg:{errorString}")

def run_loop():
    app.run()

app = IBapi()
app.connect('127.0.0.1', 7497, 123)

api_thread = threading.Thread(target=run_loop, daemon=True)
api_thread.start()

time.sleep(1)

# 修正后的合约定义
contract = Contract()
contract.symbol = 'TSLA'
contract.secType = 'OPT'
contract.exchange = 'SMART'
contract.lastTradeDateOrContractMonth = '20231215' # 正确到期日
contract.strike = 100
contract.right = 'C'
contract.multiplier = '100'
contract.currency = 'USD' # 添加货币参数

app.reqMktData(1, contract, '', False, False, [])

# 等待数据接收或超时
app.data_received.wait(timeout=10)
app.disconnect()

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