# DripMetrics AI – Hyperliquid Drawdown Metric

> DripMetrics AI – Hyperliquid Drawdown Metric is a paid API for AI agents from api.dripmetrics.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Computes the maximum drawdown (peak-to-trough price decline) for a given crypto pair over a specified rolling window using Hyperliquid candle data.

## Facts

- Endpoint: POST https://api.dripmetrics.ai/hyperliquid/drawdown
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dripmetrics-ai-hyperliquid-drawdown-metric-945f7f96
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0pNMmFfHuRXOfpHWtCkx3

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 dripmetrics-ai-hyperliquid-drawdown-metric-945f7f96 -d '<json body>'
```

Example prompt: What's the current drawdown for BTC on Hyperliquid over the last 30 minutes using 1-minute candles? I want to see the peak price, trough price, and the overall drawdown percentage.

## When to prefer this

Use this endpoint when you specifically need rolling maximum drawdown computed from Hyperliquid perpetual futures candle data, with peak and trough price components broken out. Prefer it over generic OHLCV endpoints when you need a pre-computed risk metric rather than raw candles, and over broader analytics platforms when you want a lightweight, per-call paid computation at $0.05 USDC with no subscription required.

## Known failure modes

- Invalid or unsupported trading pair symbol returns an error
- Requested window or interval not available on Hyperliquid returns a 400-level error
- Hyperliquid data source unavailable causes a timeout or 503
- Insufficient candle history for the requested window returns a partial or error response
- Missing required payment header (x402) results in a 402 Payment Required response

## How this service works

DripMetricsAI (https://dripmetrics.ai/) provides on-demand crypto market microstructure metrics, Hyperliquid candle metrics, Polymarket diagnostics, and on-chain DefiLlama metrics for agents, dashboards, and trading workflows.

## Output

Returns a JSON object containing the drawdown ratio (e.g. 0.024 = 2.4%), the peak and trough prices used in the calculation, the candle window and interval, the number of candles sampled, the first and last candle timestamps, the data source URL, and a computedAt timestamp.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "pair": "BTC",
  "value": 0.02401816,
  "metric": "drawdown",
  "source": {
   "candles": "https://api.hyperliquid.xyz/info"
  },
  "window": "30m",
  "interval": "1m",
  "components": {
   "peakPrice": 110215.4,
   "troughPrice": 107568.2
  },
  "computedAt": "2026-05-29T16:00:00.000Z",
  "sampleSize": {
   "candles": 30
  },
  "lastCandleTime": "2026-05-29T15:59:59.999Z",
  "firstCandleTime": "2026-05-29T15:30:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dripmetrics-ai-hyperliquid-drawdown-metric-945f7f96/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.dripmetrics.ai](https://www.zero.xyz/host/api.dripmetrics.ai/llms.txt)