Getting Started
Workflow instructionsExpand or collapse
Typical Workflow for Single Bond Pricing
- Define the bond features—Issue Date, Settlement, Maturity, Set Call Date (if desired), and Coupon Rate—in Step 1 below.
- Set or select a baseline Treasury curve in Step 2 below.
- Set and apply adjustment factors to create the initial municipal pricing rates in Step 3 below.
- Review the rates using the Rate Chart or Rate Table.
- Press Calculate or enable Live Recalc above.
- Review the results in Bond Analytics and Call Option Modeling.
Notes
- The displayed bond price uses the Municipal Pricing Rates shown in the tables and charts. Individual spot rates may be adjusted directly using the left sidebar or on the chart. Curve-based rates may differ from the pricing rates, and the pricing rates can be snapped to the model curves.
- The bond may be priced with or without a call option. Call-option valuation is performed using the Call Option Modeling tab.
- When Live Recalc is enabled, prices and analytics update automatically, and the Calculate button is disabled (grayed out). When Live Recalc is disabled, use Calculate to recompute the bond price and analytics after changing spot rates or bond features.
- The Maturity Ladder tab provides separate instructions and calculations for pricing a series of bonds across multiple maturities.
STEP 1
Set Bond Features
STEP 2
Select a Starting Treasury Curve
Choose a starting Treasury curve. The selected curve populates the Treasury Spot Rates and the Direct Treasury Rate inputs in the left sidebar.
Note: Picking a historical or other curve immediately repopulates the Direct Treasury Rate method.
Implied Tax Rate
Compare clean prices per $100 and annualized yields using the same coupon, issue date, settlement date, and semiannual conventions. Yield-implied tax rate = 1 − municipal yield / Treasury yield.
Select this tab to calculate comparisons.
Full maturity comparison
| Valuation | Price | Yield | Yield-implied tax rate |
|---|
Call-date comparison
| Valuation | Price | Yield | Yield-implied tax rate |
|---|
The callable bond retains its original maturity. Its YTC assumes redemption at the selected call date and call price; the other call-date rows are non-callable bonds maturing on that date at par. A YTC-based tax rate is a scenario comparison and includes call-option effects. These yield comparisons may differ from the spot-rate tax adjustment inputs and do not isolate taxes from spreads or other assumptions.
Treasury and Municipal Spot Rates
RATE TABLE
Municipal and Treasury Curve Worksheet
| Tenor | Maturity | Municipal Pricing Rate |
Municipal NSS Spot |
Treasury Spot Rate |
Treasury NSS Spot |
Municipal/ Treasury Ratio |
Assumed Tax Rate |
Spread Adjustment (bp) |
Discount Factor |
Forward Rate |
|---|
NON-CALLABLE BOND
Basic Analytics
VALUATION SUMMARY
Price and Risk Measures
$100 face · Semiannual coupon · Coupon rate: — · Maturity date: — · Original term: — · Remaining term: —
Duration is in years; convexity is in years². DV01 estimates the price increase from a one-basis-point decline in yield per $100 face value.
PRICE SENSITIVITY
Price–Yield Relationship
The same non-callable bond cash flows repriced around the Municipal and taxable Treasury YTMs.
Because the Municipal and Treasury valuations use the same non-callable bond cash flows, their price-versus-YTM curves coincide. The wide blue Municipal line is shown beneath the dashed black Treasury line; the separate valuation markers identify each curve-based YTM and price.
Call Option Modeling
About call option valuation
This tab shows call option valuation results that are based on QuantLib calculations, using the municipal zero curve and the bond call assumptions below. Select either the Hull–White or Black–Karasinski one-factor short-rate lattice method and the associated volatility parameter. The issuer call option value is the difference between the non-callable and callable model values.
Using QUANTLIB BACKEND (see details)
Callable-Bond Valuation
Turn on Live Recalculation to update these results as you change the model inputs.
CALL OPTION METRICS
Callable-Bond Decision Summary
Observed Market Input
A single issuer-focused summary of the current QuantLib callable-bond valuation. Metrics not yet produced by the model are identified as not calculated.
| Metric | Value |
|---|---|
| Callable Price | — |
| Equivalent Noncall Price | — |
| Embedded Call Option Value | — |
| Yield to Call (YTC) | — |
| Yield to Maturity (YTM) | — |
| Probability of Call | Not calculated |
| Effective Duration | — |
| Effective Convexity | — |
| Observed Clean Price | — |
| Model-Implied Issuer OAS | — |
| Observed Price / YTC OAS | — |
| Expected Call Year | — |
| Break-even Refunding Yield | Not calculated |
MORE CALL ANALYSIS
Scenario and Interest-Rate Tree Analysis
Use the Additional Call Analysis tab for parallel-rate scenarios, call-option-value charts, and a model-specific short-rate tree visualization.
ISSUER CALL ANALYTICS
Additional Call Analysis
About call option valuation
This tab extends the QuantLib callable-bond valuation with bond-specific interest-rate scenarios, OAS sensitivity, and a sampled view of the short-rate lattice implied by the selected model, municipal curve, mean reversion, volatility, and valuation horizon. The full QuantLib pricing lattice continues to use the selected number of time steps.
MODEL SCENARIOS Reprice the currently selected bond and call structure under parallel shifts to the Municipal Pricing Rate curve. Scenario analysis is intentionally manual and is not triggered by Live Recalc. MODEL SENSITIVITY For each volatility assumption, the app calculates the positive parallel shift to the Municipal Pricing Rate curve that makes the non-callable bond price equal the callable model price. This manual analysis can be calculation intensive. MODEL LATTICE A sampled recombining tree generated from the selected short-rate model and current valuation inputs. Node labels show modeled annualized short rates; the range below reports the true minimum and maximum of the displayed nodes.Call Option Interest-Rate Scenarios
Curve Shift
Callable Price
No-Call Price
Call Option Value
Callable YTM
No-Call YTM
Select Calculate Scenarios to run the manual analysis. OAS and Volatility
Interest-Rate Tree
QUANTLIB MATURITY ANALYSIS
Bond Maturity Ladder
BOND AND MODEL INPUTS
Bond Parameters
Dates
Bond Parameters
Interest Rate Model
RATE AND YIELD PROFILE
Spot Rate and YTM or YTC by Maturity
QUANTLIB RESULTS
Prices and Yields by Maturity
| Maturity (Years) | Price | YTM/YTC | Non-Callable Price | No-Call YTM | Call Option Value |
|---|---|---|---|---|---|
| Select Calculate to value the maturity ladder. | |||||