{"uid":"cap_H41UdjTOS-v4_VuAGWIyK","slug":"irr-calculator-internal-rate-of-return-83c73a2a","name":"IRR Calculator (Internal Rate of Return)","description":"Internal rate of return (per period) of a series of cash flows, solved with a bounded bisection. Requires at least one positive and one negative flow; flows with no sign change or no bracketable root are rejected as a clean 400.","url":"https://finance.openverbs.com/v1/irr","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["cashflows"],"properties":{"cashflows":{"type":"array","items":{"type":"number"},"maxItems":10000,"minItems":2,"description":"Cash flows by period; index 0 is time 0. Needs mixed signs."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fKKU5CEDGhKZIM4r10H1i","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes the internal rate of return per period for a series of cash flows using bounded bisection, rejecting flows without sign changes or a bracketable root.","exampleAgentPrompt":"Calculate the IRR for this investment: I put in -10000 at time 0, then receive 3000, 4000, 4500, and 5000 over the next four periods — what's the per-period rate of return?","exampleUseCases":[{"title":"Capital budgeting project evaluation","prompt":"I'm evaluating a factory expansion: we invest -500000 upfront, then expect cash inflows of 120000, 150000, 180000, 200000, and 220000 over the next five years. What's the IRR so I can compare it to our 12% hurdle rate?"},{"title":"Private equity fund return analysis","prompt":"Our fund deployed -2000000 at inception, had interim distributions of 300000 and 500000 in years 2 and 4, and returned 3200000 at exit in year 6. Can you compute the IRR on those cash flows?"},{"title":"Real estate investment return check","prompt":"I bought a rental property for -450000, collect net rents of 24000 per year for 8 years, then sell it for 600000. What's the annual IRR on that cash flow stream?"}],"resultDescription":"Returns the computed internal rate of return per period (as a decimal rate) for the provided cash flow series. If the cash flows have no sign change or no bracketable root, the endpoint returns a 400 error with a clear rejection message.","failureModes":["All cash flows have the same sign (no sign change) — returns 400","No bracketable root exists for the given cash flow pattern — returns 400","Fewer than 2 cash flows provided — returns 400 (minItems violated)","More than 10,000 cash flows provided — returns 400 (maxItems violated)","Non-numeric values in cashflows array — returns 400 schema validation error","Multiple IRRs exist for non-conventional cash flows — bisection may return one root without warning"],"whenToPreferThis":"Use this endpoint when you need to solve for the discount rate that makes the NPV of a cash flow series equal to zero — the classic IRR computation. It is ideal for capital budgeting, investment comparisons, and return analysis where the cash flows have mixed signs. The bounded bisection solver is robust for conventional cash flows. Prefer this over manual NPV iteration or spreadsheet solvers when building automated financial analysis pipelines. Choose the sibling NPV endpoint instead if you already know the discount rate and want to compute net present value directly.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:41:23.321Z","isFirstParty":false}