# finmath CAGR Calculator

> finmath CAGR Calculator is a paid API for AI agents from finmath.qzqh5rrbkz.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Computes Compound Annual Growth Rate (CAGR) from a beginning value, ending value, and number of years using deterministic arithmetic

## Facts

- Endpoint: POST https://finmath.qzqh5rrbkz.workers.dev/v1/cagr
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/finmath-cagr-calculator-a6acd424
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vn4MXQ4M8Q7qCXrswbscw

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability finmath-cagr-calculator-a6acd424 -d '<json body>'
```

Example prompt: What's the CAGR on an investment that started at $8,500 and grew to $23,000 over 7 years?

## When to prefer this

Use this endpoint when you need an exact, deterministic CAGR calculation rather than relying on an LLM's arithmetic, which can be imprecise. Ideal for financial reporting, portfolio analysis, or any agent workflow requiring provably correct annualized return figures. Prefer over generic math tools when the domain is explicitly investment or financial growth rate calculation.

## Known failure modes

- Missing required fields (begin_value or end_value) returns a validation error
- begin_value of zero causes division-by-zero or undefined result
- Negative begin_value or end_value may return NaN or error depending on implementation
- years = 0 causes division-by-zero
- Payment failure (402) if USDC balance is insufficient

## How this service works

Deterministic finance and crypto math for AI agents: TradFi (NPV, IRR, XIRR, Black-Scholes + Greeks, bonds, VaR, Sharpe) and DeFi (impermanent loss, perp liquidation, funding, Uniswap v3, health factor, cost basis). Exact, model-free arithmetic that LLMs get wrong — priced per call in USDC.

## Output

Returns a result object containing the computed CAGR as a decimal or percentage, plus metadata about the calculation. The value represents the annualized growth rate that would take begin_value to end_value over the specified number of years.

## Example request

```json
{
 "years": 7,
 "end_value": 23000,
 "begin_value": 8500
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "end_value",
  "begin_value"
 ],
 "properties": {
  "years": {
   "type": "number",
   "description": "years"
  },
  "end_value": {
   "type": "number",
   "description": "end_value"
  },
  "begin_value": {
   "type": "number",
   "description": "begin_value"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "result",
  "meta"
 ],
 "properties": {
  "meta": {
   "type": "object"
  },
  "result": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/finmath-cagr-calculator-a6acd424/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from finmath.qzqh5rrbkz.workers.dev](https://www.zero.xyz/host/finmath.qzqh5rrbkz.workers.dev/llms.txt)