# DripMetrics AI Order Book Concentration

> DripMetrics AI Order Book Concentration is a paid API for AI agents from api.dripmetrics.ai, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-16).

Computes a Herfindahl-index concentration metric for a crypto pair's order book, measuring how fragile or thin the top bid/ask levels are on Binance.

## Facts

- Endpoint: GET https://api.dripmetrics.ai/orderbook/concentration
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dripmetrics-ai-order-book-concentration-01653df2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mAHi2aTNtozUsTye_SSZT

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-order-book-concentration-01653df2
```

Example prompt: What's the order book concentration for BTCUSDT right now, looking at the top 20 levels per side? I want to know if the book is fragile or well-distributed.

## When to prefer this

Choose this endpoint when you need a single, interpretable scalar metric (Herfindahl index) for order book concentration on a specific Binance pair without maintaining a data subscription or API key. It's ideal for on-demand, per-request checks before trades, during volatility events, or for agent-driven monitoring workflows. Prefer it over raw order book feeds when you need a pre-computed fragility signal rather than raw depth data.

## Known failure modes

- Unsupported pair requested (only BTCUSDT, ETHUSDT, SOLUSDT supported) — likely returns 400 or validation error
- depthLevels out of range (must be 1–50) — schema validation failure
- Binance depth snapshot temporarily unavailable — upstream fetch error
- Payment not processed or insufficient USDC balance — x402 payment failure, request blocked
- Rate limiting or network timeout if Binance public API is slow

## How this service works

DripMetricsAI (https://dripmetrics.ai/) provides on-demand order-book microstructure metrics computed fresh per request from Binance's public depth snapshot. Agents can pay per request via x402 and receive structured JSON metrics without subscriptions or API keys. Concentration is a Herfindahl index of how concentrated volume is within the top depthLevels on each side; higher means a thinner, more fragile book.

## Output

A structured JSON object containing the metric name ('concentration'), the trading pair, a numeric Herfindahl index value (higher = more concentrated/fragile book), detailed components breaking down bid and ask side data, sample size info, the data source metadata, and an ISO 8601 timestamp of when the metric was computed.

## 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": [],
     "properties": {
      "pair": {
       "enum": [
        "BTCUSDT",
        "ETHUSDT",
        "SOLUSDT"
       ],
       "type": "string",
       "default": "BTCUSDT",
       "description": "Binance-native pair. BTCUSDT, ETHUSDT, and SOLUSDT are supported."
      },
      "depthLevels": {
       "type": "integer",
       "default": 10,
       "maximum": 50,
       "minimum": 1,
       "description": "Number of book levels per side to include."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "metric",
      "pair",
      "value",
      "components",
      "sampleSize",
      "source",
      "computedAt"
     ],
     "properties": {
      "pair": {
       "enum": [
        "BTCUSDT",
        "ETHUSDT",
        "SOLUSDT"
       ],
       "type": "string"
      },
      "value": {
       "type": [
        "number",
        "null"
       ]
      },
      "metric": {
       "type": "string"
      },
      "source": {
       "type": "object"
      },
      "components": {
       "type": "object"
      },
      "computedAt": {
       "type": "string",
       "format": "date-time"
      },
      "sampleSize": {
       "type": "object"
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dripmetrics-ai-order-book-concentration-01653df2/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)