{"uid":"cap_X-Em12jSBYk-n_75zYrpH","slug":"bond-price-calculator-fixed-coupon-yield-to-maturity-7c3ea6bc","name":"Bond Price Calculator (Fixed-Coupon, Yield to Maturity)","description":"Price a fixed-coupon bond from its yield to maturity: present-value the coupons plus face. Returns clean price, coupon per period, current yield, and premium/discount vs par.","url":"https://agent402.tools/api/bond-price","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"years":{"type":"number","description":"Years to maturity"},"faceValue":{"type":"number","description":"Par/face value repaid at maturity"},"couponRate":{"type":"number","description":"Annual coupon rate as decimal (0.05 = 5%)"},"periodsPerYear":{"type":"number","description":"Coupon periods per year (2 = semiannual). Default 2."},"yieldToMaturity":{"type":"number","description":"Annual yield to maturity as decimal"}}},"responseSchema":{"type":"json","example":{"price":925.61,"periods":20,"currentYield":0.054018,"couponPerPeriod":25,"premiumOrDiscount":"discount"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_eV641g8Yzo3I3TjGt0CZj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Prices a fixed-coupon bond from its yield to maturity by present-valuing coupons and face value, returning clean price, coupon per period, current yield, and premium/discount vs par.","exampleAgentPrompt":"Price a semiannual bond with a $1,000 face value, 5% annual coupon rate, 10 years to maturity, and a yield to maturity of 4% — is it trading at a premium or discount?","exampleUseCases":null,"resultDescription":"Returns clean bond price (present value of all cash flows), coupon payment per period, current yield (annual coupon / price), and the premium or discount relative to par/face value.","failureModes":["Missing required fields (years, faceValue, couponRate, yieldToMaturity) returns a validation error","Negative or zero yield to maturity may produce mathematical errors or undefined results","Extreme yield values (e.g. 0.0001 or 5.0) may produce unrealistic but technically valid prices","Non-numeric inputs for any field will cause schema validation failure","periodsPerYear of 0 would cause division-by-zero errors"],"whenToPreferThis":"Use this endpoint when you need to price a standard fixed-coupon bond from its yield to maturity and want clean price, current yield, and premium/discount in a single call. Prefer this over building your own DCF when working with bonds with regular periodic coupons and a known YTM. Not suitable for floating-rate bonds, zero-coupon bonds (unless couponRate=0 is handled), or bonds with irregular cash flows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:59:37.467Z","isFirstParty":false}