options · wire operation
Solve implied volatility
Solve Black–Scholes–Merton implied volatility from an observed option price using the method suite (auto/brent/newton/halley/householder, with an optional Brent fallback). Supply time as timeToExpiryYears (years) or as expiry + asOf (dates). Non-convergence and no-arbitrage failures are reported in diagnostics (converged: false), never fabricated; the method actually used is echoed in diagnostics.method.
totalfinance.option.implied_volatility- MCP tool name
- totalfinance_option_implied_volatility
- Pack / profiles
- options / 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 |
|---|---|---|
priceRequired | number | Observed option price to invert |
spotRequired | number | Spot price of the underlying |
strikeRequired | number | Strike price |
timeToExpiryYearsOptional | number | Time to expiry in years |
riskFreeRateRequired | number | Continuously-compounded risk-free rate (decimal) |
typeRequired | "call" | "put" | Option type |
dividendYieldOptional | number | Continuous dividend yield (decimal, default 0) |
expiryOptional | string | Option expiry — YYYY-MM-DD (→ the US close: 16:00 ET, 13:00 ET on early-close days) or a zoned ISO datetime. Supply with asOf instead of timeToExpiryYears. |
asOfOptional | number | string | Valuation instant — epoch ms or a zoned ISO datetime such as "2026-07-20T10:30:00-04:00". A bare YYYY-MM-DD is refused: a same-day option's value depends on the time of day. For an end-of-day mark use the 16:00 ET close (13:00 ET on early-close days). |
methodOptional | "auto" | "brent" | "newton" | "halley" | "householder" | Solver method (default auto = Householder with a Brent fallback) |
fallbackOptional | boolean | Fall back to Brent when the chosen method fails (default true) |
Complete JSON Schema
Loading…
Output schema
| Field | Type | Meaning |
|---|---|---|
valueRequired | number | null | — |
convergedRequired | boolean | — |
assumptionsOptional | object | Applied conventions |
diagnosticsOptional | object | Engine, method, warnings |
Complete JSON Schema
Loading…