Yahoo Finance Options chains API
API health
- 24h health
- Normal
- Healthy / normal
- Available
- Limited
- Mostly down
Last 24 hours
Last 30 days
Scan the options chain for one Yahoo Finance ticker, with calls and puts showing strike, last price, bid, ask, volume, open interest and implied volatility. There is no expiration parameter, so check expiration for the date returned and expiration_dates for the full list.
Send POST https://api.everyinfra.com/api/v1/social with platform set to yahoo_finance and action set to options. Price $1.39 per 1,000 requests ($0.001389 per call). Failed calls and empty results are not charged. Synchronous. For slow jobs add "mode": "async" to the body, take the job_id and poll.
Yahoo Finance Options chains reads the listed options for one ticker, passed as keyword, and returns the chain as a single object: the symbol, every expiration date in expiration_dates, every strike level in strikes, and the contracts in calls and puts. For each contract you get its contract_symbol, strike, last_price, bid, ask, volume, open_interest, implied_volatility and an in_the_money flag. Options traders, quantitative researchers and fintech developers use it to scan strikes, follow implied volatility and see where open interest builds up.
Pass the ticker exactly as Yahoo Finance writes it, such as AAPL, keeping any market suffix; a company name is not searched. There is no parameter for choosing an expiration, so check expiration to know which date the returned contracts belong to, and treat expiration_dates as the full calendar. last_price is the most recent trade, which on a quiet contract may be old, while bid and ask show where the market stood at the time of the call.
AI prompt
#Please help me write a data collection script with the EveryInfra Yahoo Finance Options chains endpoint (yahoo_finance/options).
How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to yahoo_finance and action to options, and put the parameters inside params.
- Required parameters:
- keyword: Specifies a single Yahoo Finance ticker symbol (e.g., AAPL) with required exchange suffixes retained. It does not perform full-text company name searches.
- Returns one object. Main fields: contract_symbol, strike, last_price, bid, ask, volume, open_interest, implied_volatility, in_the_money, expiration, symbol, expiration_dates; 15 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=yahoo_finance.
- Example request body:
{
"platform": "yahoo_finance",
"action": "options",
"params": {
"keyword": "AAPL"
}
}
- Price: $1.39 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.
Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.Request parameters
#| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
Authorization | header | string | Yes | - | Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository. |
platform | body | string | Yes | yahoo_finance | Platform identifier, fixed value. |
action | body | string | Yes | options | Capability identifier, fixed value. |
keyword | body.params | string | Yes | - | Specifies a single Yahoo Finance ticker symbol (e.g., AAPL) with required exchange suffixes retained. It does not perform full-text company name searches. The history, financials, news, analyst, and options actions process one ticker per request to retrieve historical market data, financial statements, news items, analyst coverage, or options chains. |
Code samples
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "yahoo_finance",
"action": "options",
"params": {
"keyword": "AAPL"
}
}'OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.
Response example
#{ "id": "req_…", "platform": "yahoo_finance", "action": "options", "results": { "symbol": "AAPL", "expiration_dates": [ "2026-09-28T00:00:00+00:00", "2026-09-30T00:00:00+00:00", "2026-10-02T00:00:00+00:00" ], "strikes": [ 250, 255, 265 ], "calls": [ { "contract_symbol": "AAPL260928C00250000", "strike": 250, "last_price": 89.85, "bid": 89.25, "ask": 92.7, "volume": 1, "open_interest": 1, "implied_volatility": 2.24365673461914, "in_the_money": true, "expiration": "2026-09-28T00:00:00+00:00" }, { "contract_symbol": "AAPL260928C00265000", "strike": 265, "last_price": 72.52, "bid": 74.05, "ask": 77.75, "volume": 4, "open_interest": 5, "implied_volatility": 1.9111332568359376, "in_the_money": true, "expiration": "2026-09-28T00:00:00+00:00" }, { "contract_symbol": "AAPL260928C00270000", "strike": 270, "last_price": 65.74, "bid": 69.05, "ask": 72.95, "volume": 2, "open_interest": 3, "implied_volatility": 1.84765701171875, "in_the_money": true, "expiration": "2026-09-28T00:00:00+00:00" } ], "puts": [ { "contract_symbol": "AAPL260928P00250000", "strike": 250, "last_price": 0.01, "bid": 0, "ask": 0.01, "volume": 7, "open_interest": 4, "implied_volatility": 1.0625046875000002, "in_the_money": false, "expiration": "2026-09-28T00:00:00+00:00" }, { "contract_symbol": "AAPL260928P00255000", "strike": 255, "last_price": 0.01, "bid": 0, "ask": 0.01, "volume": 2, "open_interest": 4, "implied_volatility": 1.000005, "in_the_money": false, "expiration": "2026-09-28T00:00:00+00:00" }, { "contract_symbol": "AAPL260928P00265000", "strike": 265, "last_price": 0.05, "bid": 0, "ask": 0.01, "volume": 36, "open_interest": 12, "implied_volatility": 0.87500125, "in_the_money": false, "expiration": "2026-09-28T00:00:00+00:00" } ], "platform": "yahoo_finance" }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Response fields
#Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.
| Field | Meaning |
|---|---|
contract_symbol | Keeps the platform's own meaning |
strike | Keeps the platform's own meaning |
last_price | Keeps the platform's own meaning |
bid | Keeps the platform's own meaning |
ask | Keeps the platform's own meaning |
volume | Keeps the platform's own meaning |
open_interest | Keeps the platform's own meaning |
implied_volatility | Keeps the platform's own meaning |
in_the_money | Keeps the platform's own meaning |
expiration | Keeps the platform's own meaning |
symbol | Keeps the platform's own meaning |
expiration_dates | Keeps the platform's own meaning |
strikes | Keeps the platform's own meaning |
calls | Keeps the platform's own meaning |
puts | Keeps the platform's own meaning |
platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
FAQ
#How do I choose an expiration date?
#You cannot pick one in the request: the capability takes only keyword, with no expiration selector. The response lists every available expiration in expiration_dates, and expiration shows which date the returned contracts belong to. Store that date with every row, so chains read on different days line up when you compare them.
What should I pass as keyword?
#One ticker symbol exactly as it appears on Yahoo Finance, such as AAPL, with its market suffix kept when the symbol has one. Company names are not searched, and each call reads a single ticker. To see the underlying's own quote and fundamentals, pass the same symbol to the Yahoo Finance Search capability.
How do I tell whether a contract trades actively?
#Look at volume, the trading volume, and open_interest, the contracts still open, then at the gap between bid and ask. Little volume, low open interest and a wide spread mean last_price may be stale and the contract hard to trade near that price. Treat implied_volatility from such contracts with care when you build a volatility curve.
Errors and billing
#- 401
- Missing or invalid key.
- 402
- Insufficient balance. Top up first.
- 422
- Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
- 429
- Per-minute request limit reached. Wait for Retry-After, then try again.
- 503
- Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
- 200 empty
- No data. No charge.
Official references
#Used only to check objects and terms. They do not imply authorization or endorsement of EveryInfra by the platform.
- Yahoo Finance: Ticker Suffixes, Exchange Delays, and Information Use ↗
Official guidance explains that exchange ticker suffixes and data delays vary, defining data strictly for informational purposes. This explains ticker symbol and market data freshness boundaries; it does not prove that this endpoint supports real-time trading.
Checked 2026-09-05