POST

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

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

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesyahoo_financePlatform identifier, fixed value.
actionbodystringYesoptionsCapability identifier, fixed value.
keywordbody.paramsstringYes-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

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

#
Captured September 26, 2026 at 08:56 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed. id, billing and quota differ on every call, so only their shape is shown.
json
{  "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.

FieldMeaning
contract_symbolKeeps the platform's own meaning
strikeKeeps the platform's own meaning
last_priceKeeps the platform's own meaning
bidKeeps the platform's own meaning
askKeeps the platform's own meaning
volumeKeeps the platform's own meaning
open_interestKeeps the platform's own meaning
implied_volatilityKeeps the platform's own meaning
in_the_moneyKeeps the platform's own meaning
expirationKeeps the platform's own meaning
symbolKeeps the platform's own meaning
expiration_datesKeeps the platform's own meaning
strikesKeeps the platform's own meaning
callsKeeps the platform's own meaning
putsKeeps the platform's own meaning
platformSource 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.

Errors

Official references

#

Used only to check objects and terms. They do not imply authorization or endorsement of EveryInfra by the platform.

Google Analytics needs consent. Privacy