options · wire operation
Price an option (Black–Scholes–Merton)
Price a European option with the Black–Scholes–Merton model. Supply time as timeToExpiryYears (years) or as expiry + asOf (dates). Returns the price plus the assumptions (day count, compounding, units, resolved timeToExpiryYears) and diagnostics that produced it.
totalfinance.option.price- MCP tool name
- totalfinance_option_price
- 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 |
|---|---|---|
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) |
volatilityRequired | number | Volatility (decimal) |
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). |
typeRequired | "call" | "put" | Option type |
Complete JSON Schema
Loading…
Output schema
| Field | Type | Meaning |
|---|---|---|
valueRequired | number | — |
assumptionsOptional | object | Applied conventions |
diagnosticsOptional | object | Engine, method, warnings |
Complete JSON Schema
Loading…