# DripMetrics AI – On-Chain TVL Momentum

> DripMetrics AI – On-Chain TVL Momentum 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-14).

Computes TVL (Total Value Locked) momentum metrics for a blockchain or DeFi protocol over a specified time window, sourced from DefiLlama on-chain data.

## Facts

- Endpoint: POST https://api.dripmetrics.ai/metrics/onchain/tvl-momentum
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dripmetrics-ai-on-chain-tvl-momentum-d55064e4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZFQVL1UO86MYCKw7osbDA

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-on-chain-tvl-momentum-d55064e4 -d '<json body>'
```

Example prompt: What's the 30-day TVL momentum for the Base chain right now — is liquidity growing or shrinking, and by how much?

## When to prefer this

Use this endpoint when you need quantitative, time-windowed TVL momentum metrics for a specific chain or DeFi protocol sourced from DefiLlama. Prefer this over raw DefiLlama queries when you want precomputed momentum signals, annualized growth rates, and native-currency breakdowns in a single structured response ready for agent consumption or dashboard display.

## Known failure modes

- Missing or invalid 'window' parameter — only '1d','7d','30d','90d' are accepted
- Unknown chain or protocol name returns no data or error
- DefiLlama data unavailable for the requested target results in empty response
- Native TVL data unavailable for some chains, returning nativeTvlAvailable=false
- Payment failure or insufficient USDC balance blocks request execution

## How this service works

DripMetricsAI (https://dripmetrics.ai/) provides on-demand crypto market microstructure metrics, Hyperliquid candle metrics, Polymarket diagnostics, and on-chain DefiLlama metrics for agents, dashboards, and trading workflows.

## Output

Returns a JSON object with the metric name ('tvl-momentum'), the target chain or protocol, the time window, the TVL percent change value, momentum direction (positive/negative), start and end TVL in USD and native currency, net TVL change, native token price at start and end of period, annualized TVL growth percentage, number of observations, and the data source (DefiLlama).

## 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": [
      "POST"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "window"
     ],
     "properties": {
      "chain": {
       "type": "string"
      },
      "window": {
       "enum": [
        "1d",
        "7d",
        "30d",
        "90d"
       ],
       "type": "string"
      },
      "protocol": {
       "type": "string"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "metric",
      "window",
      "value",
      "unit",
      "components",
      "computedAt"
     ],
     "properties": {
      "unit": {
       "type": "string"
      },
      "value": {
       "type": "number"
      },
      "metric": {
       "type": "string"
      },
      "target": {
       "type": "string"
      },
      "window": {
       "type": "string"
      },
      "components": {
       "type": "object"
      },
      "computedAt": {
       "type": "string",
       "format": "date-time"
      },
      "targetType": {
       "enum": [
        "chain",
        "protocol"
       ],
       "type": "string"
      }
     },
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "unit": "pct_change",
  "value": 0.083,
  "metric": "tvl-momentum",
  "target": "base",
  "window": "30d",
  "components": {
   "source": "DefiLlama",
   "momentum": "positive",
   "pctChange": 0.083,
   "startTvlUsd": 4801477378,
   "nativeCoinId": "coingecko:ethereum",
   "observations": 31,
   "currentTvlUsd": 5200000000,
   "nativeCurrency": "ETH",
   "startTvlNative": 1500461.680625,
   "netTvlChangeUsd": 398522622,
   "currentTvlNative": 1485714.285714,
   "nativePriceSource": "DefiLlama",
   "nativeTvlAvailable": true,
   "netTvlChangeNative": -14747.394911,
   "startNativePriceUsd": 3200,
   "nativeTvlMomentumPct": -0.009828,
   "startNativePriceTime": "2026-05-11T00:00:00.000Z",
   "currentNativePriceUsd": 3500,
   "annualizedTvlGrowthPct": 1.009833,
   "currentNativePriceTime": "2026-06-10T00:00:00.000Z",
   "annualizedNativeTvlGrowthPct": -0.119574
  },
  "computedAt": "2026-06-10T16:00:00.000Z",
  "targetType": "chain"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dripmetrics-ai-on-chain-tvl-momentum-d55064e4/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)