Basic Prerequisites: Volatility Surfaces & Smiles 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 and it is the wrong kind of object: a constant. Real volatility is itself a random process - it clusters, it mean-reverts, and it moves against the equity market. Once you accept that, the pricing problem changes shape: you have a second risk factor, you cannot hedge it with the underlying alone, and you must choose a dynamics - not merely a curve. This folder is the topic-hub for the two models that define the modern answer: Heston (1993), the tractable stochastic-volatility (SV) process with a quasi-closed-form price, and SABR (Hagan et al. 2002), the tractable smile expansion.

The one-sentence essence:

Stochastic volatility fixes Black–Scholes’ single- failure by making variance a mean-reverting, spot-correlated diffusion; Heston makes that model computable (affine characteristic function ⇒ one-dimensional Fourier inversion) and SABR makes its smile closed-form in the short-expiration limit - but the smile’s shape barely discriminates between models, so the model choice is settled by the dynamics (vol-of-vol, skew term structure, skew stickiness), not by the static fit.

This folder is a hub: (a) the fast formula lookup below, and (b) six sub-pages that walk from raw intuition through the Heston SDE and its characteristic function, the SABR expansion and the short-expiration asymptotics, the Bergomi–Guyon dynamics, calibration/hedging practice, and the frontier (forward-variance, LSV, rough vol).


2. Mathematical Ground Truth & Derivations

Notation. spot, forward, strike, maturity, , instantaneous variance, its long-run mean, (also written ) the mean-reversion speed, (= Bergomi’s ) the vol-of-vol, the spot/variance correlation, log-moneyness, Black–Scholes implied vol, the characteristic function of .

Quick-Reference Lookup (job #1). Every formula is transcribed from the verified corpus (Gatheral, The Volatility Surface, ch 2–8; Bergomi, Stochastic Volatility Modeling, ch 6–10; Hagan et al. 2002) and every number in the check column was re-executed (§3 and the sub-pages).

QuantityFormulaVerified check
Heston SDE (Gatheral 2.1) at
Feller condition a.s.fitted SPX params: → violated
Milstein positivity → the discretisation still stays positive
Characteristic function (2.12/2.15), , , , , , , , reproduces BSM as
Lewis / Carr–Madan price (5.6)BSM limit: Heston gives vs BSM
Heston price, (Table 3.2)(Lewis integral above) iv
Put–call parityresidual at every strike
ATM implied variance (3.18), , order-1 in approximation only (see caveat)
Short-dated variance skew (3.19/7.3)pricer: vs
SABR model (Hagan 2002)-
SABR implied vol, (7.7), , ATM ; flat in to part in at
SABR ATM skew
SABR ATM curvature (Bergomi–Guyon 8.39b); Hagan FD gives =
Bergomi–Guyon identity (8.40) exactly
Heston as one-factor FV model (6.3/6.4), T=0.05/0.25/1.000 yr
Heston ATMF skew, flat VS curve (6.20)short limit ; gives
Vol-of-vol term structure (6.9)vs power law (7.40): Heston/power-law ratio (m) … (y)
Two-factor vol-of-vol (7.39), Set II reproduces benchmark (7.40) to over –y
Digital price ↔ skew (ch 8)y ATM digital, vol, pts/ skew: = of notional
Jump additivity at (7.3), additive; slopes with
Rough benchmark (7.40), power-law vol-of-vol term structure

Critical caveat (flagged in the corpus). Gatheral’s printed ATM term-structure formula (3.18) is built from the unconditional expected-variance path, so its literal limit is (the long-run mean), not the current variance . The physical limit is : our characteristic-function pricer gives as , while the literal (3.18) value at is (). §02 and §04 quantify the gap.


3. Computational Implementation - the SV engine

Stdlib only (math, cmath) - no numpy/scipy. The whole folder runs on two primitives: the Heston characteristic function (a Riccati system in closed form) and the Lewis inversion (one real integral). Every number in §2 and in the sub-pages was produced by these.

is the martingale condition, and it pins down the normalisation of the whole construction: if the exponent were built from the wrong root or the wrong sign of , this identity fails. It is the first thing to check on any new implementation.


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. Calibrating the smile is not validating the model. Every SV-with-jumps model generates essentially the same surface shape (Gatheral ch 7 §7.8); only the dynamics - skew stickiness, vol-of-vol term structure, forward skew - discriminate. A Heston fit that matches today’s vanillas can still be badly wrong for cliquets and forward-skew products.
  2. Heston’s structural pathologies are hard-wired, not fixable by calibration. Short ATMF vol is normal (not lognormal); the skew scales as (Type I) and as (skew inversely tied to vol level); the vol-of-vol term structure is a fixed one-time-scale shape. Reality is Type II () with (lognormal variance).
  3. Feller violation is the norm, not the exception. The canonical fitted SPX parameters violate by a factor - the variance process does touch zero, and naive Euler simulation produces negative variance on of steps.
  4. SABR has no mean reversion. It is a short-expiration tool; using it for long maturities is a first-principles error, and its smile is asymptotic (arbitrageable far from the money, §03).
  5. Model risk dwarfs parameter risk. For skew-dependent payoffs the choice of model moves the price by whole percentage points of notional (digitally capped cliquets, digitals, Napoleons) - far more than the uncertainty in any single parameter.

5. References

  • Gatheral, Jim: The Volatility Surface: A Practitioner’s Guide (Wiley, 2006)
  • Bergomi, Lorenzo: Stochastic Volatility Modeling (CRC, 2016)
  • Hagan, Kumar, Lesniewski, Woodward: Managing Smile Risk (Wilmott, 2002)
  • 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