curatedapi

Internal rate of return (IRR) calculator

Internal rate of return of periodic cash flows, with every IRR reported when there is more than one.

Cash flows in time order, one per period. Money paid out is negative, money received is positive. 2 to 600 items. One per line, or separated by commas.
Set to 12 for monthly flows, 4 for quarterly, ... to also get the effective annual IRR.
More options: rounding and decimals
Precision and rounding
Rounding mode applied once to each result. Default half_even.
Round results to this many digits after the decimal point.
Round results to this many significant digits.

Examples

Result: Exactly 10%

IRR percent
IRR per period, in percent. Unit: percent.
10.0000 exact
All IRR percent
Every IRR found, lowest first, in percent.
10.0000
IRR is unique
True when there is exactly one IRR.
yes
Sign changes
How many times the cash flows change sign.
1

Rounding: Half even, 4 decimal places. Calculator finance/irr@1.

How it is calculated

Σ CFₜ / (1 + IRR)ᵗ = 0

Finds the discount rate at which the net present value of the cash flows is zero. Unlike spreadsheet IRR(), no starting guess is needed: all IRRs between −100% and the mathematical bound are searched, each one is pinned down with exact arithmetic, and the result is correctly rounded. When the cash flows change sign more than once there can be several IRRs; all are returned and a warning explains.

  • Cash flows are one period apart; the first one is at time 0.
  • Amounts are plain numbers in any single currency; no currency conversion is done.

References

Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.

Use it from your code

POST /v1/calc/finance/irrVersion 1
curl https://api.curatedapi.com/v1/calc/finance/irr \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cash_flows": ["-100", "110"]
  }'
The same call in Python
import os

import requests

payload = {
    "cash_flows": ["-100", "110"],
}
response = requests.post(
    "https://api.curatedapi.com/v1/calc/finance/irr",
    headers={"Authorization": f"Bearer {os.environ['CURATEDAPI_KEY']}"},
    json=payload,
    timeout=10,
)
print(response.json()["result"])
The same call in JavaScript
const payload = {
    "cash_flows": ["-100", "110"],
};
const response = await fetch("https://api.curatedapi.com/v1/calc/finance/irr", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CURATEDAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify(payload),
});
console.log((await response.json()).result);

MCP tool calc_finance_irr at https://mcp.curatedapi.com. Inputs, outputs and errors in the API reference.

Put it on your website

<div data-curatedapi-widget="finance/irr" data-key="capi_public_…"></div>
<script src="https://widgets.curatedapi.com/v1/widget.js" async></script>

Use a public key registered for your site. Calculations are billed like API calls. How widgets work.

Related calculators

Add this calculator to your website

Paste two lines into your page and your visitors get this calculator. Each use counts as one call on your plan, the same as the API.

Free for up to 1,000 uses a month. 50,000 uses a month cost $9.00 on the Starter plan.