Skip to main content

​
yf_ticker_options

Get the complete options chain for a ticker, including both calls and puts contracts for a specified expiration date.

​
Parameters

​
ticker
string
required
Ticker symbol, e.g. AAPL
​
date
string
Options expiration date in YYYY-MM-DD format. If not specified, returns data for the nearest expiration date.
​
tz
string
Timezone for date interpretation (e.g. “America/New_York”, “UTC”). Defaults to the exchange’s timezone.
​
response_format
string
default:"json"
Output format: “json” or “markdown”
​
preview_limit
number
default:25
Number of rows to preview when using markdown format (min: 1, max: 200)
​
save
object
Save options for exporting data to a file

​
Example Usage

{
  "ticker": "AAPL",
  "date": "2024-12-20"
}

​
Data Structure

The tool returns an options chain containing two main components:
  • calls: Array of call option contracts
  • puts: Array of put option contracts
Each contract includes:
  • Strike price
  • Last traded price
  • Bid and ask prices
  • Volume
  • Open interest
  • Implied volatility
  • Contract symbol
  • Last trade date
  • Additional option metrics

​
Response Example

{
  "data": {
    "calls": [
      {
        "contractSymbol": "AAPL241220C00100000",
        "strike": 100.0,
        "lastPrice": 85.25,
        "bid": 85.00,
        "ask": 85.50,
        "volume": 1250,
        "openInterest": 5420,
        "impliedVolatility": 0.2534
      }
    ],
    "puts": [
      {
        "contractSymbol": "AAPL241220P00100000",
        "strike": 100.0,
        "lastPrice": 0.15,
        "bid": 0.12,
        "ask": 0.18,
        "volume": 850,
        "openInterest": 3210,
        "impliedVolatility": 0.1823
      }
    ]
  },
  "saved_path": null
}

​
Use Cases

  • Analyze available strike prices and expiration dates
  • Compare call and put option premiums
  • Evaluate implied volatility across strikes
  • Identify high-volume or high-interest contracts
  • Build options trading strategies

Build docs developers (and LLMs) love

Get started for freeTalk to us