{"uid":"cap_FV2M3_9CXnaK2fPPjhUy5","slug":"finmath-bond-yield-to-maturity-ytm-calculator-f340ca49","name":"finmath Bond Yield to Maturity (YTM) Calculator","description":"Deterministic finance and crypto math for AI agents: TradFi (NPV, IRR, XIRR, Black-Scholes + Greeks, bonds, VaR, Sharpe) and DeFi (impermanent loss, perp liquidation, funding, Uniswap v3, health factor, cost basis). Exact, model-free arithmetic that LLMs get wrong — priced per call in USDC.","url":"https://finmath.qzqh5rrbkz.workers.dev/v1/bond_ytm","method":"POST","headers":{},"bodySchema":{"type":"object","required":["face","price","coupon_rate"],"properties":{"face":{"type":"number","description":"face"},"freq":{"type":"number","description":"freq"},"price":{"type":"number","description":"price"},"years":{"type":"number","description":"years"},"coupon_rate":{"type":"number","description":"coupon_rate"}}},"responseSchema":{"type":"object","required":["result","meta"],"properties":{"meta":{"type":"object"},"result":{}}},"example":{"request":{"face":1000,"freq":2,"price":950,"years":5,"coupon_rate":0.05},"response":{"meta":{"tool":"bond_ytm","disclaimer":"Deterministic calculation utility. Not financial, investment, or trading advice.","deterministic":true},"result":0.061776246408892316}},"exampleRequest":{"face":1000,"freq":2,"price":950,"years":5,"coupon_rate":0.05},"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0EVdcOOUi3vTUb93uduf6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes the yield to maturity (YTM) of a bond given its face value, market price, coupon rate, maturity, and payment frequency.","exampleAgentPrompt":"What's the yield to maturity on a bond with a $1,000 face value, currently priced at $950, a 5% annual coupon rate, 10 years to maturity, and semi-annual coupon payments?","exampleUseCases":null,"resultDescription":"Returns the calculated yield to maturity (YTM) as an annualized rate, along with metadata about the computation. The result is a deterministic, exact arithmetic answer — not an LLM estimate.","failureModes":["Missing required fields (face, price, coupon_rate) returns a validation error","Negative or zero price/face value may cause computation errors","Impossible yield scenarios (e.g. price far exceeding face with no plausible YTM) may fail to converge","Non-numeric inputs for numeric fields will cause schema validation failure"],"whenToPreferThis":"Use this endpoint when you need exact, deterministic bond YTM calculations rather than relying on an LLM's arithmetic. Ideal for fixed income analysis, portfolio tools, or any workflow requiring precise yield math. Prefer this over general-purpose LLMs which are known to make arithmetic errors on iterative financial computations like YTM.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:49:31.631Z","isFirstParty":false}