Option Quote API - Options Chain with Greeks and IV - FlashAlpha Lab API
FlashAlpha Logo
Lab API Option Quote

Option Quote API

Retrieve options chain data enriched with BSM Greeks, implied volatility, open interest, and volume.

New to options Greeks? Options Greeks Guide explains delta, gamma, theta, vega, and higher-order Greeks.
Works with CME index futures. Pass ES=F or NQ=F and URL-encode the = as %3D - e.g. /optionquote/ES%3DF. Options-on-futures are priced with Black-76 using the CME multiplier ($50/pt ES, $20/pt NQ); CME index futures are Growth-tier. See the futures hub.
α SVI-Smoothed IV - Alpha Plan

The svi_vol field uses Gatheral's SVI parametric fit to produce stable, arbitrage-free implied volatility. Alpha also unlocks /v1/adv_volatility - raw SVI parameters, variance surface grids, arbitrage detection, greeks surfaces, and variance swap pricing.

Non-Alpha plans receive "REQUIRES_ALPHA_TIER" for this field. All other fields work on Growth and above.

Upgrade to Alpha →

Filter Behavior

  • No filters - returns all contracts for the symbol (array)
  • Partial filters - returns matching subset (array)
  • All three filters (expiry, strike, type) - returns a single contract (object)

Endpoint

GET /optionquote/{ticker}

Authentication: Required - X-Api-Key header

Rate Limited: Yes

Plan: Requires Growth plan or higher

Parameters

Name In Required Description
ticker path required Underlying symbol
expiry query optional Expiration date (yyyy-MM-dd)
strike query optional Strike price
type query optional C or Call (call), P or Put (put)

Example Request

curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://lab.flashalpha.com/optionquote/SPY?expiry=2026-03-20&strike=590&type=C"
import requests

resp = requests.get(
    "https://lab.flashalpha.com/optionquote/SPY",
    headers={"X-Api-Key": "YOUR_API_KEY"},
    params={"expiry": "2026-03-20", "strike": 590, "type": "C"}
)
data = resp.json()
print(f"Delta: {data['delta']}, IV: {data['implied_vol']}")
const params = new URLSearchParams({
  expiry: "2026-03-20", strike: "590", type: "C"
});
const resp = await fetch(
  `https://lab.flashalpha.com/optionquote/SPY?${params}`,
  { headers: { "X-Api-Key": "YOUR_API_KEY" } }
);
const data = await resp.json();
console.log(`Delta: ${data.delta}, IV: ${data.implied_vol}`);

Response 200 OK

{
  "underlying": "SPY",
  "type": "C",
  "expiry": "2026-03-20",
  "strike": 590.0,
  "bid": 15.25,
  "ask": 15.35,
  "mid": 15.30,
  "bidSize": 1200,
  "askSize": 1500,
  "lastUpdate": "2026-02-28T16:30:45Z",
  "implied_vol": 0.1823,
  "delta": 0.6543,
  "gamma": 0.0089,
  "theta": -0.0234,
  "vega": 0.0456,
  "rho": 0.1234,
  "vanna": 0.0078,
  "charm": -0.0045,
  "svi_vol": 0.1820,       // Returns "REQUIRES_ALPHA_TIER" on non-Alpha plans
  "open_interest": 45000,
  "volume": 3250
}

Response Fields

Field Type Description
underlying string Underlying symbol
type string C for call, P for put
expiry string Expiration date
strike number Strike price
bid / ask / mid number Quote prices
bidSize / askSize number Size at bid/ask
lastUpdate string ISO 8601 timestamp
implied_vol number BSM implied volatility from mid price
delta number Rate of change per $1 move (delta). Calls 0-1, Puts −1 to 0
gamma number Rate of change of delta (gamma). Highest near ATM
theta number Daily time decay in dollars
vega number Price change per 1% IV move (vega)
rho number Sensitivity to 1% rate change
vanna number dDelta/dVol - how delta changes when IV moves (vanna)
charm number dDelta/dTime - how delta changes as time passes (charm)
svi_vol number SVI-smoothed IV (Gatheral parametric fit). Returns "REQUIRES_ALPHA_TIER" on non-Alpha plans. Alpha plan only
open_interest number Open interest
volume number Daily volume

Errors

Status Description
400 Invalid expiry format or unrecognized type value
403 Requires Growth plan or higher
404 No matching options found for the given filters

What Is the Option Quote Endpoint?

The Option Quote endpoint returns live options contract data for any tracked underlying. Each contract includes standard quote fields (bid, ask, mid), the full set of Black-Scholes-Merton Greeks (delta, gamma, theta, vega, rho, vanna, charm), implied volatility, open interest, and daily volume. The svi_vol field contains SVI-smoothed implied volatility and requires the Alpha plan - non-Alpha plans receive "REQUIRES_ALPHA_TIER". You can query the entire chain, filter by expiration or type, or pinpoint a single contract by specifying all three filters.

Common Use Cases

  • Options screening - scan an entire chain to find contracts matching specific delta, implied_vol, or open_interest criteria
  • Greeks analysis - read delta, gamma, theta, vega, vanna, and charm for risk assessment and position sizing
  • Volatility surface construction - use implied_vol (or Alpha's svi_vol) across strikes and expirations to build a vol surface
  • Liquidity filtering - gate entries on open_interest, volume, and the bid/ask spread to avoid thin contracts
  • Spread pricing - pull mid quotes for multiple legs to price vertical spreads, iron condors, or calendar spreads
  • Execution monitoring - track the bid/ask spread and volume against lastUpdate to time entries and exits

Related reading

Complementary endpoints

  • Liquidity - rank contracts by tradability before you act on a quote
  • Structure Greeks - aggregate these per-contract Greeks across a multi-leg position
  • Volatility - put a contract's IV in context of the term structure and surface

Ready to build?

Get your free API key and start pulling live options data in 30 seconds.