# DripMetrics Large Trade Share

> DripMetrics Large Trade Share 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).

Returns the share of traded volume attributable to large trades for a given crypto pair, exchange, and lookback window

## Facts

- Endpoint: GET https://api.dripmetrics.ai/metrics/large-trade-share
- 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/dripmetrics-large-trade-share-8647dd48
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1_f3GpQSzPnrlwAij3_Ax

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-large-trade-share-8647dd48
```

Example prompt: What's the large trade share for BTCUSDT on Binance over the last 30 minutes — i.e. what fraction of total volume came from large trades?

## When to prefer this

Use this endpoint when you need to quantify the share of volume driven by large trades (whale or institutional activity) for a specific crypto pair on Binance or Coinbase, without needing a subscription or API key — pay-per-call via x402 USDC. Prefer this over generic exchange APIs when you need a pre-computed, structured microstructure metric rather than raw trade data you'd have to aggregate yourself.

## Known failure modes

- Unsupported pair symbol for the chosen exchange returns a 4xx error
- Invalid or unsupported window value (outside 30m/1h enum) causes a validation error
- Payment not provided or insufficient USDC triggers a 402 Payment Required response
- Exchange adapter temporarily unavailable results in partial data or error
- Too few trades in the window may produce low coverage ratio with partialData=true

## 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. Large Trade Share measures the share of traded volume attributable to large trades. Discovery examples use the latest 30m window.

## Output

A structured JSON object containing the large trade share metric value (0–1 or percentage), the trading pair, exchange, window, number of trades analyzed, first and last trade timestamps, computation timestamp, and a coverage object detailing how completely the requested window was filled (coverageRatio, effectiveWindowMinutes, partialData flag, completeFetch flag).

## 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.271844,
  "metric": "large-trade-share",
  "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-large-trade-share-8647dd48/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)