# DripMetrics Order Flow HHI

> DripMetrics Order Flow HHI 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).

Computes the Herfindahl-Hirschman Index (HHI) of signed order flow concentration for a crypto trading pair over a specified lookback window

## Facts

- Endpoint: GET https://api.dripmetrics.ai/metrics/order-flow-hhi
- 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-efaba295
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LhO8gsK8YW_MAhundJr3O

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

Example prompt: What's the order flow HHI concentration for BTCUSDT on Binance over the last 1 hour — is the signed order flow highly concentrated or spread out across intervals?

## When to prefer this

Use this endpoint when you need to quantify how concentrated or dispersed signed order flow is across time intervals for a crypto pair — useful for detecting periods of dominant directional pressure, assessing market microstructure health, or building risk models. Prefer this over raw trade data endpoints when you need a pre-computed concentration index rather than raw order book or tick data.

## Known failure modes

- Invalid pair symbol returns error (e.g. unsupported ticker not native to exchange)
- Unsupported exchange value outside enum binance/coinbase returns 400
- Unsupported window value outside enum 30m/1h returns 400
- Insufficient trade data in window may return error or low tradeCount
- Payment failure via x402 results in 402 response if USDC payment not processed
- Network timeout if exchange data source is temporarily unavailable

## 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. Order Flow HHI measures concentration of signed order flow across the specified window. Discovery examples use the latest 30m window.

## Output

Returns a JSON object with the HHI value (0–1 scale), the trading pair, exchange, window, trade count, computation timestamp, and component breakdown including maxShare, number of intervals, nonZeroIntervals, effectiveIntervals, and totalAbsoluteSignedFlow.

## 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",
        "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.274118,
  "metric": "order-flow-hhi",
  "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-efaba295/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)