{"slug":"agent402-tools-api-bond-ytm-4fca58","title":"Solve a bond's yield to maturity from its market price","host":"agent402.tools","method":"POST","resource":"https://agent402.tools/api/bond-ytm","category":"market","description":"Solve a bond's yield to maturity from its market price - the annual rate that present-values the coupons plus face to that price. Bracketed bisection root-find.","price_listed":0.002,"price_asked":0.002,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":930,"reported_calls_30d":5,"reported_payers_30d":1,"networks":["algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=","eip155:10","eip155:1329","eip155:137","eip155:143","eip155:42161","eip155:42220","eip155:43114","eip155:4663","eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","stellar:pubnet"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"couponRate":0.05,"faceValue":1000,"periodsPerYear":2,"price":925.61,"years":10},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"couponRate":{"description":"Annual coupon rate as decimal","type":"number"},"faceValue":{"description":"Par/face value","type":"number"},"periodsPerYear":{"description":"Coupon periods per year. Default 2.","type":"number"},"price":{"description":"Current market (clean) price","type":"number"},"years":{"description":"Years to maturity","type":"number"}},"required":["price","faceValue","couponRate","years"]},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"converged":{"type":"boolean"},"periods":{"type":"integer"},"yieldToMaturity":{"type":"number"}},"required":["yieldToMaturity","periods","converged"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.002,"price_match":true,"latency_ms":930,"error":null}],"description_full":"Solve a bond's yield to maturity from its market price - the annual rate that present-values the coupons plus face to that price. Bracketed bisection root-find.","last_updated":"2026-09-21T11:07:22.981Z","schemes":["exact","upto"]}