Volatility Surface

Canonical definition, structure, interpretation rules, and live API reference for the implied volatility surface.

Definition

A volatility surface is the three-dimensional map of implied volatility across every strike and expiration for one underlying. Its two cross-sections are the smile or skew (IV across strikes) and the term structure (IV across expirations). Traders use it to price options consistently and find relative value.

Formula
IV = σ(K, T)

Implied volatility as a function of strike K and expiration T. Slicing at fixed T gives the smile/skew; slicing at fixed K (usually ATM) gives the term structure. FlashAlpha fits the grid per expiration with SVI and interpolates across expirations.

Inputs
live option quotes forward price strikes & expirations
Output
IV grid (strike × expiry) SVI params per tenor (Alpha) ArbFlag diagnostic (Alpha)

SVI parameters and the butterfly-arbitrage diagnostic come from the Alpha-tier /v1/surface/svi/{symbol} endpoint, not the public sample below.

Interpretation
  • Smile / skew slice: IV across strikes at one expiration. Shows relative demand for downside puts vs upside calls.
  • Term structure slice: IV across expirations at one strike, usually ATM. Shows whether the market expects near-term or long-term vol to be higher.
  • Wings: the deep OTM ends of each expiration's smile. FlashAlpha's SVI fit bounds wing behavior and checks butterfly arbitrage continuously, flagging violations as a diagnostic (ArbFlag) rather than eliminating them by assumption.

Reading the Surface

A full option chain gives you dozens of individual implied volatilities, one per strike/expiration pair. The surface organizes them into two cross-sections that are each easier to read on their own.

The first cross-section is the skew (or smile): fix one expiration and look at IV across strikes. OTM puts almost always trade at higher IV than OTM calls in equity index options - the market pays up for downside protection. The steepness of that slope is the skew.

The second cross-section is the term structure: fix one strike, usually at-the-money, and look at IV across expirations. A rising curve (contango) is the normal state; an inverted curve (backwardation) signals the market is pricing near-term stress higher than long-term uncertainty.

Away from the money, each expiration's smile flattens into its wings. Raw market quotes get thin and noisy out there, so FlashAlpha fits the whole surface expiration-by-expiration with SVI, Gatheral's 5-parameter parameterization, which produces smooth, wing-bounded curves and interpolates across expirations to fill in the full grid.

Live Example: SPY

Live SPY surface data temporarily unavailable. See /tools/vol-surface for current values.

Get the Surface via API

Endpoint
GET /v1/surface/{symbol}
Tier
Public - no API key required
Parameters
  • symbol (path, required) - underlying ticker, e.g. SPY
Response shape
{
  "symbol": "SPY",
  "spot": 580.51,
  "grid_size": 50,
  "tenors": [ 0.02, 0.05, "..." ],
  "moneyness": [ -0.25, 0, "...", 0.25 ],
  "iv": [ [ 0.22, 0.19, "..." ], "..." ]
}
curl https://lab.flashalpha.com/v1/surface/SPY
import requests
r = requests.get("https://lab.flashalpha.com/v1/surface/SPY")
d = r.json()
print(f"Grid: {d['grid_size']}x{d['grid_size']}  Tenors: {len(d['tenors'])}")
const r = await fetch("https://lab.flashalpha.com/v1/surface/SPY");
const d = await r.json();
console.log(`Grid: ${d.grid_size}x${d.grid_size}  Tenors: ${d.tenors.length}`);

Why the Volatility Surface Matters for Trading

TL;DR

A single IV number hides two dimensions of information. The surface exposes them: the smile prices strike risk, the term structure prices time risk, and most relative-value vol trades are a bet on one slice being mispriced against another.

What it measures
Implied volatility as a function of both strike and expiration, fit from live option quotes.
What it signals
Where the market is paying up for risk - which strikes (skew) and which expirations (term structure) carry the richest premium.
Why we measure it
Pricing any option consistently with the rest of the chain, and spotting relative-value mispricings, requires the whole surface - not one ATM IV print.
Who uses it
Market makers, vol arbitrage desks, dispersion traders, and anyone pricing or hedging an option away from the exact strike/expiry they last quoted.

Rules of thumb

  • One IV number is never the full picture. ATM IV is a single cross-section of the surface - always check the skew and term structure before pricing an OTM or far-dated option off it.
  • Skew steepens with fear. A steepening put skew usually means the market is bidding up crash protection, independent of the level of ATM IV.
  • Backwardation is a stress signal. Near-dated IV trading above far-dated IV (term structure inverted) typically shows up around known event risk or active market stress.
  • Wings are model output, not raw quotes. Deep OTM strikes are illiquid; their IV comes from the SVI fit, bounded and diagnosed for butterfly arbitrage rather than trusted as literal market prices.
  • Pair with realized vol. The surface tells you what the market is pricing; compare against realized volatility to judge whether that pricing is rich or cheap.

Frequently asked questions

What is a volatility surface?
A volatility surface is the three-dimensional map of implied volatility across every strike and expiration for one underlying. Its two cross-sections are the smile or skew (IV across strikes) and the term structure (IV across expirations). Traders use it to price options consistently and find relative value.
What is the difference between the smile and the term structure?
The smile (or skew) is the surface sliced at one expiration: IV across strikes. The term structure is the slice at one strike, usually at-the-money: IV across expirations. The full surface combines both, and most vol trades are a view on one slice being mispriced against the other.
How is an implied volatility surface built?
From live option quotes: solve each option's IV, then fit a smooth arbitrage-aware parameterization such as SVI per expiration and interpolate across expirations. FlashAlpha fits SVI surfaces from live quotes and serves them via the /v1/surface endpoint; wing behavior is bounded and butterfly arbitrage is flagged as a diagnostic.
Ship faster

Live for 6,000+ US symbols. One API call, sub-200ms.

Stop scraping chains and coding Black-Scholes from scratch. FlashAlpha computes GEX, DEX, VEX, CHEX, 15 BSM Greeks, SVI surfaces, max pain, VRP and more - with tiered freshness (Free 15-min cache, paid tiers as low as 15s). Free tier, no credit card required.

Free · 5/day
Single-expiry GEX (equities), key levels, gamma flip, 15 BSM Greeks. No card.
Basic · 100/day
DEX, VEX, CHEX, full max pain, plus ETF & index symbols.
Growth & Alpha
Full-chain GEX, 0DTE & flow (Growth); SVI surfaces, VRP, directional VRP (Alpha).