Module products
Expand description
One constructor per product family — the binding’s spelling of the core’s own constructors.
Conventions come from the shared registry by template code or family name
and are restated nowhere here. Options that are builder methods on the Rust
product are keyword arguments whose default applies no builder, so the
binding cannot hold a default the core does not have. Every function
returns the one Instrument handle; Instrument.product() names the
family for anyone who needs to dispatch.
Structs§
- NoInflation
Curve 🔒 - The curve a linker reading gets where none is pinned: every query refuses, so only a month without a published print ever reaches it.
- PyAnbima
Quote 🔒 - An ANBIMA quotation: its discounted parcels, the cotação and the unit price, each at the truncation the market publishes.
- PyBond
FitRow 🔒 - One bond’s place in a fit: its maturity, market and model clean prices, and the misfit as a street yield.
- PyBond
Future - A bond future: the delivery date and the basket it forwards to, each entry already resolved to the bond it delivers.
- PyBond
Future Analysis - The basket analysis: one row per deliverable, the cheapest to deliver, and the theoretical futures price off its forward.
- PyBond
Future Option Diagnostics - What a bond future option is priced from, per 100 — what a trader reconciles against an exchange or vendor screen.
- PyBond
Option Diagnostics - What a bond option resolved to when it was priced: the forward dirty price, its yield and duration, the yield vol and the price vol it became, the accrued and the dirty strike, the expiry.
- PyCds
Diagnostics - Each part of a credit default swap’s value, signed as it enters that value, and the risky annuity behind its quote.
- PyCredit
Linked Swap Diagnostics - What a credit default swap resolved to when it was priced: each part of its value, signed as it enters that value, and the risky annuity behind its quote.
- PyDeliverable
Analysis - One deliverable’s analytics at a quoted futures price.
- PyFx
Option Diagnostics - What an FX option resolved to when it was priced: the forward, the absolute strike, the surface vol at it, the signed delta, the expiry.
- PyGap
Charge 🔒 - A repack note’s gap charge and its rows.
- PyHull
White 🔒 - A validated one-factor Hull-White model: mean reversion
aand a volatility — flat, or a piecewise-constant term — the value a calibration writes and a caller pins. - PyHull
White 🔒Lattice - The Hull-White trinomial lattice, built and curve-fitted on construction.
- PyIndex
Settlement - What a credit event settles on an index position, each amount signed to the holder: the protection on the defaulted weight, and the premium accrued on it over the running period.
- PyIndex
Skew - The skew adjustment of an index’s constituents: one term structure of hazard multipliers every constituent’s curve is scaled by.
- PyProduct
Builder - A swap draft: a template’s swap with every term defaulted — effective at the template’s spot from the trade date, ten years long, 10,000,000, receiving fixed — and no fixed rate until one is stated or struck at par.
- PySimulated
Gap 🔒 - A repack note’s simulated gap: the charge, its standard error, its legs and its profile.
- PyTemplate
- A resolved convention template, and the code it resolved from.
- PyTranche
Settlement - What a credit event settles on a tranche position, and where it leaves the tranche: the loss it absorbs and the premium accrued on the notional removed, signed to the holder; the recovered amount written off its top; its attachment and detachment on the surviving pool.
- PyValuation
Trigger 🔒 - A repack note’s valuation trigger: terminate when the collateral’s market
value falls below
levelof notional on a monitoring date, selling itliquidation_lag_dayslater. - Repo
Draft 🔒 - What a repo draft states beyond its template and far date.
- Tranche
Mark 🔒Arg - A tranche model input as a Python caller names it: a number, the
contract’s, or
"Market", the market’s mark for the tranche’s index — Rust’sTrancheMark, the spelling parsed in the core. - Unit
Payoff 🔒 - A unit payment at one grid step — the smallest asset that shows the fit.
Enums§
- BondArg 🔒
- A bond-linked product’s bond: the
FixedRateBonditself, or an instrument already wrapping one. - PyAccrual
OnDefault 🔒 - How premium accrued since the last coupon settles on default:
Proportional(the ISDA standard model’s),Halfway, orNoAccrual(codenone). - PyAsset
Swap 🔒Kind - How an asset swap is packaged:
ParParorProceeds. - PyBarrier
Kind 🔒 - Where a single barrier sits and what touching it does.
- PyBond
Option 🔒Engine - Which model prices a bond option: the bond’s
YieldVol, orHullWhite. - PyBond
Strike 🔒Kind - What a bond option’s strike is stated as: a
CleanorDirtyprice, or aYield. - PyCall
Entry 🔒 - One
callable_bondschedule entry:(date, price, kind), the price clean, or(date, price, kind, basis)withbasisthe price basis. - PyCall
Kind 🔒 - Whose option a callability is: the issuer’s
Callor the holder’sPut. - PyCap
Floor 🔒Kind - A
Capor aFloor. - PyCds
Option 🔒Style - What a default before a CDS option’s expiry does to it:
SingleNameknocks out,FrontEndProtectionsettles it as the payer’s protection,Indexis an index option with its exercise price. - PyCds
Strike 🔒Type - How a CDS option’s strike is quoted: a
Spread, or aPriceper unit notional the holder enters the index at. - PyCme
Maturity 🔒Rounding - How a CME contract group rounds a deliverable’s maturity: to the
Month(the 2-, 3- and 5-year contracts) or theQuarter(the 10-year and bond contracts). - PyConstituent
Input 🔒 - One constituent of a basket as Python spells it: the triple, or the triple with the bond’s own repo key.
- PyDefault
Payment 🔒Time - When a credit-linked swap’s default-contingent payment is made:
AtDefault(the interval’s midpoint),AtPeriodEnd(the first scheduled payment date on or after the default) orAtMaturity. - PyEx
DivDay 🔒Type - The days an ex-dividend lag counts:
Businessdays on the bond’s settlement calendar (UK gilts) orCalendardays (South African government bonds). - PyExercise
Style 🔒 - When an option on a future may be exercised:
EuropeanorAmerican. - PyLeg
Role 🔒 - How a credit-linked swap’s leg depends on the reference entity’s
default:
Independent(paid whatever happens),Contingent(paid while the entity survives),Default(paid on default, scaled by the loss) orRecovery(paid on default, scaled by the recovery). - PyOption
Kind 🔒 - An option’s right: a
Callor aPut. - PyPremium
Style 🔒 - How an option on a future settles its premium:
FuturesStyle(margined daily, Eurex and ICE) orPaidup front (CBOT). - PyPrice
Basis 🔒 - Whether a bond price includes accrued interest (
Dirty) or not (Clean). - PyRepack
Engine 🔒 - How a repack note’s gap is priced:
Independentof rates, orCorrelatedthrough the issuer’s Gaussian intensity. - PyRepack
Role 🔒 - Who holds a booked repack note: the bank’s swap facing the SPV
(
SwapCounterparty), or the notes per unit notional (Noteholder). - PySettlement
Index 🔒 - The settlement index of a non-deliverable forward or option as Python
spells it: an FX key as a string, an
Indexvalue, which settles under the name its fixings are published under, or a(reference_key, settlement_key)tuple for a cross of two keys through USD. - PySigma
Input 🔒 - A Hull-White volatility as Python states it: one float, or
(t_end, σ)pieces with interval ends in years, the last piece extending flat. - PySigma
Shape 🔒 - The shape a Hull-White volatility is calibrated in:
Flatby least squares, orPiecewise, one piece per strip expiry. - PyStrip
Scheme 🔒 - How caplet vols are stripped from cap quotes:
ConstantBetweenQuotes, or one volPerCaplet. - PySwaption
Engine 🔒 - Which model prices a swaption: the market’s vol
Surface, orHullWhite. - PySwaption
Kind 🔒 - Whether a swaption’s holder pays (
Payer) or receives (Receiver) the fixed leg on exercise. - PySwaption
Settlement 🔒 - How a swaption settles on exercise: into the swap (
Physical) or for its value (Cash). - PyTermination 🔒
- A swap’s end as Python spells it: a termination date, or a forward
tenor such as
"5Y"or"2Y2Y"that dates the swap from the template’s spot on the valuation date given in the first argument.
Functions§
- __
pyfunction_ 🔒 ⚠accreted_ face - __
pyfunction_ 🔒 ⚠accreted_ redemption - __
pyfunction_ 🔒 ⚠after_ credit_ event - __
pyfunction_ 🔒 ⚠anbima_ nominal_ value - __
pyfunction_ 🔒 ⚠anbima_ price - __
pyfunction_ 🔒 ⚠anbima_ yield_ from_ price - __
pyfunction_ 🔒 ⚠asset_ swap - __
pyfunction_ 🔒 ⚠atm_ delta_ neutral_ strike - __
pyfunction_ 🔒 ⚠australian_ coupon_ factor - __
pyfunction_ 🔒 ⚠australian_ indexation_ factor - __
pyfunction_ 🔒 ⚠australian_ price_ from_ real_ yield - __
pyfunction_ 🔒 ⚠australian_ real_ yield_ from_ price - __
pyfunction_ 🔒 ⚠bachelier - __
pyfunction_ 🔒 ⚠basket_ survival_ probability - __
pyfunction_ 🔒 ⚠basket_ total_ return_ swap - __
pyfunction_ 🔒 ⚠bermudan_ swaption - __
pyfunction_ 🔒 ⚠black76 - __
pyfunction_ 🔒 ⚠black76_ implied_ vol - __
pyfunction_ 🔒 ⚠bond_ forward - __
pyfunction_ 🔒 ⚠bond_ future - __
pyfunction_ 🔒 ⚠bond_ future_ analysis - __
pyfunction_ 🔒 ⚠bond_ future_ option - __
pyfunction_ 🔒 ⚠bond_ future_ option_ from_ template - __
pyfunction_ 🔒 ⚠bond_ future_ position - __
pyfunction_ 🔒 ⚠bond_ option - __
pyfunction_ 🔒 ⚠bond_ spread_ over_ curve - __
pyfunction_ 🔒 ⚠bond_ total_ return_ swap - __
pyfunction_ 🔒 ⚠bond_ z_ spread - __
pyfunction_ 🔒 ⚠calibrate_ and_ pin - __
pyfunction_ 🔒 ⚠calibrate_ hull_ white - __
pyfunction_ 🔒 ⚠calibrate_ hull_ white_ to_ strip - __
pyfunction_ 🔒 ⚠callable_ bond - __
pyfunction_ 🔒 ⚠callable_ loan - __
pyfunction_ 🔒 ⚠callable_ oas - __
pyfunction_ 🔒 ⚠callable_ swap - __
pyfunction_ 🔒 ⚠capitalisations - __
pyfunction_ 🔒 ⚠cdo_ tranche - __
pyfunction_ 🔒 ⚠cds_ option - __
pyfunction_ 🔒 ⚠clean_ price_ at_ oas - __
pyfunction_ 🔒 ⚠cme_ conversion_ factor - __
pyfunction_ 🔒 ⚠cms_ coupon_ rate - __
pyfunction_ 🔒 ⚠cms_ option - __
pyfunction_ 🔒 ⚠cms_ rate - __
pyfunction_ 🔒 ⚠cms_ spread_ coupon_ rate - __
pyfunction_ 🔒 ⚠cms_ spread_ option - __
pyfunction_ 🔒 ⚠cms_ swap - __
pyfunction_ 🔒 ⚠compounded_ oas - __
pyfunction_ 🔒 ⚠coupon_ bond_ option - __
pyfunction_ 🔒 ⚠credit_ default_ swap - __
pyfunction_ 🔒 ⚠credit_ default_ swap_ option - __
pyfunction_ 🔒 ⚠credit_ linked_ note - __
pyfunction_ 🔒 ⚠credit_ linked_ swap - __
pyfunction_ 🔒 ⚠cross_ currency_ rungs - __
pyfunction_ 🔒 ⚠cross_ currency_ template - __
pyfunction_ 🔒 ⚠curve_ pin - __
pyfunction_ 🔒 ⚠curve_ yield_ at - __
pyfunction_ 🔒 ⚠deposit - __
pyfunction_ 🔒 ⚠discount_ bond_ affine - __
pyfunction_ 🔒 ⚠discount_ margin - __
pyfunction_ 🔒 ⚠effective_ risk - __
pyfunction_ 🔒 ⚠equity_ basket_ total_ return_ swap - __
pyfunction_ 🔒 ⚠equity_ option - __
pyfunction_ 🔒 ⚠equity_ total_ return_ swap - __
pyfunction_ 🔒 ⚠eurex_ btp_ conversion_ factor - __
pyfunction_ 🔒 ⚠eurex_ chf_ conversion_ factor - __
pyfunction_ 🔒 ⚠eurex_ conversion_ factor - __
pyfunction_ 🔒 ⚠european_ swaption - __
pyfunction_ 🔒 ⚠expected_ tranche_ loss - __
pyfunction_ 🔒 ⚠fair_ forward_ rate - __
pyfunction_ 🔒 ⚠fair_ margin - __
pyfunction_ 🔒 ⚠fee - __
pyfunction_ 🔒 ⚠fit_ bond_ curve - __
pyfunction_ 🔒 ⚠fixed_ rate_ bond - __
pyfunction_ 🔒 ⚠floating_ rate_ note - __
pyfunction_ 🔒 ⚠forward_ price - __
pyfunction_ 🔒 ⚠fra - __
pyfunction_ 🔒 ⚠fra_ settlement - __
pyfunction_ 🔒 ⚠future - __
pyfunction_ 🔒 ⚠futures_ convexity - __
pyfunction_ 🔒 ⚠futures_ price - __
pyfunction_ 🔒 ⚠fx_ delta - __
pyfunction_ 🔒 ⚠fx_ forward - __
pyfunction_ 🔒 ⚠fx_ option - __
pyfunction_ 🔒 ⚠fx_ swap - __
pyfunction_ 🔒 ⚠fx_ swap_ helper - __
pyfunction_ 🔒 ⚠hull_ white_ convexity_ bias - __
pyfunction_ 🔒 ⚠ice_ gilt_ conversion_ factor - __
pyfunction_ 🔒 ⚠index_ credit_ default_ swap - __
pyfunction_ 🔒 ⚠index_ intrinsic - __
pyfunction_ 🔒 ⚠index_ ratio - __
pyfunction_ 🔒 ⚠index_ skew - __
pyfunction_ 🔒 ⚠inflation_ linked_ bond - __
pyfunction_ 🔒 ⚠instantaneous_ forward - __
pyfunction_ 🔒 ⚠interest_ rate_ cap_ floor - __
pyfunction_ 🔒 ⚠inv_ norm_ cdf - __
pyfunction_ 🔒 ⚠linker_ invoice - __
pyfunction_ 🔒 ⚠linker_ real_ price - __
pyfunction_ 🔒 ⚠linker_ real_ yield - __
pyfunction_ 🔒 ⚠loan - __
pyfunction_ 🔒 ⚠meeting - __
pyfunction_ 🔒 ⚠meeting_ ois - __
pyfunction_ 🔒 ⚠norm_ cdf - __
pyfunction_ 🔒 ⚠note_ components - __
pyfunction_ 🔒 ⚠note_ dirty_ price - __
pyfunction_ 🔒 ⚠note_ z_ spread - __
pyfunction_ 🔒 ⚠nth_ to_ default_ swap - __
pyfunction_ 🔒 ⚠on_ the_ run - __
pyfunction_ 🔒 ⚠package_ value - __
pyfunction_ 🔒 ⚠par_ rungs - __
pyfunction_ 🔒 ⚠payer_ swaption - __
pyfunction_ 🔒 ⚠payment_ in_ kind_ bond - __
pyfunction_ 🔒 ⚠premium_ contract - __
pyfunction_ 🔒 ⚠pv_ weighted_ time - __
pyfunction_ 🔒 ⚠receiver_ swaption - __
pyfunction_ 🔒 ⚠reference_ index - __
pyfunction_ 🔒 ⚠repack_ gap - __
pyfunction_ 🔒 ⚠repack_ note - __
pyfunction_ 🔒 ⚠repo_ margin - __
pyfunction_ 🔒 ⚠risky_ value - __
pyfunction_ 🔒 ⚠series_ maturity - __
pyfunction_ 🔒 ⚠series_ roll - __
pyfunction_ 🔒 ⚠settlement_ date - __
pyfunction_ 🔒 ⚠sigma_ from_ price - __
pyfunction_ 🔒 ⚠simple_ margin - __
pyfunction_ 🔒 ⚠simulate_ repack_ gap - __
pyfunction_ 🔒 ⚠simulate_ repack_ gap_ risk - __
pyfunction_ 🔒 ⚠spread_ duration - __
pyfunction_ 🔒 ⚠straddle - __
pyfunction_ 🔒 ⚠street_ index_ ratio - __
pyfunction_ 🔒 ⚠strike_ from_ delta - __
pyfunction_ 🔒 ⚠strip_ caplet_ smile - __
pyfunction_ 🔒 ⚠strip_ caplet_ vols - __
pyfunction_ 🔒 ⚠strip_ from_ callable - __
pyfunction_ 🔒 ⚠structured_ note - __
pyfunction_ 🔒 ⚠swap - __
pyfunction_ 🔒 ⚠swap_ conventions - __
pyfunction_ 🔒 ⚠swap_ from_ legs - __
pyfunction_ 🔒 ⚠swap_ template - __
pyfunction_ 🔒 ⚠template_ by_ code - __
pyfunction_ 🔒 ⚠templates - __
pyfunction_ 🔒 ⚠tenor_ basis - __
pyfunction_ 🔒 ⚠turn - __
pyfunction_ 🔒 ⚠uk_ money_ accrued - __
pyfunction_ 🔒 ⚠uk_ money_ price - __
pyfunction_ 🔒 ⚠uk_ money_ yield - __
pyfunction_ 🔒 ⚠uk_ real_ yield_ from_ money - __
pyfunction_ 🔒 ⚠uk_ real_ yield_ from_ money_ dirty - __
pyfunction_ 🔒 ⚠weekly_ bond_ future_ option_ from_ template - __
pyfunction_ 🔒 ⚠xccy_ basis - __
pyfunction_ 🔒 ⚠yield_ convention_ status - __
pyfunction_ 🔒 ⚠yield_ to_ call - __
pyfunction_ 🔒 ⚠yield_ to_ maturity_ scenario - __
pyfunction_ 🔒 ⚠yield_ to_ worst - __
pyfunction_ 🔒 ⚠yoy_ inflation_ cap_ floor - __
pyfunction_ 🔒 ⚠yoy_ inflation_ swap - __
pyfunction_ 🔒 ⚠zero_ bond_ option - __
pyfunction_ 🔒 ⚠zero_ coupon_ bond - __
pyfunction_ 🔒 ⚠zero_ coupon_ inflation_ cap_ floor - __
pyfunction_ 🔒 ⚠zero_ coupon_ inflation_ swap - __
pyfunction_ 🔒 ⚠zero_ coupon_ quotes - accreted_
face 🔒 - A payment-in-kind bond’s accreted face on
date: its par face grown by every capitalisation on or before it. - accreted_
redemption 🔒 - A payment-in-kind bond’s one cash flow per 100 of par face: its redemption, accreted to maturity.
- after_
credit_ 🔒event - An index CDS or a CDO tranche after a credit event on one of its names,
and what the event settles: the index re-versioned — the factor reduced
by
weight, the version incremented — with anIndexSettlement; the tranche eroded from the bottom by the loss and written down from the top by the recovery, on the surviving pool, with aTrancheSettlement. - american_
exercise 🔒 "bermudan"(on the dates alone) or"american"(from each date to the next).- anbima_
nominal_ 🔒value - The ANBIMA VNA at
date. - anbima_
price 🔒 - The ANBIMA quotation at a real yield
tir(per annum, decimal), discounting on BUS/252 overcalendarwith the published truncation chain. - anbima_
vna_ 🔒or - The VNA a caller passed, or the curve-based one at
settlement. - anbima_
yield_ 🔒from_ price - The real yield implied by an ANBIMA unit price, by bisection over the exact truncation chain. The chain makes the price a step function of the yield, so the solve lands on the step containing the quote.
- arm 🔒
- The product arm
nameworks on, or aValueErrornaming what was given. - asset_
swap 🔒 - An asset swap: a bond bought at
dirty_price, settling onstart, against a floating leg onindexeveryfloat_frequency, under the"par_par"or"proceeds"convention. Withfx_rate, a bond in another currency than the index’s: the cross-currency package at that rate, index units per bond unit, under either convention. - atm_
delta_ 🔒neutral_ strike - The delta-neutral at-the-money strike under
convention. - australian_
coupon_ 🔒factor - The AOFM
pfor the payment atnext_coupon: half the percentage CPI movement over the two quarters ending two quarters before that payment’s quarter, rounded to two places. - australian_
indexation_ 🔒factor - The Australian
Ktindexation factor atdate, in ratio form. - australian_
kt_ 🔒or - The
Kta caller passed, or the curve-based one atsettlement. - australian_
price_ 🔒from_ real_ yield - The AOFM price per 100 face at a quarterly-compounded real yield.
- australian_
real_ 🔒yield_ from_ price - The quarterly-compounded real yield implied by an AOFM price. As with the ANBIMA quote, the published rounding makes the price a step function of the yield, so the solve lands on the step containing the quote.
- bachelier 🔒
- The Bachelier (normal) forward price, undiscounted; defined for negative forwards and strikes.
- basis_
on 🔒 - The tenor-basis body both paths forward to.
- basket_
survival_ 🔒probability P(fewer than n defaults)for a finite basket under the one-factor Gaussian copula, or the double-t withfactor_dofandidiosyncratic_dof(both or neither), from each constituent’s own default probabilitypdsand the asset correlationrho.- basket_
total_ 🔒return_ swap - A total return swap on a basket of bonds, replicated from its
constituents:
(bond, weight, initial_price)triples, the weight a face multiplier onnotionaland the price the contractual start per 100 face. A constituent is(bond, weight, initial_price), or(bond, weight, initial_price, repo_key)to carry that bond on its own repo curve (the market not holding that curve carries it on the package’s), or(bond, weight, initial_price, repo_key_or_None, issuer)to make its return contingent onissuer’s credit. Otherwise asbond_total_return_swap. - bermudan_
swaption 🔒 - A Bermudan swaption on
underlying, exercisable on each ofexercise_dates— priced on the Hull–White lattice, so its market needs the model pinned. - black76 🔒
- The Black-76 forward-lognormal price, undiscounted:
kindiscallorput. A forward that isn’t positive, or a negative strike, is refused; a zero strike prices the call at the forward and the put at zero. - black76_
implied_ 🔒vol - The Black-76 volatility implying
price, orNonewhere no volatility does — a reading off a price, not a valuation. - bond_
forward 🔒 - A forward on
notionalofbondat a cleanstrike(dirty whendirty_strike), financed on the repo curve underrepo_key. - bond_
future 🔒 - A bond future delivering
basketondelivery, each entry a(bond, conversion_factor, key)triple. - bond_
future_ 🔒analysis - The basket of
futureonmarket, at a quotedfutures_priceper 100. - bond_
future_ 🔒option - An option on the listed bond future
contract("CBOT-ZN-2027-03"), expiring onexpiry, struck atstrikeper 100, priced off the market’s quoted price for the contract (MarketContext.with_future_price) and its option vol surface (MarketContext.with_future_option_vols). - bond_
future_ 🔒option_ from_ template - The option of
year-monthunder the futures option templatecode("CBOT-OZN","EUREX-OGBL","ICE-R-OPT"): its expiry by the exchange’s rule on the template’s calendar, its underlying the quarterly future the month exercises into, and the venue’s premium style, exercise style, currency and point value. An expiry the rule lands on a holiday for is refused — build it withbond_future_optionand state the expiry. - bond_
future_ 🔒position - A position in
future:contractscontracts, each deliveringcontract_sizeof face, struck attraded_priceper 100. - bond_
option 🔒 - An option on a fixed-rate bond, struck on its
"clean"or"dirty"price or its"yield", priced under the"yield_vol"or"hull_white"engine. A price strike is per 100 of the face alive at exercise settlement, so an amortising bond is struck on its outstanding face.yield_volnames the bond yield vol surface the option reads; omitted, the bond’s currency’s. - bond_
option_ 🔒on bond_optionon a bond already held as an instrument.- bond_
spread_ 🔒over_ curve - The bond’s yield over a reference curve’s zero rate at its maturity, both on the named basis.
- bond_
total_ 🔒return_ swap - A total return swap on
notionalofbondfrominitial_price— a clean price per 100 — resetting onreset_schedule, funded on the repo curve underrepo_key. The funding leg accrues onfunding_notional, ornotional·initial_price/100without one;funding_ratefixes it at a rate, in place of a margin, a gearing and an index. - bond_
z_ 🔒spread - The z-spread at which the bond’s dirty price is
dirty_price. - calibrate_
and_ 🔒pin - The fit, and the market with its σ and mean reversion pinned — ready to price the callable it was fitted to.
- calibrate_
hull_ 🔒white - Fits Hull–White’s volatility to the ATM normal vols
marketquotes on the stripinstrumentimplies, holdingmean_reversionfixed — flat by least squares, orshape="piecewise"for one piece per strip expiry. - calibrate_
hull_ 🔒white_ to_ strip - Fits Hull–White’s volatility to the ATM normal vols
marketquotes on an explicit strip of(expiry, end)pairs, holdingmean_reversionfixed — the inputcalibration.hull_whitederives from a callable, supplied directly.collateralnames the discounting currency;currency’s own whenNone. - call_
entries 🔒 - Each
(date, price, kind[, basis])entry as its callability, clean by default. - callable_
bond 🔒 - A bond with a call/put
scheduleof(date, price, "call" | "put"), the price clean, or(date, price, kind, "clean" | "dirty"); an empty schedule is the bullet under the same lattice.make_wholebooks issuer make-whole calls as(date, spread_bp)— data only, never exercised on the lattice.issuertags the bond’s credit;security_spreadits own spread key. A price is per 100 of the face alive on its date, so an amortising (sinking-fund) bond is called on its outstanding face.exerciseis"bermudan"(on the dates alone) or"american"(each right runs from its date to the next entry’s, the last on its date). - callable_
loan 🔒 - A
loan(fromloan) with ascheduleof(date, price, "call" | "put"[, "clean" | "dirty"]): the borrower may prepay on a call, the lender demand repayment on a put, atpriceper 100 of the principal then outstanding, plus the interest accrued for a clean price — valued on the currency’s Hull-White lattice, exercised ascallable_bondreadsexercise.issuertags the borrower’s credit. Booked from the depositor’s side (borrower=False) it is a callable or puttable term deposit. A floating loan exercises on its interest dates alone, Bermudan. - callable_
oas 🔒 - The option-adjusted spread at which the callable’s clean price is
clean_price. - callable_
swap 🔒 swap— a vanilla or overnight swap — cancellable onexercise_datesbycallable_by:"holder"(a right bought) or"counterparty"(a right sold). Valued as the swap plus a Bermudan struck at its fixed rate on the Hull-White lattice, so its market needs the model pinned.- capitalisations 🔒
- Every capitalisation on a payment-in-kind bond’s life, in order: the date the coupon would have paid, the rate and year fraction it accrued at, the face entering and leaving the period, and the amount rolled into principal.
- cash_
terms 🔒 - A cash settlement’s three terms, all or none.
- cdo_
tranche 🔒 - A synthetic CDO tranche
[attach, detach)of an index pool. Withindex_factor, the tranche on a pool that has lost names: the points are on the surviving pool, the legs onpool_notional · index_factor. Withrecovery_floor, Amraoui–Hitier stochastic recovery on that floor — a number (Rustwith_recovery_floor) or"Market", the market’s floor for the index (on_market_recovery_floor), with a risk row. Withfactor_dofandidiosyncratic_dof, both or neither, the double-t copula in place of the Gaussian — two numbers (Rustwith_student_t) or two"Market", the market’s for the index (on_market_copula_dof), with risk rows. - cds_
option 🔒 - A single-name knockout CDS option on
instrument— the CDS it exercises into — under Black’s model on the forward spread:(value, forward, annuity).kindis aSwaptionKind: a payer holds the right to pay the strike spread (buy protection), a receiver the right to receive it.short=Trueis the option’s seller, its value negated. - clean_
price_ 🔒at_ oas - The callable’s clean price at an option-adjusted spread.
- cme_
conversion_ 🔒factor - The CME Treasury futures conversion factor of a bond with
coupon(a decimal) maturing onmaturity, for the delivery month starting ondelivery_month_start:"month"rounding for the 2-, 3- and 5-year contracts,"quarter"for the 10-year and bond contracts. - cms_
coupon_ 🔒rate - What one CMS coupon on the swap index
templateattenor, fixing onfixingand paid onpayment, pays as a rate:gearing·CMS + spread, with a collar (cap,floor) or a digital (call,put,naked,gap, spelled asLeg.with_digitalspells them) on it, each option replicated off the swaption smile under linear TSR atmean_reversion. - cms_
option 🔒 - A CMS caplet (
kind="Call") or floorlet on the swap indextemplateattenorandstrike, fixing onfixingand paid onpayment, as a rate: replicated off the swaption smile under the linear terminal swap rate model atmean_reversion. - cms_
payoff 🔒 - The payoff a CMS coupon carries, from the keywords a Python caller spells
it with: a collar (
cap,floor) or a digital (call,putasLeg.with_digitaltakes them,naked,gap), or none. A coupon carries one payoff, so both at once is refused. - cms_
rate 🔒 - The CMS rate on the swap index
templateattenor, fixing onfixingand paid onpayment: the index swap’s forward and the rate convexity- adjusted by the linear terminal swap rate model atmean_reversion, as(forward, rate). - cms_
spread_ 🔒coupon_ rate - What one CMS spread coupon still to fix pays, as a rate:
gearing·(CMS(tenor) − CMS(minus_tenor)) + spreadon the swap indextemplate, the two rates joined bycorrelation— a number, or"Market"for the market’s mark for the pair — with a collar or a digital on it spelled asLeg.with_digitalspells one. - cms_
spread_ 🔒option - An option on the spread of two CMS rates on the swap index
template,CMS(tenor) − CMS(minus_tenor), fixing onfixingand paid onpayment, as a rate: a call pays(S₁ − S₂ − strike)⁺, a put(strike − S₁ + S₂)⁺. The two rates are joined bycorrelation, a number or"Market". - cms_
swap 🔒 - A CMS swap: a leg paying the CMS rate of the swap index
templateattenoreach period ofschedule— fixing in advance, geared and spread, accruing onday_count— againstotheron the opposite side. The linear TSR convexity adjustment is taken atmean_reversion.capandfloorcollar every CMS coupon’s rategearing·CMS + spread;call,put,nakedandgapput a digital on it, spelled asLeg.with_digitalspells one. - compounded_
oas 🔒 - A continuously compounded spread quoted at a periodic
frequency:m·(e^{s/m} − 1). The lattice’s OAS is continuous; this is presentation. - constituent_
template 🔒 - The CDS conventions an index’s constituents trade under, from the index contract’s family; the standard template where the contract names none.
- constituents_
on 🔒 - An index’s constituents as
(reference, weight)pairs: each name a fullENTITY/SENIORITY/DOCCLAUSEspelling as given, or a bare entity on the family’s standard tier and clause. - contract_
on 🔒 - The listed-contract body both paths forward to.
- correlation_
in_ 🔒range - The copula kernels take a correlation in
[0, 1); the core asserts it, the binding refuses it as a value error. - coupon_
bond_ 🔒option - A European option on a coupon bond under Hull-White by Jamshidian’s
decomposition, per unit face.
couponsare per unit face, one perpay_datesentry, and include the redemption on the last date;strikeis in the same units.kindis"call"or"put". - credit_
default_ 🔒swap - A single-name CDS on the standard (CDS2015) template: its maturity rolled
off the trade date and a whole-year
tenor_years, or the statedmaturitya confirm carries, which is how an 18-month or an off-cycle contract is expressed at all. - credit_
default_ 🔒swap_ option - A European option on the CDS
underlying, booked like any product and priced off the market’s credit vol surface for the underlying’s name. - credit_
index 🔒 - The credit index family by name.
- credit_
linked_ 🔒note - A funded credit-linked note on
entity, held by the investor unlessissued. - credit_
linked_ 🔒swap - A credit-linked swap on
reference— a bare entity on the standard template’s tier and clause, or a fullENTITY/SENIORITY/DOCCLAUSEspelling — incurrency, payinglegs, each a(leg, role)pair: the leg as built (its own currency and discount key), the role one ofindependent,contingent,defaultorrecovery. A leg in another currency prices on the entity’s curve in that currency and converts at spot.settles_accrual:True(the default) settles a contingent coupon’s accrual to the default by the halfway rule,Falsesettles none;accrual_on_defaultnames the rule instead,proportionalamong them, and the two are not given together.fixed_recoveryfixes the contract’s recovery; otherwise the trade currency’s curve supplies the market’s.default_payment_timeisat_default,at_period_endorat_maturity. - credit_
on 🔒 - A basket or pool constituent’s market key: a full identity as given, or a
bare entity on
template’s standard tier and clause incurrency. - cross_
currency_ 🔒rungs - The
(pillar, instrument, basis)rungs of a collateral ladder, built from the basis-swaptemplateattenors(periods such as"1Y") and their quoted bases, dated by the template’s own conventions; whatcalibrate_cross_currencytakes.templateis a registered code or aTemplate, registered or customised. - cross_
currency_ 🔒template - A cross-currency template of the caller’s own: a leg on the registered
index
leg1against one onleg2, collateralised under the overnight indexcollateral. - curve_
pin 🔒 - A curve’s own reading at
dateas an instrument — thediscount_factoror thezero_rateofcurrency’s discount curve — for pinning a curve node directly:Rung.priced(date, curve_pin(...), value, 1.0). - curve_
yield_ 🔒at - The zero rate
curveimplies todate, expressed onbasis— the reference yield an I-spread or G-spread reads. Zero at or before the curve’s reference date."default"reads as annual, as forpv_weighted_time. - deposit 🔒
- A money-market deposit rung: lent on
valuation, maturingtenoron under the template’s calendar and convention, on its day count, quoted atrate. Labelled by its tenor. - deposit_
on 🔒 - The deposit body both paths forward to.
- diagnostics 🔒
- What
instrumentresolved to onmarket, as its product’s diagnostics class:Instrument.diagnostics. - discount_
bond_ 🔒affine - The affine factors
(A, B)of the model’s discount bond seen fromt:P(t, maturity; r) = A · e^{−B·r}. - discount_
margin 🔒 - The note’s discount margin at a quoted clean price: the flat continuous spread on the discounting that reprices the quote.
- effective_
risk 🔒 - The callable’s effective risk at a given OAS: duration, convexity and DV01 against a parallel move in the curve, all from one lattice pass.
- equity_
basket_ 🔒total_ return_ swap equity_total_return_swapon a basket of(name, quantity, initial_price)constituents, each read off its own quoted spot,EQ-fixings andDIV-dividends; the funding notional defaults toΣ quantity · initial_price.- equity_
option 🔒 - A European
kind(callorput) onquantityshares of the equityname, struck atstrikeand expiring and paying onexpiry: Black-Scholes on the dividend-free forward, off the market’s quoted spot (MarketContext.with_equity_spot) and vol surface (MarketContext.with_equity_vols). A negative quantity is short.barrierandbarrier_kindtogether add a single continuously monitored barrier, valued in closed form under Black–Scholes;rebateis paid per share by a knock-in that never knocks in (at expiry) or a knock-out on the hit. - equity_
total_ 🔒return_ swap - A total return swap on
quantityshares of the equitynamefrominitial_priceper share, resetting onreset_schedule. It is valued on the period under way, return and funding accrued from its start to the valuation date, off the market’s quoted spot (MarketContext.with_equity_spot), with dividends from theDIV-<name>fixings. The funding terms arebond_total_return_swap’s. - eurex_
btp_ 🔒conversion_ factor - Eurex’s conversion factor for a semi-annual BTP delivered into the
Euro-BTP future, to seven decimals: the EUR formula on half-year periods,
each payment that rolls off a weekend or TARGET holiday discounted the
further fraction of a period it rolls. Arguments as
eurex_conversion_factor’s. - eurex_
chf_ 🔒conversion_ factor - Eurex’s conversion factor for a CHF Swiss Confederation bond with
coupon(a decimal) maturing onmaturity, delivered ondeliveryinto the CONF future atnotional_coupon: whole years to maturity and full months to the next coupon, as Eurex’s CHF document states it, unrounded. - eurex_
conversion_ 🔒factor - Eurex’s conversion factor for an annual-coupon EUR bond with
coupon(a decimal), accruing frominterest_start, first paying onfirst_couponand maturing onmaturity, delivered ondeliveryinto a contract withnotional_coupon(0.06 for the Schatz, Bobl, Bund and Buxl). - european_
swaption 🔒 - A European swaption on
underlying, exercised into it atexpiry. - expected_
tranche_ 🔒loss - The large-homogeneous-pool expected tranche loss as a pool-loss fraction:
E[min(max(L − attach, 0), detach − attach)]for unconditional default probabilitypd, loss given defaultlgdand asset correlationrhounder the one-factor Gaussian copula, or the double-t withfactor_dofandidiosyncratic_dof(both or neither). - fair_
forward_ 🔒rate - The forward rate covered interest parity implies for an FX forward.
- fair_
margin 🔒 - The funding margin that values a bond total return swap at zero.
- family_
of 🔒 - fee 🔒
- A standalone fee:
amountincurrencyonpayment_date, positive received and negative paid, discounted on the currency’s cash collateral — the way an upfront is attached to a structure. - finish_
future_ 🔒option - fit_
bond_ 🔒curve - Fit a parametric discount curve to a bond universe.
- fixed_
rate_ 🔒bond - Registers every constructor on the module.
A fixed-rate bullet bond:
couponpaid atfrequencyonday_count, redeemingfaceat maturity. Its readings — price, yield, durations, accrued, amortisation — are methods of the bond it returns. - floating_
rate_ 🔒note - A floating-rate note on a registered term
indexatmarginover it.outstandingis a notional profile, one fraction of the face per coupon period starting at 1 and never rising; omitted, the note is a bullet. - format_
notional 🔒 10,000,000for a round notional; the plain number otherwise. The digits are read off the number’s own{:.0}rendering, so no cast is involved.- forward_
of 🔒 - forward_
price 🔒 - The bond’s forward price per 100 at
forward_date, on a named price basis, carried on the repo curve underrepo_keyor on the discount curve itself. - fra 🔒
- A forward-rate-agreement rung: the accrual starts
startafter the index’s spot date and runs one index period, quoted atrate. Labelled3x6. - fra_
between 🔒 - The stated-FRA body both entry points forward to.
- fra_on 🔒
- The FRA body both the code-keyed function and
Template.forward_rate_agreementforward to, so the two paths cannot compute different numbers. - fra_
settlement 🔒 - The FRA’s settlement amount — the discounted difference between the projected and the struck rate on the notional.
- future 🔒
- A listed rate-future rung, quoted at its price (
95.90): the curve fits the futures rate(100 − price)/100lessconvexity.contractis an IMM code ("DEC26"), a"YYYY-MM"month, or an explicit(start, end)window.convexityis a decimal adjustment, or"model"to read the market’s Hull-White model at solve time; zero is a statement that future and forward coincide, not a neutral default. Labelled by the contract. - future_
between 🔒 - The stated-future body both entry points forward to.
- future_
on 🔒 - The rate-future body both paths forward to.
- futures_
convexity 🔒 - The future’s convexity adjustment as a rate: its futures rate less the forward rate of the same contract with no adjustment.
- futures_
price 🔒 - The future’s fair price,
100 − rate, convexity-adjusted as the contract says. - fx_
delta 🔒 - The Garman–Kohlhagen delta of a
kindoption atstrike, underconvention— the core’sdelta, named for its market here. - fx_
forward 🔒 - An FX forward buying
base_amountofbaseagainstquoteatcontract_rateonvalue_date; cash-settled — a non-deliverable forward — when a settlement index (an FX key or anIndex), a fixing date and a settlement currency are all given. - fx_
option 🔒 - A vanilla FX option on
notional_baseofbase, struck at an absolutestrike, at the option’s own unsigneddeltaunder the surface’s convention, resolved against the smile, or as thequote_amountexchanged fornotional_base— exactly one of the three; cash-settled — a non-deliverable option — when a settlement index (an FX key, anIndexor a cross tuple), a fixing date and a settlement currency are all given. - fx_swap 🔒
- An FX swap: a near forward and an opposite far forward on one pair.
- fx_
swap_ 🔒helper - An FX-swap rung: the template’s FX swap, the near leg today at
spot, the far legtenorfrom the spot date at the quoted outright (outright=) or at the spot pluspoints=— exactly one of the two. The rung solves the foreign currency’s discount under the template’s collateral currency, and its quote is the outright the swap’s fair far rate verifies. - hull_
white_ 🔒convexity_ bias - The Hull-White convexity bias: the futures rate less the forward
under Hull-White for a contract whose term rate fixes at
tand runs tomaturity(years), atfutures_price. - ice_
gilt_ 🔒conversion_ factor - The ICE Long Gilt conversion factor of
bondfor the delivery month starting ondelivery_month_start: its clean price per unit nominal atnotional_coupon(a decimal) under gilt conventions, to seven decimals. - index_
credit_ 🔒default_ swap - An index CDS on
family("CDX.NA.IG"or"ITRAXX.EUROPE"),series, at the family’s standard coupon. - index_
family 🔒 - A credit index family’s template, by its code (
"CDX.NA.IG","ITRAXX.EUROPE"); an unknown family is aValueError. - index_
intrinsic 🔒 - An index CDS measured against its constituents:
(value, spread), the replicating single-name portfolio’s value and duration-weighted spread.constituentsare(entity, weight)pairs, the weight each name’s share of the original index notional. - index_
ratio 🔒 - The linker’s index ratio at
date: the lagged index level over the base. - index_
skew 🔒 - The skew that makes an index’s constituents reprice it:
instrumentsare index CDS at strictly ascending maturities, each valued on the index’s own curve inmarket;constituentsare(entity, weight)pairs asindex_intrinsictakes them. Solved tenor by tenor. - inert_
convention 🔒 - A builder applied to a family that carries the convention but whose constructor here cannot read it.
- inflation_
linked_ 🔒bond - An inflation-linked bond paying
real_coupononfacegrown byindexfrombase_index, observedlag_monthsbefore each date. - instantaneous_
forward 🔒 - The instantaneous forward
f(0, date)offcurve: a centred difference of−ln P(0, ·)over a week, the stencil the lattice fit uses. - interest_
rate_ 🔒cap_ floor - A cap or floor on a registered
index: a strip of options on the index’s own coupons fromeffectivetotermination, onnotional, struck atstrike;kindiscaporfloor. - inv_
norm_ 🔒cdf - The inverse of the standard normal cumulative distribution.
- lag_
days 🔒 - A lag in business days as a template takes it: forward, and within a year.
- linker_
invoice 🔒 - The linker’s settlement invoice at a real clean quote:
(index_ratio, clean, accrued, dirty)per 100 nominal. - linker_
real_ 🔒price - The real dirty or clean price at a street real yield — TIPS, Canadian RRBs and UK gilts at the three-month lag.
- linker_
real_ 🔒yield - The street real yield implied by a real clean quote.
- loan 🔒
- A fixed-rate loan over
schedule:notionaldrawn on its first date, interest atfixed_rateonday_countpaid at each period’s end, and the principal repaid on its last date.borrower=Truetakes the drawdown and pays the servicing;Falsebooks the lender’s side.amortisation="Straight-Line"repaysnotional / nat each of thenperiod ends instead, each period’s interest on what is still outstanding.issuertags the borrower’s credit: the servicing survival-weighted with recovery on the outstanding, the drawdown risk-free. - locator_
of 🔒 - meeting 🔒
- A meeting rung: the meeting-dated swap
locatornames atrate, noded at the window’s end (where its accrual ends, not where it pays: the knot is the decision), its pillar carrying the deciding meeting so the solved curve is a step curve and risk reads per decision; labelled by bank and meeting date (FED 2026-12-09). - meeting_
ois 🔒 - A meeting-dated overnight swap on a meeting-OIS template: one fixed coupon
at
fixed_rateon the template’s fixed day count against one compounded overnight coupon over the windowlocatornames — a(start, end)pair, the n-th decision aftervaluationclosing at the next, or a decision date closing at the next, the ordinal and the decision resolving to effective dates againstscheduleor the seeded one — both paid the template’s payment lag after the window end (two business days for USD, as its OIS pays). It is an overnight indexed swap over one period, and prices, quotes and risks as one. - no_
such_ 🔒convention - A builder applied to a family whose conventions do not carry it.
- norm_
cdf 🔒 - The standard normal cumulative distribution.
- note_
components 🔒 - A credit-linked note’s
(coupons, redemption, recovery)components. - note_
dirty_ 🔒price - A structured note’s value per 100 of face — its dirty price.
- note_
z_ 🔒spread - The z-spread implied by a structured note’s dirty price per 100: the flat
continuous spread over its discounting that reprices it, the coupons
projected spread-free — Rust’s
note_z_spread. - nth_
to_ 🔒default_ swap - An nth-to-default basket on
entitiesunder one pairwise correlation:correlation, a contract term with no risk row, orcorrelation_key, the market’s basket correlation under that key — exactly one. Withfactor_dofandidiosyncratic_dof, both or neither, the double-t copula (Rustwith_student_t) in place of the Gaussian; or withcopula_dof_key, a credit index id, the double-t on the degrees of freedom the market marks for it (Ruston_market_copula_dof), with risk rows. - on_
linker_ 🔒view - Resolve the fixings and inflation curve a linker street measure reads.
- on_
the_ 🔒run - The series of
familyon the run ondate: the latest to have rolled on or before it. - on_view 🔒
- Resolves
instrument’s declaration againstmarketand runsfon the passive view, with the lock released — the same seam a valuation uses. - ordered 🔒
- Refuses a contract whose end is not after its start, naming both dates.
- package_
value 🔒 - A repo’s value with its collateral: the cash leg plus the bond received, less the bond returned at its repo forward, less — classic — the coupons manufactured back. A cross-currency repo’s foreign bond is valued on its own currency’s curve and converted at spot.
- par_
rungs 🔒 - The par rungs of a swap ladder, each carrying the tenor it was quoted at:
the swap
template’s swap from its spot date to each tenor at the quoted fixed rate, noded at its final payment date, in pillar order — whatcalibration.curvetakes.quotesis a mapping of tenor to rate or a list of(tenor, rate)pairs;templatea registered code or aTemplate. - parse_
fit_ 🔒weights - A fit weighting by the package’s spelling.
- parse_
fitted_ 🔒form - A parametric fit form by the package’s spelling.
- parse_
linker_ 🔒convention - A linker street convention by the package’s spelling.
- payer_
swaption 🔒 - A European payer swaption under Hull-White, per unit notional: the
par-struck put on the coupon bond paying
fixed_rate × accrualonpay_datesplus redemption, oncurve. - payment_
in_ 🔒kind_ bond - A bond that pays its coupon in more of itself: the face accretes at
rateinstead of paying cash. - premium_
contract 🔒 - The credit default swap a tranche, an nth-to-default basket, an index CDS or a credit-linked note pays its premium on, as an instrument of its own: its premium leg is the product’s premium schedule, its entity the curve the product references, and it books and prices like any CDS.
- pv_
weighted_ 🔒time - The PV-weighted mean time of
flows, given as(time_in_years, amount)pairs, atyield_underyield_convention: Macaulay duration in yield space, spread duration in curve space — one mechanism, two names. Bare flows carry no coupon frequency, so the convention names the compounding outright and"default"reads as annual. - receiver_
swaption 🔒 - A European receiver swaption under Hull-White, per unit notional: the
par-struck call on the same coupon bond as
payer_swaption. - receives_
fixed 🔒 - Whether an inflation swap’s holder receives the fixed leg:
receivesnames the leg ("inflation", the default, or"fixed"), andreceiveris its older spelling,Truefor receiving fixed. The two are not given together. - reference_
index 🔒 - The street reference index at
dateunder a named observation. - reference_
on 🔒 - What a single-name credit builder references: a full
ENTITY/SENIORITY/DOCCLAUSEspelling as given, or a bare entity on the template’s standard tier and clause — the template, not the identity, carries the default. Where the contract’scurrencyis known, the market’s own keyENTITY/SENIORITY/DOCCLAUSE/CCYis accepted too, so one curve has one spelling; its currency must be the contract’s. - register 🔒
- register_
analytics 🔒 - Registers every analytic on the module.
- register_
bond_ 🔒option_ readings - Registers the readings of the bond option and the bond future option.
- register_
curve_ 🔒helpers - The
calibration.helpersmodule: one function per pillar kind. - register_
repack 🔒 - register_
structured_ 🔒notes - Registers the structured note’s constructor and readings.
- registered_
code 🔒 - The registered template under
code, or the known codes by name. The registry’s own spelling ofcode— the'staticcode a template source names — or the empty string where it is not registered, which the caller has already refused. - repack_
arm 🔒 - repack_
gap 🔒 - The repack gap charge of
noteagainstmarket, under the note’s engine. - repack_
note 🔒 - A single-asset repack note on
asset_swap— the SPV’s, as its buyer — whose collateral is issued byissuer, ofnotional, booked fromrepack_role, its gap priced underengine, with an optional valuationtrigger. On a cross-currency asset swap the notes are in its floating currency and the gap issimulate_repack_gap’s alone. - repo_
margin 🔒 - A repo’s margin position against
market:exposure,collateral_valueon the margin basis,required,excess(negative is a call) andhaircut. The collateral is priced off its curves, or atpriceper 100. - repo_on 🔒
- The repo body both paths forward to.
- risky_
value 🔒 - The survival-weighted value of
flows—(date, amount)pairs — plus a recovery-of-face leg: each flow pays only if the issuer survives to its date, and default paysrecovery × faceon the face at the midpoint of each quarter-long interval fromdefault_fromtomaturity. - rung_
err 🔒 - series_
maturity 🔒 - The maturity of
seriesoffamilyattenor_years: three months after its roll and the tenor on. An off-the-run series keeps it. - series_
roll 🔒 - The nominal date
seriesoffamilyrolls on: the 20th of March or September, six months a series from the family’s anchor. - settlement_
date 🔒 - The date a payment-in-kind bond traded on
trade_datesettles on: its settlement lag walked from it, never before issue. - sheet_
locator_ 🔒of - A meeting window as Python spells it: a
(start, end)pair of dates, an integer ordinal (the n-th seeded meeting after the valuation date) or a meeting date. Where a quote sits, in a sheet’s spellings: a string ("4Y","SEP27","2027-03-18","2026-10-29 - 2026-12-10","SEP27 - DEC27"), a date, or a pair of dates or contract codes. - sigma_
from_ 🔒price - The Hull-White σ at which the zero-bond option prices at
target_price, as(sigma, d_sigma_d_price, price)— the implicit-function derivative of the fit beside it — orNonewhere no σ reaches the price.model’s mean reversion is held; its σ is ignored. - simple_
margin 🔒 - The note’s simple margin at a quoted clean price — the closed-form shortcut to the discount margin. No curve, no projection, no solve.
- simulate_
repack_ 🔒gap - The repack gap of
noteagainstmarketby Monte Carlo: crises, the valuation trigger and its liquidation lag included. - simulate_
repack_ 🔒gap_ risk - The simulated gap’s sensitivity to every lifted input of
market, by a central difference on common random numbers:inputandvalue. - simulation_
settings 🔒 - The settings, a refused one a
ValueErrorlike any malformed argument. - spread_
duration 🔒 - The note’s spread duration: its sensitivity to a flat continuous overlay on the discounting, and its dominant risk.
- stated_
dates 🔒 - The stated contract dates of a verb with two forms:
Nonefor the derived form, the dates when every one is stated. Giving both forms, or only some of the stated dates, is refused naming them. - straddle 🔒
- Two options of one strategy booked as one product — a straddle, or a
strangle when the strikes differ: FX options on one pair or European
swaptions in one currency. Worth the options’ sum;
Instrument.implied_volquotes it on one flat vol, the way a straddle is quoted. - street_
index_ 🔒ratio - The linker’s street index ratio at
date, by its market’s convention. - strike_
from_ 🔒delta - The strike whose signed delta is
targetunderconvention— calls positive, puts negative. - strip_
caplet_ 🔒smile - Caplet vols from a quoted cap matrix: one surface carrying a smile, in which each strike column is the caplet ladder stripped at that strike.
- strip_
caplet_ 🔒vols - Caplet vols stripped from term cap quotes on a registered term
index:quotesare(termination, vol)pairs ascending in termination, each the flat vol the cap fromeffectiveto that date is quoted at;strikeis the caps’ common strike, or each cap’s own at-the-money rate when omitted. The surface returned reprices every quoted cap exactly, pinned withwith_cap_vols. - strip_
from_ 🔒callable - The co-terminal swaption strip a callable implies: one
(expiry, end)per exercisable call, each running to the bond’s maturity. - structured_
note 🔒 - A structured note:
leg, received, andfaceredeemed at its last payment date, discounted on the leg’s key — any composed coupons (IBOR, overnight, CMS or CMS spread, with collars or digitals, or range accruals), built from whatever cashflows the legs hold.issuertags it to that name’s credit (survival-weighted, recovery of face per coupon period);security_spreadcomposes the spread pinned under that key onto its discounting, the coupons still projecting spread-free. - swap 🔒
- A swap rung on an OIS or IRS template: at a tenor, the template’s par
swap from spot, noded at its final payment — one rung of
par_rungs; over a window —(start, end)as dates or contract codes, or the string spellings"2027-09-15 - 2027-12-15"and"SEP27 - DEC27"— the one-period forward swap over it on an OIS template, noded at the window end with no meeting identity. On an NDS template, at a tenor, the template’s NDS at that par rate, marking its index’s projection against the held settlement and offshore discounts. - swap_
conventions 🔒 - The conventions a swap booked between
effectiveandterminationontemplate(a registered overnight swap template code) or onindex(a registered index code, whose family decides the swap) will carry, as a table offieldandvalue— read before anything is booked, from the same buildervanilla_swapbooks through. Exactly one of the two is named. - swap_
from_ 🔒legs - A fixed-versus-floating swap from two legs — an amortising, stepped or otherwise nonstandard swap built coupon by coupon, booked as one trade.
- swap_
index_ 🔒code - The registry code of the rate index a swap template projects off.
- swap_
template 🔒 - A vanilla swap template of the caller’s own: fixed at
frequencyonfixed_day_countagainst the termindex— anIndexvalue or a registry code — paying on the index’s tenor and accruing on its day count, scheduled oncalendarunderbusiness_day_conventionfromspot_lagbusiness days after valuation. Refine it with the template’swith_*methods —with_leg_conventions("float", frequency=)where the floating leg pays otherwise — and draft on it withvanilla_swap, as on a registered template. It never enters the registry; it carriesname. - swaption_
underlying 🔒 - The swap a swaption confers, from the handle the package built it as.
- template 🔒
- template_
by_ 🔒code - The registered template under
code, as a value. - template_
value 🔒 - The
(pillar, instrument, quote)par rungs of a swap ladder, built from the swaptemplateandquotes— a mapping of tenor ("1Y","10Y") to par rate, or a sequence of(tenor, rate)pairs — dated by the template’s own conventions and noded at each swap’s final payment; whatcalibration.curvetakes. The rungs come back in pillar order whatever order the quotes were given in.templateis a registered code or aTemplate, registered or customised. A template as the ladder builders take it: aTemplatevalue, registered or customised, or a registry code resolved here — with the code either way, which labels the rungs and names the template in a refusal. - templates 🔒
- Every registered template as a table:
code, the spellingtemplatetakes;family, asTemplate.familyreads it; and the registry’s owngroupandnameit is filed under. - tenor_
basis 🔒 - A tenor basis rung: the template’s basis swap from spot to
tenorcarryingspreadon its spread leg, declared as a spread rung. - tenor_
quotes 🔒 - Tenor-to-rate quotes as the ladder builders take them: a mapping, read in
insertion order, or a sequence of
(tenor, rate)pairs. Either way the tenor is a period string and the quote a number. - term_
index 🔒 - A registered term index, or the refusal naming what was asked for.
- turn 🔒
- A turn rung: the window
[start, end]on a meeting-OIS template quoted atsegment_rate, the simple forward over the window — the surrounding level plus the jump, as a desk states a year-end turn — noded atendand carrying the turn as its pillar’s identity; labelledturn <start>. A turn is a window: the ladder needs a pillar atstarttoo, which a meeting rung ending there supplies. - uk_
money_ 🔒accrued - The UK money accrued per 100 at
settlement. - uk_
money_ 🔒price - The UK money dirty price at a semiannual real yield.
- uk_
money_ 🔒yield - The DMO money yield a real yield implies under an assumed inflation rate.
- uk_
real_ 🔒yield_ from_ money - The real yield a DMO money yield implies — the inverse of
uk_money_yield. - uk_
real_ 🔒yield_ from_ money_ dirty - The semiannual real yield implied by a UK money dirty price — the
inverse of
uk_money_price. - unreachable_
convention 🔒 - A builder applied to a family that carries the convention and whose product reads it, but which this class cannot build.
- weekly_
bond_ 🔒future_ option_ from_ template - The weekly option designated to expire on
expires_onunder the futures option templatecode: its last trading day and the quarterly future it exercises into by the exchange’s weekly rule, the rest asbond_future_option_from_template. CBOT’s and Eurex’s weeklies are drafted; a day the exchange lists no weekly for is refused. - with_
equity_ 🔒funding - The equity swaps’ shared funding terms.
- wrap 🔒
- wrong_
family 🔒 - xccy_
basis 🔒 - A cross-currency basis rung: the template’s swap from spot to
tenorcarryingbasison its quoted leg, the other leg’s notional atfx_rate(units of the other currency per one of the quoted) — one rung ofcross_currency_rungs. - xccy_of 🔒
- The cross-currency template
found, or a refusal namingconvention_name. - xccy_on 🔒
- The cross-currency body both paths forward to.
- xccy_
quote 🔒 - The quote a template’s quoted leg takes:
spread=where it floats,fixed_rate=where it is fixed; the other is refused by name, as is giving neither. - xccy_
side 🔒 - The side of
tthatlegnames:"leg1","leg2", or a leg’s currency. - yield_
convention_ 🔒status - The vendor calc methods’ convention status, one row per registered code:
code,name,status("pinned"or"pending") andoutstanding(what a pending code awaits, empty when pinned) — Rust’sVendorCalcMethod::registry()as a table. - yield_
to_ 🔒call - The yield to the callable’s exercise on
date, at a dirty price. - yield_
to_ 🔒maturity_ scenario - The callable’s yield to maturity scenario at a dirty price: the yield
of the redemption at par on the maturity date — the scenario
yield_to_worstranks the exercise dates against. - yield_
to_ 🔒worst - The callable’s yield to worst at a dirty price: the lowest yield over maturity and every remaining exercise date, with the date attaining it.
- yoy_
inflation_ 🔒cap_ floor - A year-on-year inflation cap or floor on
index: a strip of options on the index’s annual growthI(end)/I(start) − 1, struck atstrike;kindiscaporfloor. The periods are the year-on-year swap’s on the same dates — annual frombase_dateup to and includingmaturity, unadjusted — each observedlag_monthsback and accruing onday_count(ACT/365F whenNone). Each optionlet reads the index’s YoY vol surface (MarketContext.with_yoy_vols). - yoy_
inflation_ 🔒swap - A year-on-year inflation swap on
index: a strip of annual index ratios against a strip of fixed coupons, each period settling on its own end date. - zcs_
between 🔒 - The stated-ZCS body both entry points forward to.
- zcs_on 🔒
- The zero-coupon-swap body both paths forward to.
- zero_
bond_ 🔒option - A European option on a zero-coupon bond under Hull-White, per unit face:
the closed form on the
bond_maturitydiscount bond, struck atstrike, exercised atexpiry.kindis"call"or"put". - zero_
coupon_ 🔒bond - A zero-coupon bond: a short-dated zero-coupon government security quoted on a discount yield taken on the face.
- zero_
coupon_ 🔒inflation_ cap_ floor - A zero-coupon inflation cap or floor on
index: atmaturityit paysnotional · max(ω(I(T)/I(T0) − (1+strike)^τ), 0),ωone for a cap and minus one for a floor,strikethe annualised zero-coupon rate andτtheday_count(ACT/365F whenNone) frombase_datetomaturity— the year fraction the zero-coupon inflation swap on the same dates compounds its fixed rate over, so a cap less a floor is that swap. Both levels are observedlag_monthsback; the option reads the index’s CPI vol surface (MarketContext.with_cpi_vols): Black on the forward ratio, or Bachelier on it. - zero_
coupon_ 🔒inflation_ swap - A zero-coupon inflation swap on
index: one payment each side atmaturity, the inflation side paying the index’s growth frombase_dateand the fixed side the growthfixed_rateimplies. - zero_
coupon_ 🔒quotes - The three quotes a zero is traded on, and the price behind them:
(price, discount_yield, money_market_yield, bond_equivalent_yield, quoted_yield).