# ROI calculator > How much did your investment return? See the total return, the gain and the yearly rate it equals. Calculate return on investment from what you put in and what you got back, with the annualized return (CAGR) over the years you held it. - Page: https://how.box/roi/ - Runs entirely in the browser. - License: HowToolbox's own text and data (titles, explanations, FAQs, tool descriptions and schemas, this file) are CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/); AI training and answers are welcome. Attribute "HowToolbox (how.box)" with a link to the page used. Third-party data keeps its own terms; the name and logo are not licensed. Publisher: HowToolbox, contact@how.box. Terms: https://how.box/about/terms/ ## Inputs Answer link: https://how.box/roi/?currency={currency}&i={i}&f={f}&y={y} - `currency` (AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLF, CLP, CNY, COP, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLE, SLL, SOS, SRD, SSP, STN, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UYW, UZS, VES, VND, VUV, WST, XAF, XCD, XCG, XDR, XOF, XPF, XSU, YER, ZAR, ZMW, ZWG or ZWL): Currency the amounts are in (ISO 4217); no conversion. Example: `EUR`. - `i` (number 0.01 to 1e9): Amount invested at the start. Example: `10000`. - `f` (number 0 to 1e12): Final value including payouts. Example: `15000`. - `y` (number 0 to 100): Holding period in years. Example: `5`. Example answer: https://how.box/roi/?currency=EUR&i=10000&f=15000&y=5 A complete link carries the primary answer in the page HTML; a missing or invalid value shows the default page. ## Agent tools - `roi_calculate`: Return on investment from the amount invested, the final value (including payouts) and the holding period in years. - MCP, one POST to https://how.box/mcp: `{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"roi_calculate","arguments":{"currency":"EUR","invested":10000,"final_value":15000,"years":5}}}` - GET: https://how.box/mcp/run/roi_calculate?currency=EUR&invested=10000&final_value=15000&years=5 ## How it works Return on investment tells you how much you gained compared with what you put in. Two investments can have the same total return over very different times, so the yearly rate is the fairer comparison: it is the steady growth per year that would give the same end result. With an amount invested I, a final value F and n years, ROI = (F − I) ÷ I × 100 and the annualized return is ((F ÷ I)^(1/n) − 1) × 100. For example, €10,000 that grows to €15,000 in 5 years is a 50% return, or 8.45% a year. The yearly rate is the compound annual growth rate (CAGR): $100 that becomes $800 in 15 years grew 14.9% a year. The calculation assumes one investment at the start and nothing added or taken out in between. Fees, taxes and inflation are not deducted unless you leave them out of the final value. Past returns don't predict future ones. ## FAQ **What is a good ROI?** It depends on the time and the risk. Compare the annualized return with alternatives over the same period, such as a savings account or an index fund. **Why is the yearly rate less than the total divided by the years?** Because growth compounds: each year's gain also grows in later years. A 50% return over 5 years is 8.45% a year, not 10%. **Should dividends be included?** Yes. Add payouts you received, such as dividends, interest or rent, to the final value, or the return looks smaller than it was. **Can I use it for a loss?** Yes. A final value below the amount invested gives a negative return, and a final value of zero is a total loss of −100%. **Can I use this for monthly contributions?** No. This calculation assumes a single initial investment. Contributions made later need a calculation that accounts for when each payment was made. More: [HowToolbox index](https://how.box/llms.txt) · [Agent Skill](https://how.box/skill.md) · [agent terms](https://how.box/about/agents/)