Yahoo Finance API: Get options chain (v1)

Returns the calls and puts for one expiration, with bid, ask, volume, open interest and implied volatility, plus every listed expiration date. data is null for an unknown ticker.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

symbol*string

A Yahoo Finance ticker such as AAPL, BRK-B, RELIANCE.NS, ^GSPC, BTC-USD or EURUSD=X, or its finance.yahoo.com quote link. Find a ticker by company name with Search.

Lengthlength <= 1000

expiration?string

Expiration date (YYYY-MM-DD) from expiration_dates in an earlier answer. Omit for the nearest expiration. A date with no contracts returns empty calls and puts.

Match^\d{4}-\d{2}-\d{2}$

curl -X GET "https://example.com/v1/yahoo-finance/options?symbol=AAPL" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "symbol": "AAPL",    "underlying_price": 343.17,    "currency": "USD",    "expiration_date": "2026-11-06",    "expiration_dates": [      "2026-11-06",      "2026-11-09",      "2026-11-11"    ],    "strikes": [      0    ],    "calls": [      {        "contract_symbol": "AAPL261106C00340000",        "strike": 340,        "currency": "USD",        "last_price": 0,        "change": 0,        "change_percent": -12.5,        "bid": 0,        "ask": 0,        "volume": 0,        "open_interest": 0,        "implied_volatility_percent": 28.4,        "in_the_money": true,        "contract_size": "REGULAR",        "last_trade_at": "2026-11-05T21:00:00Z"      }    ],    "puts": [      {        "contract_symbol": "AAPL261106C00340000",        "strike": 340,        "currency": "USD",        "last_price": 0,        "change": 0,        "change_percent": -12.5,        "bid": 0,        "ask": 0,        "volume": 0,        "open_interest": 0,        "implied_volatility_percent": 28.4,        "in_the_money": true,        "contract_size": "REGULAR",        "last_trade_at": "2026-11-05T21:00:00Z"      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}