mcpField
O
option-chain

option-chain

github.com/staskhOther394107 installsUpdated 1d ago
Repository

About option-chain

A skill for retrieving option-chain data from Yahoo Finance for a selected ticker and expiration. It can list available expirations and return call and put contract details for examining quotes, activity, and implied volatility.

Key features

  1. 01List available expiration dates
  2. 02Fetch a chain for a selected date
  3. 03Return call and put contract fields
  4. 04Include the underlying price

Use cases

  1. 01Inspect calls and puts for an expiration
  2. 02Find strikes with notable volume or open interest
  3. 03Review implied volatility alongside the underlying price

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/staskh/trading_skills --skill option-chain

After installing, type/option-chainin Claude Code to confirm it loaded.

Bundled filesscripts/options.py

Details

From the project README

Option Chain

Fetch option chain data from Yahoo Finance for a specific expiration date.

Instructions

Note: If uv is not installed or pyproject.toml is not found, replace uv run python with python in all commands below.

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 YYYY-MM-DD

Arguments

  • SYMBOL - Ticker symbol (e.g., AAPL, SPY, TSLA)
  • --expiries - List available expiration dates only
  • --expiry YYYY-MM-DD - Fetch chain for specific date

Output

Returns JSON with:

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

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

Dependencies

  • pandas
  • yfinance

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.

Comments

Markdown supported