StockData/API
Browse the docs

Options chain API

A full option chain per expiration: calls and puts with strike, bid, ask, volume, open interest and implied volatility, plus every expiration date.

GET/v7/finance/options/{symbol}

Request

curl -H "x-api-key: $KEY" \
  "https://api.stockdataapi.com/v7/finance/options/AAPL"

Send your key in the x-api-key header. Try it in the browser with your own key.

Parameters

symbol
pathstringrequired
Symbol such as AAPL, BRK-B, ^GSPC, ES=F, BTC-USD or M&M.NS. Letters, digits and . ^ = & -, at most 20 characters, case-insensitive. Percent-encode ^, = and & in a URL (%5EGSPC, ES%3DF, M%26M.NS).
date
queryinteger
Expiration to serve, as epoch seconds at 00:00 UTC of the expiration day (a value from expirationDates). Omitted: the nearest expiration that still trades.
refresh
queryboolean
true asks the source at call time, skipping the cache and the staleness window, and writes the result back for other callers (X-Cache: BYPASS). Forced fetches spend a small per-minute budget of your own; past it, the call quietly serves the normal path.
Default: false

Behavior

  • Without date you get the nearest expiration that still trades. On an expiration day that is the day's own (0DTE) chain, served through the end of that day.
  • expirationDates holds only expirations that still trade, and the one served is always in it. A settled chain stays servable with its date.
  • A chain older than 2 minutes is refetched from the source by default.
  • A symbol with no listed options answers 200 with an empty result.

Example response

{
  "optionChain": {
    "result": [
      {
        "underlyingSymbol": "AAPL",
        "expirationDates": [1787961600, 1790380800],
        "strikes": [220, 230, 240],
        "hasMiniOptions": false,
        "quote": {
          "symbol": "AAPL",
          "regularMarketPrice": 230.5,
          "marketState": "REGULAR"
        },
        "options": [
          {
            "expirationDate": 1787961600,
            "hasMiniOptions": false,
            "calls": [
              { "contractSymbol": "AAPL260828C00230000", "strike": 230.0,
                "lastPrice": 4.1, "bid": 4.0, "ask": 4.2, "volume": 1200,
                "openInterest": 8400, "impliedVolatility": 0.24,
                "inTheMoney": true, "expiration": 1787961600,
                "currency": "USD" }
            ],
            "puts": [
              { "contractSymbol": "AAPL260828P00230000", "strike": 230.0,
                "lastPrice": 3.6, "bid": 3.5, "ask": 3.7, "volume": 950,
                "openInterest": 7200, "impliedVolatility": 0.26,
                "inTheMoney": false, "expiration": 1787961600,
                "currency": "USD" }
            ]
          }
        ]
      }
    ],
    "error": null
  }
}
json

Related endpoints

Every plan includes this endpoint.

Create your free key