Skip to content
TotalFinance

volatility · wire operation

Event-volatility decomposition (earnings)

Decompose pre-event implied volatility into base + event variance and the implied one-day event move (the earnings-move read): eventMove = √max(0, atmVolatility²·timeToExpiryYears − baseVolatility²·timeToExpiryYears). Optionally reports the variance risk premium when `realizedVolatility` is supplied.

totalfinance.volatility.event
MCP tool name
totalfinance_volatility_event
Pack / profiles
volatility / default, full, options, strategies
Default discovery
Included in the default tool set
Required capabilities
None
Effects / authorization
none / none
Cost / cancellation
small / Do not assume inline interruption
Handle-eligible inputs
None
Idempotency
not-applicable

Input schema

FieldTypeMeaning
atmVolatilityRequirednumberTotal ATM implied volatility into the event (decimal)
baseVolatilityRequirednumberBaseline (non-event) vol, e.g. post-event or far-month IV (decimal, ≥ 0)
timeToExpiryYearsRequirednumberTime to expiry in years, e.g. 5/365
realizedVolatilityOptionalnumberANNUALIZED realized volatility (decimal, e.g. 0.18 — a per-bar σ × √252 on daily bars) — adds the variance risk premium
Complete JSON Schema

Loading…

Output schema

FieldTypeMeaning
valueRequiredobjectThe computed result
assumptionsRequiredobjectEvery applied convention, echoed
diagnosticsRequiredobjectEngine/method/warnings (+ convergence where iterative)
Complete JSON Schema

Loading…