# DeFi TVL Momentum

> DeFi TVL Momentum is a paid API for AI agents from finanz.halowerk.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns total value locked for a DeFi protocol with chain-level breakdown, 1/7/30-day changes, and category share — distinguishing price-driven TVL changes from actual user flows

## Facts

- Endpoint: POST https://finanz.halowerk.com/v1/defi-tvl-momentum
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-tvl-momentum-a85d8005
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kVG_Ws_UAg2QDqYuoCn7E

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 defi-tvl-momentum-a85d8005 -d '<json body>'
```

Example prompt: What's the current TVL for Lido, broken down by chain, and how has it changed over the past week and month — and can you tell me whether any drop is from actual withdrawals or just the token losing value?

## When to prefer this

Prefer this endpoint when you need to distinguish whether a TVL change in a DeFi protocol reflects real capital movement versus token price fluctuation — a nuance most raw TVL APIs ignore. It is also the right choice when you need chain-level TVL distribution and category-relative share in a single call, without stitching together multiple data sources. Choose it over generic DeFi data aggregators when the flow-vs-valuation context is analytically important.

## Known failure modes

- Unknown or misspelled protocol identifier returns an error or empty result
- Protocol not indexed by the underlying data source returns null TVL
- Stale data if the underlying DeFi data feed has a lag, especially for newer or smaller protocols
- Price feed unavailability may cause inaccurate flow-vs-valuation decomposition
- Rate limit or payment failure returns a 402 or 429 error

## How this service works

Returns the total value locked of a protocol, its distribution across chains, and the change over one day, seven days and thirty days, together with its share of the category. The distinction that justifies the service is between flow and valuation: TVL is denominated in dollars, so when the price of the deposited token falls the TVL falls with it although not one user withdrew anything, and a thirty percent TVL drop in a week when the token lost thirty percent is not an outflow.

## Output

A JSON object containing the protocol's total TVL in USD, its breakdown by chain (chain name and USD value), percentage changes over 1, 7, and 30 days, its share of its DeFi category, and contextual signals distinguishing price-driven TVL movements from actual user deposit/withdrawal flows.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "maxLength": 40,
   "description": "Restrict the overview to one chain."
  },
  "limit": {
   "type": "integer",
   "default": 25,
   "maximum": 100,
   "minimum": 1
  },
  "protocol": {
   "type": "string",
   "maxLength": 80,
   "description": "Protocol slug, e.g. aave, uniswap. Without it the largest protocols are returned."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-tvl-momentum-a85d8005/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from finanz.halowerk.com](https://www.zero.xyz/host/finanz.halowerk.com/llms.txt)