finite_difference
callable/puttable convertible or exchangeable bond with credit
incomenumericIFRS 9IFRS 13deferred
Formula reference: Tsiveriotis-Fernandes lattice / intensity / finite-difference / LSMC
Inputs
| Name | Type | Req | Description |
|---|---|---|---|
| spot | number | ✓ | Spot price of the underlying (or FX rate for garman_kohlhagen). |
| face | number | ✓ | Bond face value. |
| coupon_rate | number | ✓ | Annual coupon rate (decimal). |
| maturity | number | ✓ | Time to expiry in years (0.5 = six months); > 0. |
| conversion_ratio | number | ✓ | Shares received per bond on conversion. |
| volatility | number | ✓ | Annualized volatility (decimal, 0.30 = 30%); > 0. |
| risk_free | number | ✓ | Continuously-compounded risk-free rate (decimal). |
| credit_spread | number | ✓ | Credit spread over the risk-free rate (decimal). |
| call_schedule | array | ✓ | Issuer call schedule [{date_years, price}]; pass [] when there is none. |
| put_schedule | array | ✓ | Investor put schedule [{date_years, price}]; pass [] when there is none. |
| rights_priority | string | ✓ | Which right prevails when call and put coincide. |
Standards
Risks & limits
- Deterministic model: the result is a point value with no modelled distribution; input error and model error are not quantified here.
- Standards alignment is declared per method; see the cited clauses.
Call it
Try in playground →REST
curl -s -X POST https://fair-value.ascent-partners.com/v1/calculate/calculate_convertible_bond \
-H 'content-type: application/json' \
-d '{"method":"finite_difference"}'MCP
// MCP tools/call
{ "name": "calculate_convertible_bond",
"arguments": { "method": "finite_difference" } }