{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"roi"},"result":{"entity_type":"calculator","id":"roi","calculator_id":"roi","canonical_url":"https://tttkmbb.com/finance/roi","name":"ROI Calculator","title":"ROI Calculator – Return on Investment and Annualized Return","category":"finance","category_name":"Finance","tool_name":"calculate_roi","featured_mcp_tool":false,"description":"Computes the net gain and percentage return on investment from the amount invested and its final value, and the annualized (compound) return when the holding period in years is given.","use_when":"You want the total percentage return of an investment, project or marketing spend, optionally converted to a per-year rate for comparison across holding periods.","do_not_use_when":"There were multiple cash flows at different dates (that needs IRR/NPV), or you only need the growth rate between two values (use cagr).","inputs":[{"name":"initial_investment","label":"Amount invested","type":"number","required":true,"max":1000000000000,"exclusive_min":0,"description":"Total cost of the investment including fees.","example":10000},{"name":"final_value","label":"Final value","type":"number","required":true,"min":0,"max":1000000000000,"description":"Value at the end (sale proceeds plus any income received).","example":15000},{"name":"years","label":"Holding period","type":"number","unit":"years","required":false,"max":200,"exclusive_min":0,"description":"Optional length of the investment in years; enables the annualized return.","example":3}],"outputs":[{"name":"net_gain","label":"Net gain","type":"number","decimals":2,"description":"final_value − initial_investment (negative for a loss)."},{"name":"roi_percent","label":"ROI","type":"number","unit":"%","decimals":2,"description":"net_gain / initial_investment × 100."},{"name":"return_multiple","label":"Return multiple","type":"number","decimals":4,"description":"final_value / initial_investment (2 = money doubled)."},{"name":"annualized_roi_percent","label":"Annualized ROI","type":"number","unit":"%","decimals":2,"description":"((final_value / initial_investment)^(1/years) − 1) × 100; only when years is given."}],"input_schema":{"type":"object","properties":{"initial_investment":{"description":"Total cost of the investment including fees.","type":"number","maximum":1000000000000,"exclusiveMinimum":0,"examples":[10000]},"final_value":{"description":"Value at the end (sale proceeds plus any income received).","type":"number","minimum":0,"maximum":1000000000000,"examples":[15000]},"years":{"description":"Optional length of the investment in years; enables the annualized return. Unit: years.","type":"number","maximum":200,"exclusiveMinimum":0,"examples":[3],"x-unit":"years"}},"additionalProperties":false,"required":["initial_investment","final_value"]},"output_schema":{"type":"object","properties":{"net_gain":{"description":"final_value − initial_investment (negative for a loss).","type":"number"},"roi_percent":{"description":"net_gain / initial_investment × 100. Unit: %.","type":"number","x-unit":"%"},"return_multiple":{"description":"final_value / initial_investment (2 = money doubled).","type":"number"},"annualized_roi_percent":{"description":"((final_value / initial_investment)^(1/years) − 1) × 100; only when years is given. Unit: %.","type":"number","x-unit":"%"}}},"formula":"ROI = (final_value − initial_investment) / initial_investment × 100; annualized ROI = ((final_value / initial_investment)^(1 / years) − 1) × 100","method":"Simple holding-period return. The annualized figure is the equivalent constant compound rate (same as CAGR) and is only meaningful for periods of a year or more.","sources":[{"name":"Investopedia – Return on Investment (ROI): How to Calculate It","url":"https://www.investopedia.com/terms/r/returnoninvestment.asp","type":"reference","retrieved_at":"2026-09-23"},{"name":"Wikipedia – Return on investment","url":"https://en.wikipedia.org/wiki/Return_on_investment","type":"reference","retrieved_at":"2026-09-23"}],"freshness":{"type":"static","max_age_seconds":null,"note":"Deterministic formula with fixed constants; results never go stale. Inputs supplied by the caller determine the output."},"examples":[{"name":"10,000 grows to 15,000 in 3 years","inputs":{"initial_investment":10000,"final_value":15000,"years":3},"expected":{"net_gain":5000,"roi_percent":50,"return_multiple":1.5,"annualized_roi_percent":14.47},"url":"https://tttkmbb.com/api/v1/calculate/roi?initial_investment=10000&final_value=15000&years=3"},{"name":"2,000 falls to 1,500","inputs":{"initial_investment":2000,"final_value":1500},"expected":{"net_gain":-500,"roi_percent":-25,"return_multiple":0.75},"url":"https://tttkmbb.com/api/v1/calculate/roi?initial_investment=2000&final_value=1500"}],"faq":[{"q":"Why is the annualized ROI less than ROI divided by years?","a":"Because returns compound: 50 % over 3 years equals 14.47 % per year compounded, not 16.67 %, since 1.1447³ = 1.5."},{"q":"Should dividends or rent be included?","a":"Yes, add all income received to final_value and all costs (fees, taxes, repairs) to initial_investment to get a total return."}],"tags":["roi","return on investment","annualized return","investment gain","percentage return"],"related":[{"calculator_id":"cagr","reason":"Compound annual growth rate between two values."},{"calculator_id":"percentage-change","reason":"Plain percentage change between two numbers."}],"links":{"html":"https://tttkmbb.com/finance/roi","markdown":"https://tttkmbb.com/finance/roi.md","json":"https://tttkmbb.com/finance/roi.json","api":"https://tttkmbb.com/api/v1/calculate/roi","schema":"https://tttkmbb.com/api/v1/calculators/roi","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-23"},"timestamp":"2026-09-23T23:25:35Z","next_actions":[{"tool":"run_calculator","calculator_id":"roi","reason":"Run ROI Calculator with the inputs above."}],"links":{"markdown":"https://tttkmbb.com/finance/roi.md"}}