# DripMetrics Historical Volatility

> DripMetrics Historical Volatility 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-13).

Computes annualized historical volatility for a crypto trading pair over a 30m or 1h lookback window using recent trade data from Binance or Coinbase.

## Facts

- Endpoint: GET https://api.dripmetrics.ai/metrics/historical-volatility
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-dripmetrics-ai-ee1c71f3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Olp41vBdHcOBFapkYHDSn

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-ee1c71f3
```

Example prompt: What's the current annualized historical volatility for BTCUSDT on Binance over the last 1 hour?

## When to prefer this

Use this endpoint when you need a real-time, on-demand annualized historical volatility metric for a specific crypto pair on Binance or Coinbase, especially in agentic workflows requiring no subscription or API key — just per-request USDC payment via x402. Prefer this over general market data APIs when you specifically need a structured risk/volatility metric rather than raw price data.

## Known failure modes

- Invalid or unsupported trading pair symbol returns an error
- Unsupported exchange name (not binance or coinbase) returns a validation error
- Unsupported window value (not 30m or 1h) returns a validation error
- Insufficient trade data in the lookback window may return an error or low tradeCount
- Payment not provided or insufficient USDC results in 402 Payment Required
- Exchange API unavailable or rate-limited causes upstream data failure

## How this service works

DripMetricsAI (api description at https://dripmetrics.ai/) provides on-demand crypto market microstructure and risk metrics for agents and developers. Agents can pay per request via x402 and receive structured JSON metrics without subscriptions or API keys. Historical volatility for a crypto asset over a specified lookback window. Discovery examples use the latest 30m window.

## Output

Returns a JSON object containing the annualized historical volatility value, the trading pair, exchange, lookback window, computation timestamp, trade count used in the calculation, and component breakdown including interval volatility, number of intervals, and intervals per year.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "pair": "BTCUSDT",
   "window": "1h",
   "exchange": "binance"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "pair",
      "exchange",
      "window"
     ],
     "properties": {
      "pair": {
       "type": "string",
       "description": "Exchange-native trading pair symbol such as BTCUSDT, ETH-USD, BTC, or xyz:TSLA."
      },
      "window": {
       "enum": [
        "30m",
        "1h",
        "2h",
        "3h"
       ],
       "type": "string",
       "description": "Lookback window. Hyperliquid supports 30m and 1h; 2h and 3h are currently BTCUSDT/BTC-USD only."
      },
      "exchange": {
       "enum": [
        "binance",
        "coinbase"
       ],
       "type": "string",
       "description": "Exchange adapter to source recent trades from."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "metric",
      "pair",
      "exchange",
      "window",
      "value",
      "computedAt",
      "tradeCount",
      "firstTradeTime",
      "lastTradeTime",
      "coverage"
     ],
     "properties": {
      "pair": {
       "type": "string"
      },
      "value": {
       "type": "number"
      },
      "metric": {
       "type": "string"
      },
      "window": {
       "enum": [
        "30m",
        "1h",
        "2h",
        "3h"
       ],
       "type": "string"
      },
      "coverage": {
       "type": "object",
       "required": [
        "requestedWindowMinutes",
        "effectiveWindowMinutes",
        "coverageRatio",
        "partialData",
        "completeFetch",
        "errorMessage"
       ],
       "properties": {
        "partialData": {
         "type": "boolean"
        },
        "errorMessage": {
         "type": [
          "string",
          "null"
         ]
        },
        "completeFetch": {
         "type": "boolean"
        },
        "coverageRatio": {
         "type": "number",
         "maximum": 1,
         "minimum": 0
        },
      
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "pair": "ETH-USD",
  "value": 0.742113,
  "metric": "historical-volatility",
  "window": "30m",
  "coverage": {
   "partialData": false,
   "errorMessage": null,
   "completeFetch": true,
   "coverageRatio": 1,
   "effectiveWindowMinutes": 30,
   "requestedWindowMinutes": 30
  },
  "exchange": "coinbase",
  "components": {
   "intervals": 60,
   "intervalsPerYear": 525600,
   "intervalVolatility": 0.00102488
  },
  "computedAt": "2026-05-23T14:00:00.000Z",
  "tradeCount": 312,
  "lastTradeTime": "2026-05-23T13:59:57.000Z",
  "firstTradeTime": "2026-05-23T13:00:11.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-dripmetrics-ai-ee1c71f3/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)