{"uid":"cap_OQGpzJ3FVs_i7whW6YmTy","slug":"hermes-plant-bond-analyzer-a111d3be","name":"Hermes Plant Bond Analyzer","description":"Deterministic fixed-income & loan analytics. Bond mode: solve price<->yield-to-maturity, current yield, Macaulay & modified duration, and convexity from the bond's terms. Loan mode (send principal + annualRate + termMonths): level-payment amortization with monthly payment, total interest/paid, and the full schedule. Pure math from caller-supplied terms — no market-data feed, no fabrication.","url":"https://hermesplant.com/api/agent-services/bond/analyze","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"type":{"type":"string"},"price":{"type":"number"},"yield":{"type":"number"},"periods":{"type":"number"},"faceValue":{"type":"number"},"frequency":{"type":"number"},"principal":{"type":"number"},"annualRate":{"type":"number"},"couponRate":{"type":"number"},"termMonths":{"type":"number"}}},"responseSchema":{"type":"json","example":{"bond":{"price":957.348986,"currentYield":0.052228,"totalCoupons":250,"convexityYears":22.304728,"priceValuation":"discount","couponPerPeriod":25,"yieldToMaturity":0.06,"macaulayDurationYears":4.471679,"modifiedDurationYears":4.341436},"loan":null,"type":"bond","service":"bondlens","findings":[{"fix":null,"why":"Whether the bond trades above (premium), below (discount), or at par.","rule":"bond-valuation","evidence":"price=957.348986 face=1000 -> discount","severity":"info"}],"requestId":"bl-8e084b70"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Wp9MApFEYy3mRzz9V5RIT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a bond's price, yield-to-maturity, duration, convexity, and valuation status given its cash flow parameters","exampleAgentPrompt":"Analyze a 5-year bond with a $1,000 face value, 5% annual coupon paid semiannually, and a 6% yield to maturity — I need the price, current yield, YTM, Macaulay duration, modified duration, convexity, and whether it's trading at a premium or discount.","exampleUseCases":null,"resultDescription":"Returns a JSON object with the computed bond price, current yield, yield-to-maturity, coupon per period, total coupons, Macaulay duration in years, modified duration in years, convexity in years, a price valuation label (premium/discount/par), and a findings array with plain-language explanations of key metrics including severity and evidence strings.","failureModes":["Invalid or missing bond parameters return a 4xx error","Inconsistent coupon/maturity combinations may produce NaN metrics","Unsupported bond structures (e.g. callable, floating rate) may return null or partial results","Network timeout if service is unavailable","x402 payment failure if wallet has insufficient USDC balance"],"whenToPreferThis":"Use this endpoint when an AI agent needs deterministic, test-backed bond analytics — price, YTM, duration, convexity — for fixed-rate bonds in a pay-per-call context. Prefer it over general-purpose LLM math when you need auditable, reproducible quant results with structured findings and no hallucination risk. Best for trading agents, portfolio risk pipelines, or financial advisory bots that need reliable fixed income metrics on demand.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:43:21.301Z","isFirstParty":false}