# Yahoo Finance Options chains API (yahoo_finance.options)

- Canonical page: https://everyinfra.com/en/yahoo-finance-api/options
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "yahoo_finance", "action": "options", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- Mode: sync; add "mode": "async" for slow tasks

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.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=yahoo_finance&action=options

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | 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. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| contract_symbol | platform-native meaning |
| strike | platform-native meaning |
| last_price | platform-native meaning |
| bid | platform-native meaning |
| ask | platform-native meaning |
| volume | platform-native meaning |
| open_interest | platform-native meaning |
| implied_volatility | platform-native meaning |
| in_the_money | platform-native meaning |
| expiration | platform-native meaning |
| symbol | platform-native meaning |
| expiration_dates | platform-native meaning |
| strikes | platform-native meaning |
| calls | platform-native meaning |
| puts | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```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"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "yahoo_finance",
        "action": "options",
        "params": {
            "keyword": "AAPL",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real 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.

```text
{
  "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": { … }
}
```

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

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=yahoo_finance
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
