{"uid":"cap_Lq2NyPCiJkeO4D_Orm-7F","slug":"portfolio-stats-cagr-calculator-b30b2e24","name":"Portfolio Stats CAGR Calculator","description":"Compound annual growth rate from start and end values over years, or dates, or periods. Arithmetic on your numbers, not advice.","url":"https://portfolio-stats.x402tookit.com/cagr?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["startValue","endValue"],"properties":{"years":{"type":"number","description":"Elapsed years (give exactly one of years, startDate with endDate, or periods)"},"endDate":{"type":"string","description":"ISO end date like 2025-01-01"},"periods":{"type":"number","description":"Number of periods elapsed (use with periodsPerYear)"},"endValue":{"type":"number","description":"Ending value, zero or more"},"startDate":{"type":"string","description":"ISO start date like 2020-01-01 (use with endDate)"},"startValue":{"type":"number","description":"Starting value, above zero"},"periodsPerYear":{"type":"integer","description":"Periods per year when periods is given (252, 52 or 12)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"cagr":{"type":["null","number"]},"years":{"type":["null","number"]},"source":{"type":["null","string"]},"cagrPct":{"type":["null","number"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"growthMultiple":{"type":["null","number"]},"totalReturnPct":{"type":["null","number"]},"educationalOnly":{"type":["null","string"]},"doublingTimeYears":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_maqG6XcZ7FdtmluPqNkV5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates compound annual growth rate (CAGR) from start and end values over a specified duration (years, dates, or periods)","exampleAgentPrompt":"What's the CAGR on an investment that grew from $12,000 to $34,500 between 2018-03-01 and 2024-03-01?","exampleUseCases":[{"title":"Annualized return on stock portfolio","prompt":"My portfolio started at $50,000 in January 2019 and is now worth $98,000 as of January 2025 — what's the compound annual growth rate over those 6 years?"},{"title":"Quarterly fund performance benchmarking","prompt":"I have a fund that went from $1,000,000 to $1,420,000 over 20 quarters — can you calculate the CAGR using 4 periods per year?"},{"title":"Quick years-based investment growth check","prompt":"What's the annualized growth rate on something that went from $5,000 to $11,200 over 7.5 years?"}],"resultDescription":"Returns a CAGR as a decimal and percentage, along with the elapsed years, growth multiple, total return percentage, estimated doubling time in years, a plain-language summary, and a verdict string. Also includes a disclaimer noting results are educational arithmetic only and not financial advice.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T00:35:47.066Z","isFirstParty":false,"canonicalSlug":"portfolio-stats-cagr-calculator-b30b2e24"}