> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/yahoo-finance/instruments-symbol-options>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/yahoo-finance/instruments-symbol-options.mdx>

---

# Yahoo Finance Options API

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

`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`.

## Request

- **Endpoint:** `GET /v1/yahoo-finance/instruments/{symbol}/options`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by ticker and expiry
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/yahoo-finance/instruments/symbol/options/get)
- **Platform page:** [/platforms/yahoo-finance](https://www.socialfetch.dev/platforms/yahoo-finance)

## 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.