ib-option-chain

IB Option Chain

Fetch option chain data from Interactive Brokers for a specific expiration date.

Prerequisites

User must have TWS or IB Gateway running locally with API enabled:

• Paper trading: port 7497
• Live trading: port 7496

Instructions

First, get available expiration dates:

uv run python scripts/options.py SYMBOL --expiries

Then fetch the chain for a specific expiry:

uv run python scripts/options.py SYMBOL --expiry YYYYMMDD

Arguments

• SYMBOL - Ticker symbol (e.g., AAPL, SPY, TSLA)
• --expiries - List available expiration dates only
• --expiry YYYYMMDD - Fetch chain for specific date (IB format: YYYYMMDD, no dashes)
• --port - IB port (default: 7496 for live trading)

Output

Returns JSON with:

• calls - Array of call options with strike, bid, ask, lastPrice, volume, openInterest, impliedVolatility
• puts - Array of put options with same fields
• underlying_price - Current stock price for reference
• source - "ibkr"

Present data as a table. Highlight high volume strikes and notable IV levels.

Dependencies

• ib-async

Timezone

All timestamps and time-based calculations must use the America/New_York timezone. All JSON output must include generated_at (NY time string) and data_delay fields.