scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTQuote
  • POSTFundamentals
  • POSTChart
  • POSTNews
  • POSTOptions
  • POSTSearch

Yahoo Finance Options

1 credit

Get options chain data for a ticker symbol.

POST/api/v1/tools/yahoo-finance/options

Parameters

symbolstringrequired

Ticker symbol to get options chain for.

allExpirationsboolean

Fetch options for all expiration dates. Defaults to false.

datesstring[]

Specific expiration dates to fetch (ISO 8601).

Response Schema

dataobject

Yahoo Finance options result

optionsobject

Options chain data

metaobject

Request metadata

toolstring

Tool name (yahoo-finance-options)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/yahoo-finance/options \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "AAPL"
  }'

Response Example

{
  "data": {
    "options": {
      "underlyingSymbol": "AAPL",
      "expirationDates": [
        1714089600,
        1714694400
      ],
      "strikes": [
        150,
        155,
        160,
        165,
        170
      ],
      "hasMiniOptions": false,
      "options": [
        {
          "expirationDate": 1714089600,
          "hasMiniOptions": false,
          "calls": [
            {
              "contractSymbol": "AAPL260425C00190000",
              "strike": 190,
              "lastPrice": 9.25,
              "bid": 9.1,
              "ask": 9.4,
              "volume": 1523,
              "openInterest": 8420,
              "impliedVolatility": 0.2845,
              "inTheMoney": true
            }
          ],
          "puts": [
            {
              "contractSymbol": "AAPL260425P00190000",
              "strike": 190,
              "lastPrice": 1.15,
              "bid": 1.1,
              "ask": 1.2,
              "volume": 892,
              "openInterest": 5310,
              "impliedVolatility": 0.2912,
              "inTheMoney": false
            }
          ]
        }
      ]
    }
  },
  "meta": {
    "tool": "yahoo-finance-options",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}