fvfair-value
calculate_convertible_bond

finite_difference

callable/puttable convertible or exchangeable bond with credit

incomenumericIFRS 9IFRS 13deferred

Formula reference: Tsiveriotis-Fernandes lattice / intensity / finite-difference / LSMC

Inputs

NameTypeReqDescription
spotnumber✓Spot price of the underlying (or FX rate for garman_kohlhagen).
facenumber✓Bond face value.
coupon_ratenumber✓Annual coupon rate (decimal).
maturitynumber✓Time to expiry in years (0.5 = six months); > 0.
conversion_rationumber✓Shares received per bond on conversion.
volatilitynumber✓Annualized volatility (decimal, 0.30 = 30%); > 0.
risk_freenumber✓Continuously-compounded risk-free rate (decimal).
credit_spreadnumber✓Credit spread over the risk-free rate (decimal).
call_schedulearray✓Issuer call schedule [{date_years, price}]; pass [] when there is none.
put_schedulearray✓Investor put schedule [{date_years, price}]; pass [] when there is none.
rights_prioritystring✓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.
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" } }