# DeFi TVL Movers (Gainers & Losers)

> DeFi TVL Movers (Gainers & Losers) is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-24).

Returns DeFi protocols with the largest TVL rise or fall over a selected time period, with optional filters for minimum TVL and category.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/defi-tvl-movers?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-tvl-movers-gainers-losers-3ebbe02e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9hBTbnQD8tY7L60c0l1nP

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-movers-gainers-losers-3ebbe02e -d '<json body>'
```

Example prompt: Show me the top 10 DeFi protocols that lost the most TVL over the last 24 hours, only include protocols with at least $10M TVL, and focus on lending protocols.

## When to prefer this

Use this endpoint when you need to quickly identify DeFi protocols experiencing abnormal capital movements — especially for incident detection, trend scouting, or generating market briefings. It is ideal over manual DefiLlama browsing when you need programmatic, filterable, ranked output. Prefer this over general DeFi data endpoints when the user's goal is specifically about relative TVL change (gainers/losers) rather than absolute TVL rankings.

## Known failure modes

- Invalid period value (not 1h, 1d, or 7d) — returns validation error
- Limit outside 1-50 range — returns error
- DefiLlama data source temporarily unavailable — may return empty or stale results
- Category filter string not matching any known protocol category — returns empty protocol list
- min_tvl set so high that no protocols qualify — returns empty list

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

A ranked list of DeFi protocols with their name, category, chains they operate on, current TVL in USD, and percentage TVL change over the selected period. Includes a note about potential causes of sharp changes and metadata about the query (period, direction, minimum TVL filter).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Protocols (1-50, default 15)"
  },
  "period": {
   "enum": [
    "1h",
    "1d",
    "7d"
   ],
   "type": "string"
  },
  "address": {
   "enum": [
    "gainers",
    "losers"
   ],
   "type": "string"
  },
  "min_tvl": {
   "type": "number",
   "description": "Minimum TVL in USD (default 10M)"
  },
  "category": {
   "type": "string",
   "description": "e.g. Lending, Dexs, Liquid Staking (optional)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Sharp TVL changes can be due to asset prices, migrations or incidents. Source: DefiLlama.",
  "period": "1d",
  "address": "losers",
  "protocols": [
   {
    "chains": [
     "Bitcoin"
    ],
    "tvl_usd": 175736234,
    "category": "Bridge",
    "protocol": "Circle Bitcoin",
    "change_pct": -38.34
   },
   {
    "chains": [
     "Hyperliquid L1",
     "Ethereum"
    ],
    "tvl_usd": 34225971,
    "category": "Options Vault",
    "protocol": "Rysk V12",
    "change_pct": -33.97
   }
  ],
  "min_tvl_usd": 10000000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-tvl-movers-gainers-losers-3ebbe02e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)