{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"cagr"},"result":{"entity_type":"calculator","id":"cagr","calculator_id":"cagr","canonical_url":"https://tttkmbb.com/finance/cagr","name":"CAGR Calculator","title":"CAGR Calculator – Compound Annual Growth Rate from Beginning and Ending Values","category":"finance","category_name":"Finance","tool_name":"calculate_cagr","featured_mcp_tool":false,"description":"Computes the compound annual growth rate that turns a beginning value into an ending value over a number of years, together with the total return and growth multiple.","use_when":"You need a smoothed per-year growth rate for revenue, a portfolio, a population or any quantity measured at two points in time.","do_not_use_when":"You need to account for interim deposits or withdrawals (CAGR ignores cash flows; use a money-weighted return), or the period is under a year.","inputs":[{"name":"beginning_value","label":"Beginning value","type":"number","required":true,"max":1000000000000000,"exclusive_min":0,"description":"Value at the start of the period.","example":10000},{"name":"ending_value","label":"Ending value","type":"number","required":true,"max":1000000000000000,"exclusive_min":0,"description":"Value at the end of the period.","example":19000},{"name":"years","label":"Number of years","type":"number","unit":"years","required":true,"max":200,"exclusive_min":0,"description":"Length of the period in years; fractional values allowed (18 months = 1.5).","example":3}],"outputs":[{"name":"cagr_percent","label":"CAGR","type":"number","unit":"%","decimals":2,"description":"((ending / beginning)^(1/years) − 1) × 100."},{"name":"total_return_percent","label":"Total return","type":"number","unit":"%","decimals":2,"description":"(ending / beginning − 1) × 100 over the whole period."},{"name":"growth_multiple","label":"Growth multiple","type":"number","decimals":4,"description":"ending_value / beginning_value."},{"name":"simple_average_annual_return_percent","label":"Simple average per year","type":"number","unit":"%","decimals":2,"description":"total_return_percent / years, the arithmetic (non-compounded) average for comparison."}],"input_schema":{"type":"object","properties":{"beginning_value":{"description":"Value at the start of the period.","type":"number","maximum":1000000000000000,"exclusiveMinimum":0,"examples":[10000]},"ending_value":{"description":"Value at the end of the period.","type":"number","maximum":1000000000000000,"exclusiveMinimum":0,"examples":[19000]},"years":{"description":"Length of the period in years; fractional values allowed (18 months = 1.5). Unit: years.","type":"number","maximum":200,"exclusiveMinimum":0,"examples":[3],"x-unit":"years"}},"additionalProperties":false,"required":["beginning_value","ending_value","years"]},"output_schema":{"type":"object","properties":{"cagr_percent":{"description":"((ending / beginning)^(1/years) − 1) × 100. Unit: %.","type":"number","x-unit":"%"},"total_return_percent":{"description":"(ending / beginning − 1) × 100 over the whole period. Unit: %.","type":"number","x-unit":"%"},"growth_multiple":{"description":"ending_value / beginning_value.","type":"number"},"simple_average_annual_return_percent":{"description":"total_return_percent / years, the arithmetic (non-compounded) average for comparison. Unit: %.","type":"number","x-unit":"%"}}},"formula":"CAGR = ((ending_value / beginning_value)^(1 / years) − 1) × 100","method":"CAGR is the constant annual rate that would produce the same end value with annual compounding; it smooths out volatility and says nothing about the path in between.","sources":[{"name":"Investopedia – Compound Annual Growth Rate (CAGR) Formula and Calculation","url":"https://www.investopedia.com/terms/c/cagr.asp","type":"reference","retrieved_at":"2026-09-23"},{"name":"Wikipedia – Compound annual growth rate","url":"https://en.wikipedia.org/wiki/Compound_annual_growth_rate","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 to 19,000 over 3 years","inputs":{"beginning_value":10000,"ending_value":19000,"years":3},"expected":{"cagr_percent":23.86,"total_return_percent":90,"growth_multiple":1.9,"simple_average_annual_return_percent":30},"url":"https://tttkmbb.com/api/v1/calculate/cagr?beginning_value=10000&ending_value=19000&years=3"},{"name":"100 to 50 over 2 years","inputs":{"beginning_value":100,"ending_value":50,"years":2},"expected":{"cagr_percent":-29.29,"total_return_percent":-50,"growth_multiple":0.5},"url":"https://tttkmbb.com/api/v1/calculate/cagr?beginning_value=100&ending_value=50&years=2"}],"faq":[{"q":"How is CAGR different from average annual return?","a":"The arithmetic average ignores compounding. Growing 10,000 to 19,000 in 3 years is 30 % per year on average but only 23.86 % CAGR, because each year's growth builds on the previous one."},{"q":"How do I count the years?","a":"Use the elapsed time between the two measurements, not the number of data points: values at the ends of 2020 and 2023 span 3 years."}],"tags":["cagr","compound annual growth rate","growth rate","annualized growth","investment return"],"related":[{"calculator_id":"roi","reason":"Total and annualized return on an investment."},{"calculator_id":"rule-of-72","reason":"How long this growth rate takes to double the value."}],"links":{"html":"https://tttkmbb.com/finance/cagr","markdown":"https://tttkmbb.com/finance/cagr.md","json":"https://tttkmbb.com/finance/cagr.json","api":"https://tttkmbb.com/api/v1/calculate/cagr","schema":"https://tttkmbb.com/api/v1/calculators/cagr","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-23"},"timestamp":"2026-09-23T23:27:56Z"}