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
| Field | Type | Meaning |
|---|---|---|
atmVolatilityRequired | number | Total ATM implied volatility into the event (decimal) |
baseVolatilityRequired | number | Baseline (non-event) vol, e.g. post-event or far-month IV (decimal, ≥ 0) |
timeToExpiryYearsRequired | number | Time to expiry in years, e.g. 5/365 |
realizedVolatilityOptional | number | ANNUALIZED 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
| Field | Type | Meaning |
|---|---|---|
valueRequired | object | The computed result |
assumptionsRequired | object | Every applied convention, echoed |
diagnosticsRequired | object | Engine/method/warnings (+ convergence where iterative) |
Complete JSON Schema
Loading…