Investing

Bond current yield and yield-to-maturity from face value, coupon, market price, and maturity — with the premium/discount/par classification.

Bond current yield and yield-to-maturity from face value, coupon, market price, and maturity — with the premium/discount/par classification.

Payment: x402 ($0.05 USDC on eip155:8453). Call unpaid to receive an HTTP 402 with requirements, then retry with the PAYMENT-SIGNATURE header. Method: current yield = annual coupon ÷ price; YTM = periodic rate solving price = Σ coupon/(1+y)ᵏ + face/(1+y)ⁿ (bisection), annualized × payments/yr

post/v1/investing/bond-yield

Request

  • Base URL: (relative, and it does not resolve against the document’s source URL)
  • URL: /v1/investing/bond-yield
  • Auth: none declared

Request body

faceValuenumber
couponRatePctnumber required
pricenumber required
yearsToMaturitynumber required
paymentsPerYearnumber

Response

Verified result + provenance (formula, sources, reproducible SHA-256 hash).

Changes

No recorded changes to this operation across all 1 revision of this API.