# MadeOnSol Peak History API

> MadeOnSol Peak History API is a paid API for AI agents from api.relai.fi, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns historical all-time-high market cap snapshots for a Solana token, including ATH values, peak timestamps, drawdown percentages, and recovery windows.

## Facts

- Endpoint: GET https://api.relai.fi/relay/1780517153303/tokens/{mint}/peak-history
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/madeonsol-peak-history-api-f9c0f3f8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TTH-aSvCfRKvQgljYvNyj

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 madeonsol-peak-history-api-f9c0f3f8
```

Example prompt: Pull the full peak market cap history for the Solana token with mint address So11111111111111111111111111111111111111112 — I want to see the ATH, when each peak happened, how far it's dropped from the highs, and whether it's ever recovered.

## When to prefer this

Use this endpoint when you need historical peak market cap analysis for a Solana token — specifically to evaluate whether a token has already peaked, how deep its drawdowns have been, and whether it is re-approaching prior highs. Prefer this over general price endpoints when the focus is on ATH context, drawdown severity, and recovery patterns rather than current price alone.

## Known failure modes

- Invalid or non-existent mint address returns an error or empty result
- Token has no trading history resulting in empty peak data
- Network timeout or relay unavailability returns a 5xx error
- Malformed mint address format causes a 400 bad request
- Token is too new to have meaningful ATH history, returning minimal data

## How this service works

Historical peak MC snapshots for a token — ATH market cap, timestamps of each peak, drawdown from ATH, and recovery windows. Useful for gauging whether a token has already peaked or is re-approaching highs.

## Output

A list of historical peak market cap snapshots for the token, each including the ATH market cap value, timestamps when each peak occurred, percentage drawdown from the ATH, and recovery window data indicating how long the token took to recover (if at all) between peaks.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/madeonsol-peak-history-api-f9c0f3f8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.relai.fi](https://www.zero.xyz/host/api.relai.fi/llms.txt)
