# DripMetrics AI VWAP Deviation

> DripMetrics AI VWAP Deviation 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 volume-weighted average price (VWAP) deviation for a crypto trading pair over a specified lookback window from Binance or Coinbase trade data.

## Facts

- Endpoint: GET https://api.dripmetrics.ai/metrics/vwap-deviation
- 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-vwap-deviation-e1a0a70e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_glhZZzleTBxN3E3mjl5qJ

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-vwap-deviation-e1a0a70e
```

Example prompt: What's the VWAP deviation for BTC-USD on Coinbase over the last hour? I want to know how far current price is from the volume-weighted average.

## When to prefer this

Use this endpoint when you need a real-time, on-demand VWAP deviation metric sourced from actual recent trades on Binance or Coinbase — particularly for mean-reversion signals, momentum analysis, or market microstructure diagnostics. Prefer over general price APIs when you need volume-weighted context rather than simple last-price data, and when you need per-trade-level computation with explicit coverage/data-quality metadata.

## Known failure modes

- Unsupported pair/exchange combination returns an error or partial data with coverageRatio < 1
- 2h and 3h windows only available for BTCUSDT/BTC-USD — other pairs return error or reduced window
- Insufficient trade data in window results in partialData=true and lower coverageRatio
- Exchange API downtime causes completeFetch=false with errorMessage populated
- Invalid enum values for exchange or window return a 400-level validation error
- Payment not completed (x402 protocol) results in 402 response before metric is returned

## How this service works

DripMetricsAI (api description at https://dripmetrics.ai/) provides on-demand 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. VWAP Deviation measures the latest price deviation from the window VWAP. Discovery examples use the latest 30m window.

## Output

Returns a JSON object with the metric name ('vwap-deviation'), the trading pair, exchange, lookback window, the computed deviation value (a number, e.g. 0.001292), computation timestamp, trade count used, first and last trade timestamps, and a coverage object indicating whether the full requested window was available (coverageRatio, partialData flag, completeFetch flag, effectiveWindowMinutes).

## 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",
        "hyperliquid"
       ],
       "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,
         "minimu
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "pair": "BTC-USD",
  "value": 0.001292,
  "metric": "vwap-deviation",
  "window": "30m",
  "coverage": {
   "partialData": false,
   "errorMessage": null,
   "completeFetch": true,
   "coverageRatio": 1,
   "effectiveWindowMinutes": 30,
   "requestedWindowMinutes": 30
  },
  "exchange": "coinbase",
  "components": {},
  "computedAt": "2026-05-23T14:00:00.000Z",
  "tradeCount": 428,
  "lastTradeTime": "2026-05-23T13:59:58.000Z",
  "firstTradeTime": "2026-05-23T13:00:02.000Z"
 }
}
```

## More

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