Basic Prerequisites: Black–Scholes–Merton and Stochastic Calculus & Itô’s Lemma. (these are the folder-level prerequisites for pages 02–06; page 01 states its own, smaller, entry requirements)


1. Intuition & Practical Objective

Black–Scholes–Merton has one free parameter, the volatility . If the model were true, inverting every liquid option price back to its implied volatility would return the same number for every strike and every maturity. It never does. The inverted number traces a surface - downward-sloping in strike for equities (“the skew”), U-shaped for FX (“the smile”), flattening with maturity. That surface is the empirical object and this folder is its topic-hub.

The one-sentence essence:

The volatility surface is the language in which the market quotes all of its options; a model is “right” only if it not only reproduces today’s surface (statics) but also moves it the way the market moves it (dynamics).

This folder is a hub: (a) the fast formula lookup below, and (b) six sub-pages from raw intuition through Dupire local volatility, SVI surface models, skew dynamics, failure modes, and the extensions (Heston/SABR/rough vol).


2. Mathematical Ground Truth & Derivations

Notation: spot, forward, strike, maturity, log-moneyness, total implied variance, BS gamma, the normal density.

Quick-Reference Lookup (job #1). Every formula below is transcribed from the verified corpus (Gatheral, The Volatility Surface, ch 1–8; Bergomi, Stochastic Volatility Modeling, ch 2–7) and the numbers in the check column were re-executed from the scripts in §3 and the sub-pages.

QuantityFormulaVerified check
Implied vol (definition)solve skew slice recovered exactly (28/24/20/17/15%)
Breeden–Litzenberger densitymin density for an arbitrage-free SVI slice
Dupire local variance (strike form, eq 1.6 / 6.2): ; flat vol:
Dupire in implied total variance (eq 1.10)identical to the strike form (both )
Local var = conditional expectation (eq 1.12)(Gyöngy) structural identity
SVI (eq 3.20, Gatheral 2004)ATM , ATM skew
Variance swap / log contract (eq 4.21/5.17)flat smile: exactly
Implied var = gamma-weighted avg of local var (eq 2.32/3.5)the structural bridge LV↔IV
ATMF skew ≈ path-average of local skew (eq 3.11/2.48); constant implied skew is half the local skew
Skew stickiness ratio (eq 2.61/2.64)decaying equity skew → ; constant skew →
Heston short-dated variance skew (eq 3.19/7.3)computed vs
Jump compensator skew (eq 5.10)additive with SV at
Rough/vol-of-vol benchmark (Bergomi eq 7.40), power-law vol-of-vol term structure

Critical caveat (flagged in the corpus). Gatheral’s printed ATM term-structure formula (3.18), built from the unconditional expected-variance path, returns the long-run mean as , not the current instantaneous variance . The physical short-dated limit is ; treat (3.18)‘s literal value accordingly (verified numerically: it returns , not ).


3. Computational Implementation - the surface engine

Stdlib only (math, cmath) - no numpy/scipy. The recurring primitives are the BSM call, its vega, and a Newton implied-vol inverter. Every script in this folder reproduces the numbers in §2; the sub-pages carry the full listings.


4. Failure Modes & First-Principles Breakdowns

Hub signposts - the folder’s failure-mode analysis lives in 05 · Failure Modes & Practice. In one line each:

  1. Static fit ≠ correct dynamics. Local volatility calibrates today’s surface exactly yet generates forward skews that are too flat - it misprices cliquets, barriers, digitals (Gatheral ch 8/10; Bergomi ch 2).
  2. Arbitrage-free interpolation is hard. Unconstrained splines produce negative densities (, butterfly) or decreasing total variance (, calendar).
  3. The short-end smile needs jumps, not just SV. No time-homogeneous stochastic-vol model reproduces the observed skew decay; the compensator of a jump component is required (Gatheral ch 5, 7).

5. References

  • Gatheral, Jim: The Volatility Surface: A Practitioner’s Guide (Wiley, 2006)
  • Bergomi, Lorenzo: Stochastic Volatility Modeling (CRC, 2016)
  • Hull, John C.: Options, Futures, and Other Derivatives (11th ed.)
  • Haug, Espen Gaarder: The Complete Guide to Option Pricing Formulas (2nd ed.)

6. Connected Graph Bridges

Beginner: start at 01 · Practitioner: start at 05