fvfair-value
calculate_fixed_income

convexity

second-order price sensitivity

incomeclosed_formIFRS 13implemented

Formula reference: Convexity of the price-yield curve

Inputs

NameTypeReqDescription
facenumber✓Bond face value.
coupon_ratenumber✓Annual coupon rate (decimal).
yearsinteger✓Number of projection years n; equal len(cash_flows) when both are supplied.
ytmnumber✓Yield to maturity (decimal, annualised).
frequencyinteger✓Coupon payments per year (1=annual, 2=semi-annual).

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_fixed_income \
  -H 'content-type: application/json' \
  -d '{"method":"convexity"}'
MCP
// MCP tools/call
{ "name": "calculate_fixed_income",
  "arguments": { "method": "convexity" } }