# DeFi TVL Gainers & Losers

> DeFi TVL Gainers & Losers is a paid API for AI agents from bess-x402.onrender.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-29).

Returns DeFi protocols ranked by largest TVL gains or losses over a chosen time period, with capital flow data, filterable by chain, category, and minimum TVL.

## Facts

- Endpoint: GET https://bess-x402.onrender.com/v1/defi/tvl-movers?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-tvl-gainers-losers-72a6cb3d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3KXajbfpQzXkaKdPKYta_

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-gainers-losers-72a6cb3d
```

Example prompt: Show me the top 10 DeFi protocols that gained and lost the most TVL over the last 24 hours on Base, only include protocols with at least $5 million in TVL.

## When to prefer this

Use this endpoint when you need to identify which DeFi protocols are gaining or losing capital quickly, especially when filtering by chain or category. It is ideal for market monitoring, trend detection, and capital flow analysis in DeFi. Prefer it over general price or market cap endpoints when TVL movement and net flow are the primary signal of interest.

## Known failure modes

- Invalid period value (not 1h, 1d, or 7d) returns a 400 error
- Unknown chain or category name may return empty results or an error
- limit out of range (outside 1-50) returns a validation error
- Payment not included or insufficient results in 402 Payment Required
- min_tvl too high may return zero results if no protocols qualify

## How this service works

DeFi protocols whose TVL grew or shrank most over 1 hour, 1 day or 7 days, filtered by chain, category and minimum TVL, with net flow. Use to see where capital is moving.

## Output

A ranked list of DeFi protocols split into gainers and losers, each showing protocol name, chain, category, current TVL, TVL change in absolute USD and percentage, and net capital flow over the requested period.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Chain, e.g. Base"
      },
      "limit": {
       "type": "integer",
       "description": "Rows each side (1-50)"
      },
      "period": {
       "type": "string",
       "description": "1h, 1d or 7d"
      },
      "min_tvl": {
       "type": "number",
       "description": "Minimum TVL in USD"
      },
      "category": {
       "type": "string",
       "description": "Category, e.g. Lending"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-tvl-gainers-losers-72a6cb3d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bess-x402.onrender.com](https://www.zero.xyz/host/bess-x402.onrender.com/llms.txt)