# Messari All-Time-High (ATH) Price Snapshots

> Messari All-Time-High (ATH) Price Snapshots is a paid API for AI agents from api.messari.io, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Returns all-time-high price snapshots and drawdown context for one or more cryptocurrency assets.

## Facts

- Endpoint: GET https://api.messari.io/metrics/v2/assets/ath
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/messari-49e82cd5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pWhx6j9z3Pt3BJUBESrfW

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 messari-49e82cd5
```

Example prompt: Pull the Messari all-time-high price snapshots and current drawdown context for bitcoin, ethereum, and solana — limit results to those 3 assets using their slugs.

## When to prefer this

Use this endpoint when you need historical peak price context for crypto assets, especially to show drawdown from ATH. Prefer this over the general asset snapshot endpoint when the specific goal is understanding how far an asset is from its historical high price. Best for portfolio analysis, market research, and investor dashboards focused on peak price benchmarking.

## Known failure modes

- Invalid asset ids or slugs return an empty result set or 404
- Malformed comma-separated ids/slugs may cause a 400 bad request
- Rate limiting or payment failure (x402) returns 402 Payment Required
- Requesting too many assets at once may hit the limit parameter ceiling
- Unknown sector or category filters may return empty results

## How this service works

Get all-time-high cryptocurrency price snapshots and drawdown context by asset.

## Output

Returns structured ATH price data per asset including the historical peak price, date of the all-time high, and drawdown metrics showing how far the current price is from that peak, for each queried asset.

## Example request

```json
{
 "limit": 3,
 "slugs": "bitcoin,ethereum,solana"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ids": {
   "type": "string",
   "description": "Comma-separated asset ids."
  },
  "tags": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "limit": {
   "type": "integer",
   "minimum": 1
  },
  "slugs": {
   "type": "string",
   "description": "Comma-separated asset slugs."
  },
  "search": {
   "type": "string"
  },
  "sector": {
   "type": "string"
  },
  "category": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "example": {
  "data": [
   {
    "id": "btc",
    "ath_at": "2021-11-10T00:00:00Z",
    "ath_price_usd": 0
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/messari-49e82cd5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.messari.io](https://www.zero.xyz/host/api.messari.io/llms.txt)
