Social Fetch
Start for freeStart free
Yahoo Finance hub

Yahoo Finance Options API

Expiries, strikes, calls and puts for one underlying ticker.

GET /v1/yahoo-finance/instruments/{symbol}/options

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/yahoo-finance/instruments/{symbol}/options returns data.expirations, data.strikes, data.hasMiniOptions, data.quote and data.options. Expiries are ISO 8601 dates. Each options entry has expirationDate, calls and puts, and each contract carries fields such as contractSymbol, strike, lastPrice, bid, ask, change, percentChange, volume, openInterest, impliedVolatility, inTheMoney, expiration and lastTradeDate.

Send expiration to read one expiry; otherwise the nearest expiry and the full data.expirations list are returned. The date must be one of those expiries; any other date is a 400 that says to omit it for the available dates. straddle=true pairs calls and puts by strike. An instrument without options returns an empty data.expirations list. The underlying quote is in data.quote.

Yahoo Finance Options API FAQ

How do I pick an expiry?

Send expiration as an ISO 8601 date, for example 2027-01-15. Read data.expirations first if you need the available dates.

What is in each option contract?

contractSymbol, strike, lastPrice, bid, ask, change, percentChange, volume, openInterest, impliedVolatility, inTheMoney, expiration and lastTradeDate, when available.

What does straddle do?

straddle=true pairs calls and puts by strike in the chain, which is easier to read when you compare both sides at the same strike.

What if the instrument has no options?

data.expirations and data.options are empty. That is a completed answer for an instrument without options, not a not_found symbol.

How many credits does this route cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Other Yahoo Finance endpoints