# CryptoRetail Historical Investment Calculator

> CryptoRetail Historical Investment Calculator is a paid API for AI agents from api.cryptoretail.store, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Calculates the current value, ROI, peak value, and weekly price series for a hypothetical past cryptocurrency investment

## Facts

- Endpoint: GET https://api.cryptoretail.store/v1/calculate
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cryptoretail-historical-investment-calculator-9aafa411
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j388uePJxQopTkqfR1fHx

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 cryptoretail-historical-investment-calculator-9aafa411
```

Example prompt: If I had invested $1,000 in BTC on 2021-01-15, what would it be worth today — and what was the peak value and ROI?

## When to prefer this

Use this endpoint when you need a quick, pay-per-use historical investment calculation for a specific cryptocurrency, including ROI, current value, peak value, and weekly price history. Prefer it over building custom historical data pipelines when you only need to check a single investment scenario on demand without a subscription.

## Known failure modes

- Invalid or future date provided — API likely returns an error indicating the date is out of range
- Unknown or unsupported ticker symbol — API returns an error indicating the symbol is not recognized
- Investment amount of zero or negative — may return a validation error
- Date before the cryptocurrency's existence — may return no data or an error
- Network or upstream data provider unavailability causing incomplete price series

## How this service works

Pay-per-use historical crypto investment calculator. Returns current value, ROI, peak value, and weekly price series.

## Output

Returns the current USD value of the investment, the return on investment (ROI) percentage, the peak value the investment ever reached, and a weekly price series showing how the value evolved over time from the purchase date to today.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "date",
  "amount",
  "symbol"
 ],
 "properties": {
  "date": {
   "type": "string",
   "description": "Purchase date in YYYY-MM-DD format"
  },
  "amount": {
   "type": "number",
   "description": "Investment amount in USD"
  },
  "symbol": {
   "type": "string",
   "description": "Cryptocurrency ticker symbol (e.g., BTC, ETH, SOL)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cryptoretail-historical-investment-calculator-9aafa411/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.cryptoretail.store](https://www.zero.xyz/host/api.cryptoretail.store/llms.txt)