Portfolio Stats CAGR Calculator

Choose this endpoint when you need pure arithmetic CAGR computation from user-supplied values without any external data fetching. It is ideal for agents that already have the start/end portfolio values and a time duration and need a precise annualized growth figure. Prefer this over general-purpose LLM math when you want structured output including growth multiple, doubling time, and a plain-language summary with disclaimer. Use date inputs when the user provides calendar dates rather than an elapsed years figure.

• startValue of zero or negative causes computation error (denominator or invalid base)
• endValue of zero returns a CAGR of -100% or null
• mismatched date inputs (endDate without startDate or vice versa) cause validation failure
• providing more than one duration input (years + dates + periods simultaneously) may cause ambiguity or error
• negative elapsed years if endDate is before startDate
• missing required fields startValue or endValue returns validation error