{"uid":"cap_W7QRQ8rPj2Xma80xix_7f","slug":"finance-calculators-roi-cagr-55389cc3","name":"Finance Calculators – ROI & CAGR","description":"Return on investment and compound annual growth rate (CAGR) from a start value, end value and years held.","url":"https://finance-calculators.x402tookit.com/roi-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":["start","end","years"],"properties":{"end":{"type":"number","description":"Ending value"},"start":{"type":"number","description":"Starting value"},"years":{"type":"number","description":"Years between them"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"gain":{"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"]},"multiple":{"type":["null","number"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"totalReturnPct":{"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_kweKB-20_ig3NVK-ZBnCV","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 return on investment (ROI) and compound annual growth rate (CAGR) given a starting value, ending value, and number of years held.","exampleAgentPrompt":"What was the ROI and CAGR on an investment that started at $15,000, grew to $42,000, and was held for 6 years?","exampleUseCases":[{"title":"Portfolio performance review","prompt":"I bought $20,000 worth of index funds 8 years ago and they're now worth $51,000 — what's my total return and compound annual growth rate?"},{"title":"Real estate investment analysis","prompt":"I purchased a rental property for $250,000 five years ago and just sold it for $380,000. Can you calculate my ROI and annualized CAGR on that?"},{"title":"Comparing two investment outcomes","prompt":"My first investment went from $5,000 to $9,500 over 4 years. What's the CAGR and total return so I can compare it to another option?"}],"resultDescription":"Returns a JSON object containing total return percentage, CAGR as a percentage, absolute gain, investment multiple, a plain-language summary, a verdict, and a disclaimer. May also include a source label, asOf date, and degraded/notChecked flags if data quality is partial.","failureModes":["Missing required query parameters (start, end, or years) returns an error","Non-numeric values for start, end, or years cause a validation failure","Years value of zero causes a division-by-zero or undefined CAGR result","Negative start value may produce mathematically undefined CAGR","Payment failure (x402) results in 402 response before computation occurs"],"whenToPreferThis":"Use this endpoint when you need a fast, structured computation of both ROI and CAGR from just three numeric inputs — start value, end value, and time period. It is ideal for investment performance reviews, portfolio benchmarking, or any scenario where annualized growth rate and total return are needed simultaneously without building the math manually.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:13:42.162Z","isFirstParty":false,"canonicalSlug":"finance-calculators-roi-cagr-55389cc3"}