# DripMetrics Amihud Illiquidity Metric

> DripMetrics Amihud Illiquidity 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-13).

Computes Amihud illiquidity ratio (returns per unit of dollar volume) for a crypto trading pair over a specified lookback window

## Facts

- Endpoint: GET https://api.dripmetrics.ai/metrics/amihud-illiquidity
- 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-6f92e564
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bmAPFMXjod43QRlJ6hDlT

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-6f92e564
```

Example prompt: What's the Amihud illiquidity ratio for BTCUSDT on Binance over the last 1 hour? I want to understand how illiquid the market is right now.

## When to prefer this

Use this endpoint when you need a standardized Amihud illiquidity estimate for a specific crypto pair on Binance or Coinbase, especially for risk assessment, execution cost modeling, or market microstructure research. Prefer this over raw trade data feeds when you need a pre-computed, normalized illiquidity metric without managing your own aggregation logic. Best suited for agents needing per-request pricing without API key subscriptions.

## Known failure modes

- Invalid or unsupported trading pair symbol returns an error
- Exchange not supported (only binance or coinbase accepted)
- Window value outside allowed enum ('30m','1h') returns validation error
- Insufficient trade data within the window may cause computation failure
- Payment failure via x402 protocol results in 402 response before computation

## 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. Amihud Illiquidity estimates returns per unit of dollar volume over the specified window. Discovery examples use the latest 30m window.

## Output

Returns a JSON object containing the Amihud illiquidity value (returns per unit of dollar volume), the trading pair, exchange, lookback window, computation timestamp, number of trades used, and the first/last trade times within the window. Optional breakdown of metric components may also be included.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "pair": "ETH-USD",
   "window": "30m",
   "exchange": "coinbase"
  }
 }
}
```

## 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": "BTC-USD",
  "value": 0.00000218,
  "metric": "amihud-illiquidity",
  "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/api-dripmetrics-ai-6f92e564/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)