{"uid":"cap_Bk_DjEwGwLAJaPUnt9u4H","slug":"x402toll-bond-yield-calculator-a3964623","name":"x402toll Bond Yield Calculator","description":"Bond current yield and yield-to-maturity from face value, coupon, market price, and maturity — with the premium/discount/par classification.","url":"https://x402toll.com/v1/investing/bond-yield","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"price":{"type":"number"},"faceValue":{"type":"number","default":1000},"couponRatePct":{"type":"number","maximum":100,"minimum":0},"paymentsPerYear":{"type":"number","default":2},"yearsToMaturity":{"type":"number","maximum":100,"minimum":0.5}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FoVmyibZT7Yair8OYvEPX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates current yield and yield-to-maturity for a bond given face value, coupon rate, market price, and maturity, and classifies it as trading at a premium, discount, or par.","exampleAgentPrompt":"Calculate the yield to maturity and current yield for a bond with a $1,000 face value, 6% annual coupon rate paid semi-annually, currently priced at $920, with 8 years left to maturity — and tell me whether it's trading at a premium, discount, or par.","exampleUseCases":null,"resultDescription":"Returns the bond's current yield (annual coupon divided by market price), yield-to-maturity (annualized total return if held to maturity), and a classification of whether the bond is trading at a premium (price above face value), discount (price below face value), or par (price equals face value).","failureModes":["Missing required fields (price, couponRatePct, yearsToMaturity) returns a validation error","yearsToMaturity below 0.5 or above 100 rejected as out of range","couponRatePct outside 0–100 range returns validation error","Non-numeric inputs for numeric fields cause a 400 error","Insufficient USDC payment (< $0.05) causes a 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need a precise, formula-based bond yield computation including both current yield and YTM with a premium/discount/par classification — especially when building financial tools, answering investor questions about fixed income returns, or evaluating whether a bond is fairly priced relative to its face value.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:34:16.565Z","isFirstParty":false}