Yahoo Finance

Get Yahoo Finance option chain

Get Yahoo Finance option expiries, strikes, calls and puts.

GET/v1/yahoo-finance/instruments/{symbol}/options
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
symbolstringrequiredpath

Ticker symbol, case-insensitive, e.g. `AAPL`, `^GSPC`, `EURUSD=X`, `BTC-USD`, `7203.T`.

min 1 chars · max 40 chars · pattern: ^[A-Za-z0-9^=.-]+$

expirationstringoptionalquery

Expiry date in ISO 8601 form, for example `2026-12-18`. Must be one of the dates returned in `expirations`; omit it for the nearest expiry.

straddlebooleanoptionalquery

Pair calls and puts by strike. Default: false.

Response fields
15

Endpoint-specific response payload.

datalookupStatus
string

Whether the entity was found. HTTP 200 for both outcomes; branch on this field.

one of: found, not_found

datasymbol
string

Ticker symbol the chain is for.

All expiry dates, ISO 8601 UTC.

dataexpirations[]
stringoptional

Strikes on the returned chain.

datastrikes[]
numberoptional
datahasMiniOptions
booleannullable

Whether the chain has mini options; null when not reported.

dataquote
objectnullable

The underlying quote record.

The chain: `expirationDate`, `calls[]` and `puts[]`.

dataoptions[]
objectoptional

A Yahoo Finance JSON record, normalised.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/yahoo-finance/instruments/SPY/options" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Yahoo Finance option chain.