Matlab Price Instrument

Price Financial Instruments in MATLAB

Price financial instruments in MATLAB using the Financial Instruments Toolbox. Route to the correct numerical pricing method based on the user's request, then follow the method-specific reference for implementation details.

When to Use

• User asks to price options, bonds, swaps, or derivatives in MATLAB

• User asks for Greeks/sensitivities (delta, vega, gamma, theta, rho, lambda)

• User mentions finpricer, fininstrument, finmodel, or ratecurve

• User asks about Monte Carlo, tree / lattice, or FFT (Fast Fourier Transform) / FRFT (Fractional FFT) pricing

• User wants to compare pricing methods for the same instrument

When NOT to Use

• User is working with a non-MATLAB environment

• User wants to build a custom instrument with a novel payoff function

• User explicitly asks for a from-scratch implementation without the Financial Instruments Toolbox

Method Routing

Identify the pricing method from the user's request and read the corresponding reference:

Routing Rules

Read exactly one reference (and any relevant sub-references) that best matches based on these rules:

1. User mentions a specific pricer:

   • AssetMonteCarlo, RoughVolMonteCarlo, IRMonteCarlo -> references/monte-carlo.md

   • FFT, NumericalIntegration -> references/ni-fft.md

   • IRTree -> references/embedded-bond-tree.md

2. User mentions a specific numerical method and associated concepts:

   • Monte Carlo, simulation, NumTrials, SimulationDates -> references/monte-carlo.md

   • FFT, FRFT, characteristic function, CharacteristicFcnStep, LogStrikeStep -> references/ni-fft.md

   • Interest-rate tree, TreeDates, exercise probability -> references/embedded-bond-tree.md

3. User mentions instrument type without a method:

   • Path-dependent options or other exotic options (Asian, Barrier, Lookback, Cliquet, Touch, Spread, Binary) -> references/monte-carlo.md

   • European vanilla options under stochastic vol/jump models -> references/ni-fft.md

   • Callable/puttable fixed-rate bonds -> references/embedded-bond-tree.md

   • IR derivatives (caps, floors, swaptions, swaps) -> references/monte-carlo.md

4. User mentions model name without a method:

   • Heston, Bates, Merton + European vanilla -> references/ni-fft.md

   • Heston, Bates, Merton + exotic/path-dependent -> references/monte-carlo.md

   • Hull-White, Black-Karasinski, BDT, CIR + callable/puttable bond -> references/embedded-bond-tree.md

   • Hull-White, BK, Linear Gaussian 2 Factor (G2PP), Brace-Gatarek-Musiela (BGM), SABR-BGM + caps/floors/swaptions -> references/monte-carlo.md

   • Rough volatility (RoughBergomi, RoughHeston) -> references/monte-carlo.md

5. Ambiguous:

   • When asked to price European vanilla options without specifying pricing method (e.g., "price European call options with Heston in MATLAB"), default to references/ni-fft.md (faster, more accurate for European vanilla)

   • If user needs path simulation in addition to price and sensitivities, use references/monte-carlo.md

   • If user requests exercise probabilities at each time step for option embedded bonds, use references/embedded-bond-tree.md

Shared Conventions

All three methods share these conventions:

• Always prefer to use finpricer/fininstrument/finmodel/ratecurve objects (modern OO API) over legacy functions

• Never use legacy functions unless the user explicitly names them, or the reference suggests them for specific use cases

• Use name-value pairs with string keys: "DiscountCurve", not positional arguments

• Parameter names are case-insensitive but write them in MixedCase for clarity

• Always use datetime for dates (not datenum)

• Do not use price as a variable name — it shadows the price function; prefer p, or capitalized Price

• Request two outputs from price() when Greeks or tree data are needed: [p, pr] = price(...)

Common Mistakes (Cross-Method)

Best practice: Check MATLAB documentation (doc <functionName>, or help <functionName>, etc.) via the MATLAB MCP server before writing code.

Copyright 2026 The MathWorks, Inc.