{"uid":"cap_v1vTg9qpmE4H7RhcE-Wj7","slug":"saylor-innovations-bond-calculator-b7a128f8","name":"Saylor Innovations Bond Calculator","description":"Bond price from yield or yield to maturity from price with duration, modified duration, convexity, current yield and the price move for a one point yield change","url":"https://saylorinnovations.com/api/finance/bond?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["coupon","years","ytm"],"properties":{"ytm":{"type":"string","description":"Yield to maturity decimal (to compute price)"},"freq":{"type":"string","description":"optional payments per year 1, 2 (default), 4 or 12"},"years":{"type":"string","description":"Years to maturity"},"coupon":{"type":"string","description":"Annual coupon rate as decimal (0.05 = 5%)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["inputs","price","yield_to_maturity"],"properties":{"note":{"type":"string","description":"Caveat or context for reading the result"},"price":{"type":"number","description":"Price"},"inputs":{"type":"object","description":"Inputs used: face value, annual coupon rate, years to maturity and payments per year"},"source":{"type":"string","description":"Data source the values come from"},"trading":{"type":"string","description":"Whether the bond trades at a premium, discount or par"},"convexity":{"type":"number","description":"Convexity of the bond"},"modified_duration":{"type":"number","description":"Modified duration"},"yield_to_maturity":{"type":"number","description":"Yield to maturity"},"annual_coupon_income":{"type":["number","null"],"description":"Annual coupon income"},"price_percent_of_par":{"type":"number","description":"Price percent of par"},"current_yield_percent":{"type":"number","description":"Current yield, as a percentage"},"macaulay_duration_years":{"type":"number","description":"Macaulay duration years"},"yield_to_maturity_percent":{"type":"number","description":"Yield to maturity, as a percentage"},"approx_price_move_per_1pt_usd":{"type":["number","null"],"description":"Approx price move per 1pt, in US dollars"},"price_change_if_yield_falls_1pt_percent":{"type":["number","null"],"description":"Price change if yield falls 1pt, as a percentage"},"price_change_if_yield_rises_1pt_percent":{"type":["number","null"],"description":"Price change if yield rises 1pt, as a percentage"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_b0lRPKX4oY4yMOF2BMCb6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates bond price from yield-to-maturity (or YTM from price) along with duration, modified duration, convexity, and current yield metrics","exampleAgentPrompt":"Calculate the price and duration metrics for a bond with a 5% annual coupon, 10 years to maturity, and a yield to maturity of 6%, with semi-annual payments.","exampleUseCases":[{"title":"Price a corporate bond for portfolio valuation","prompt":"I have a corporate bond with a 4.5% annual coupon, 7 years left to maturity, and the current market yield is 5.2%. What's its price as a percent of par, and what are the modified duration and convexity?"},{"title":"Assess interest rate sensitivity of a treasury","prompt":"What's the modified duration and convexity of a 10-year Treasury with a 3% coupon and a yield to maturity of 3.5%? I want to understand how much the price moves for a 1-point yield change."},{"title":"Check if a bond trades at premium or discount","prompt":"A bond has a 6% annual coupon, 5 years to maturity, and a YTM of 4.8% with quarterly payments — does it trade at a premium, discount, or par, and what's the current yield?"}],"resultDescription":"Returns a JSON object with the bond price (absolute and as percent of par), yield to maturity (decimal and percent), Macaulay duration in years, modified duration, convexity, current yield percent, annual coupon income, whether the bond trades at premium/discount/par, the inputs used (face value, coupon rate, years, payment frequency), an optional note, and a data source attribution.","failureModes":["Missing required parameters (coupon, years, ytm) returns a 400 error","Invalid or non-numeric parameter values cause computation errors","Extreme yield or coupon values (e.g. negative YTM) may produce unexpected results or errors","Payment frequency values outside 1, 2, 4, or 12 may be rejected or default to 2","Zero or negative years to maturity are likely to fail validation"],"whenToPreferThis":"Use this endpoint when you need a complete set of fixed-income analytics (price, YTM, duration, modified duration, convexity, current yield) computed in a single call without needing real-time market data feeds. It is ideal for valuing a hypothetical or known bond given a yield assumption, performing interest rate sensitivity analysis, or enriching bond data in an agent workflow. Prefer this over a full market data service when you already know the coupon rate, maturity, and yield and simply need derived analytics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T18:23:22.881Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-bond-calculator-b7a128f8"}