# DripMetrics BTC Market Microstructure Summary

> DripMetrics BTC Market Microstructure Summary is a paid API for AI agents from api.dripmetrics.ai, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-16).

Returns deterministic BTC market microstructure signals (order flow, VPIN toxicity, Kyle-lambda liquidity, realized vol, dealer gamma, variance risk premium) plus an AI-written narrative explanation for a given lookback window.

## Facts

- Endpoint: GET https://api.dripmetrics.ai/market/summary
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dripmetrics-btc-market-microstructure-summary-f46eadbe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mvBqmVm2gokdTfCB4AV4H

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-btc-market-microstructure-summary-f46eadbe
```

Example prompt: Pull the BTC microstructure summary from DripMetrics for the last 1-hour window — I want to see order flow, flow toxicity, dealer gamma, and the AI explanation of current market conditions.

## When to prefer this

Use this endpoint when you need a fast, self-contained BTC market microstructure read combining both trade tape signals and options chain data in a single call with an AI narrative. Prefer over raw exchange data feeds when you need pre-computed, labeled signals (VPIN, Kyle-lambda, dealer gamma) without building your own analytics pipeline. Best for agents that need a structured, actionable microstructure snapshot with plain-English explanation rather than raw tick data.

## Known failure modes

- Insufficient trade tape data for the requested window returns null signals or reduced confidence
- Invalid pair value (non-BTC) returns a validation error
- Invalid window value returns a 400-class error
- Payment failure (x402) returns 402 Payment Required with no data
- API unavailability returns 5xx error
- Deribit chain data lag may result in stale options-derived metrics

## How this service works

DripMetricsAI (https://dripmetrics.ai/) BTC market summary: one x402 call returns deterministic microstructure signals and metrics (including raw, baseline, and excess VPIN) computed from the live trade tape and Deribit chain, plus a concise AI-written explanation. Hedged historical tendencies only - no price targets or trade recommendations.

## Output

A structured JSON object containing: labeled signals (orderFlow, flowToxicity, liquidity, volatility, priceTrend, activity, dealerGamma, volRiskPremium each as human-readable enums), raw numeric metrics, the last BTC price, a confidence score, an AI-written narrative summary of microstructure conditions, the model used for the summary, a disclaimer, sample size, coverage metadata, and the data source object. All signals are computed from the live trade tape and Deribit options chain.

## 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": [
        "BTC",
        "BTCUSDT",
        "BTC-USD"
       ],
       "type": "string",
       "description": "BTC-only in this phase. Optional; defaults to BTC."
      },
      "window": {
       "enum": [
        "30m",
        "1h",
        "2h",
        "3h"
       ],
       "type": "string",
       "description": "Lookback window for the trade-tape signals. Defaults to 30m."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "pair",
      "window",
      "asOf",
      "lastPrice",
      "confidence",
      "signals",
      "metrics",
      "summary",
      "summaryModel",
      "disclaimer",
      "sampleSize",
      "coverage",
      "source"
     ],
     "properties": {
      "asOf": {
       "type": "string",
       "format": "date-time"
      },
      "pair": {
       "type": "string",
       "const": "BTC"
      },
      "source": {
       "type": "object"
      },
      "window": {
       "enum": [
        "30m",
        "1h",
        "2h",
        "3h"
       ],
       "type": "string"
      },
      "metrics": {
       "type": "object",
       "additionalProperties": {
        "type": [
         "number",
         "null"
        ]
       }
      },
      "signals": {
       "type": "object",
       "required": [
        "orderFlow",
        "flowToxicity",
        "liquidity",
        "volatility",
        "priceTrend",
        "activity",
        "largeTraderShare",
        "dealerGamma",
        "volRiskPremium"
       ],
       "properties": {
        "activity": {
         "anyOf": [
          {
           "enum": [
            "quiet",
            "normal",
            "busy"
           ],
           "type": "string"
          },
          {
           "type": "null"
          }
         ]
        },
        "liquid
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asOf": "2026-07-15T14:00:00.000Z",
  "pair": "BTC",
  "source": {
   "chain": "https://www.deribit.com/api/v2/public/get_book_summary_by_currency?currency=BTC&kind=option",
   "index": "https://www.deribit.com/api/v2/public/get_index_price?index_name=btc_usd",
   "trades": "DripMetrics BTC trade cache",
   "summary": "Claude (Anthropic), constrained to the deterministic signals in this payload"
  },
  "window": "30m",
  "metrics": {
   "vpin": 0.38,
   "cvdBase": -212.4,
   "kyleLambda": 2.47191e-7,
   "vrpVolPoints": 0.062,
   "gammaFlipLevel": 104800.5,
   "largeTradeShare": 0.22,
   "tradesPerMinute": 812.4,
   "buySellImbalance": -0.14,
   "gexNetUsdPer1Pct": 182000000,
   "momentumLogReturn": -0.0021,
   "realizedVolAnnualized": 0.52,
   "kyleLambdaDollarsPer1Bp": 418387.7
  },
  "signals": {
   "activity": "busy",
   "liquidity": "normal",
   "orderFlow": "sell-leaning",
   "priceTrend": "drifting-lower",
   "volatility": "normal",
   "dealerGamma": "dampening",
   "flowToxicity": "elevated",
   "volRiskPremium": "options-rich",
   "largeTraderShare": "typical"
  },
  "summary": "BTC order flow over the last 30 minutes is modestly sell-side, with cumulative volume delta around -212 BTC and elevated VPIN pointing to a meaningful informed component in the selling — a configuration historically associated with continued short-term pressure. Liquidity remains normal at roughly $418k of flow per basis point, so the selling is being absorbed without outsized impact. The notable tension is between the tape and the options market: positive dealer gamma tends to dampen moves, and implied volatility trades rich to realized, so options are pricing more movement than the tape is delivering. A microstructure-aware trader would watch whether elevated VPIN persists as price approaches the gamma flip level near 104,800.",
  "coverage": {
   "partialData": false,
   "errorMessage": null,
   "completeFetch": true,
   "coverageRatio": 1,
   "effectiveWindowMinutes": 30,
   "requestedWindowMinutes": 30
  },
  "lastPrice": 108050.2,
  "confidence": 0.94,
  "disclaimer": "Informational description of observed market conditions and their historical tendencies; not investment advice or a trade recommendation.",
  "sampleSize": {
   "trades": 24310,
   "optionsInstruments": 612
  },
  "summaryModel": "claude-opus-4-8"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dripmetrics-btc-market-microstructure-summary-f46eadbe/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)
