# DripMetrics Hyperliquid Momentum

> DripMetrics Hyperliquid Momentum 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-15).

Returns the log-return momentum metric for a Hyperliquid perpetual market over a 30-minute or 1-hour window, derived from 1-minute public candle snapshots.

## Facts

- Endpoint: POST https://api.dripmetrics.ai/hyperliquid/momentum
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-dripmetrics-ai-3a5ec59b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8jovqoh_j2LKXIuRoBbCS

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 api-dripmetrics-ai-3a5ec59b -d '<json body>'
```

Example prompt: What's the current 1-hour momentum for BTC on Hyperliquid — give me the log-return from the candles so I can see if there's a sustained upward move?

## When to prefer this

Use this endpoint when you need a fast, structured momentum signal for a specific Hyperliquid perpetual market and want to pay per-call without managing API keys or subscriptions. Prefer this over raw candle data sources when you want a pre-computed log-return metric ready for agent decision-making.

## Known failure modes

- Invalid or unsupported market symbol returns an error response
- Unsupported time window parameter (not 30m or 1h) returns validation error
- Hyperliquid candle data unavailable or delayed causes stale or missing metric
- Payment failure via x402 (insufficient USDC balance) blocks the request
- Rate limiting or network timeout if Hyperliquid public API is slow

## 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

A structured JSON object containing the momentum value (log return from first candle open to last candle close), the market symbol, the time window used (30m or 1h), and a timestamp. The metric is derived from 1-minute candle snapshots on Hyperliquid.

## Example request

```json
{
 "pair": "BTC",
 "window": "1h"
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "pair": "BTC",
  "value": 0.01240445,
  "metric": "momentum",
  "source": {
   "candles": "https://api.hyperliquid.xyz/info"
  },
  "window": "30m",
  "interval": "1m",
  "components": {
   "lastPrice": 109854.25,
   "firstPrice": 108500,
   "simpleReturn": 0.01248167
  },
  "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/api-dripmetrics-ai-3a5ec59b/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)
