Skip to content
TotalFinance

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

FieldTypeMeaning
priceRequirednumberObserved option price to invert
spotRequirednumberSpot price of the underlying
strikeRequirednumberStrike price
timeToExpiryYearsOptionalnumberTime to expiry in years
riskFreeRateRequirednumberContinuously-compounded risk-free rate (decimal)
typeRequired"call" | "put"Option type
dividendYieldOptionalnumberContinuous dividend yield (decimal, default 0)
expiryOptionalstringOption 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.
asOfOptionalnumber | stringValuation 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)
fallbackOptionalbooleanFall back to Brent when the chosen method fails (default true)
Complete JSON Schema

Loading…

Output schema

FieldTypeMeaning
valueRequirednumber | null—
convergedRequiredboolean—
assumptionsOptionalobjectApplied conventions
diagnosticsOptionalobjectEngine, method, warnings
Complete JSON Schema

Loading…