# DeFi Protocol Category TVL Ranking

> DeFi Protocol Category TVL Ranking is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-13).

Returns a TVL-ranked list of DeFi protocols within a specified category (e.g. Lending, DEXs, Liquid Staking), optionally filtered by chain, including 1d/7d changes and category share percentages.

## Facts

- Endpoint: POST https://api.vextorium.com/protocolos-categoria-pago?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-protocol-category-tvl-ranking-0cfbeaf9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qxZflGNY0EUUI61Lweu8y

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-protocol-category-tvl-ranking-0cfbeaf9 -d '<json body>'
```

Example prompt: Show me the top 10 lending protocols ranked by TVL, including their 1-day and 7-day changes and their share of the total lending market.

## When to prefer this

Use this endpoint when you need a structured, ranked view of DeFi protocols within a specific category (Lending, DEXs, Bridges, Liquid Staking, etc.) sorted by TVL, with market share and recent momentum signals. Prefer this over raw on-chain queries when you need category-level competitive intelligence, sourced from DefiLlama, without needing to aggregate data yourself. Ideal for DeFi research agents, portfolio dashboards, and market monitoring workflows.

## Known failure modes

- Invalid or unrecognized category name returns empty or error response
- Chain name misspelled or unsupported returns no results
- DefiLlama upstream data unavailable causes stale or failed response
- Limit parameter too large may return truncated results
- Missing required 'categoria' field returns validation error

## How this service works

Ranking of DeFi protocols in a category (Lending, Dexs, Liquid Staking, Bridge, Yield, Derivatives, RWA, CDP, Restaking...) by TVL, optionally on one chain, with 1d and 7d change and share of the category.

## Output

Returns a JSON object with the category name, optional chain filter, data source (DefiLlama), total number of protocols in the category, total category TVL in USD, and an array of ranked protocols each containing: protocol name, associated token, number of chains deployed on, TVL in USD, category market share percentage, 1-day TVL change percent, and 7-day TVL change percent.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "categoria"
     ],
     "properties": {
      "cadena": {
       "type": "string",
       "description": "e.g. Base, Solana (optional)"
      },
      "limite": {
       "type": "integer"
      },
      "categoria": {
       "type": "string"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "cadena": {},
      "fuente": {
       "type": [
        "string",
        "null"
       ]
      },
      "ranking": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "token": {
          "type": [
           "null",
           "string"
          ]
         },
         "cadenas": {
          "type": [
           "null",
           "number"
          ]
         },
         "tvl_usd": {
          "type": [
           "null",
           "number"
          ]
         },
         "cuota_pct": {
          "type": [
           "null",
           "number"
          ]
         },
         "protocolo": {
          "type": [
           "null",
           "string"
          ]
         },
         "cambio_1d_pct": {
          "type": [
           "null",
           "number"
          ]
         },
         "cambio_7d_pct": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      },
      "categoria": {
       "type": [
        "string",
        "null"
       ]
      },
      "protocolos_total": {
       "type": [
        "number",
        "null"
       ]
      },
      "tvl_categoria_usd": {
       "type": [
        "number",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cadena": null,
  "fuente": "DefiLlama",
  "ranking": [
   {
    "token": "AAVE",
    "cadenas": 21,
    "tvl_usd": 18271827466,
    "cuota_pct": 32.92,
    "protocolo": "Aave V3",
    "cambio_1d_pct": 0.54,
    "cambio_7d_pct": 0.14
   },
   {
    "token": "MORPHO",
    "cadenas": 45,
    "tvl_usd": 11270408756,
    "cuota_pct": 20.3,
    "protocolo": "Morpho Blue",
    "cambio_1d_pct": 1.2,
    "cambio_7d_pct": 3.66
   },
   {
    "token": "SPK",
    "cadenas": 2,
    "tvl_usd": 5764424531,
    "cuota_pct": 10.38,
    "protocolo": "SparkLend",
    "cambio_1d_pct": 1.92,
    "cambio_7d_pct": 2.63
   },
   {
    "token": "JST",
    "cadenas": 1,
    "tvl_usd": 3921316853,
    "cuota_pct": 7.06,
    "protocolo": "JustLend V1",
    "cambio_1d_pct": 1.4,
    "cambio_7d_pct": 0.71
   },
   {
    "token": "SYRUP",
    "cadenas": 2,
    "tvl_usd": 2991997595,
    "cuota_pct": 5.39,
    "protocolo": "Maple",
    "cambio_1d_pct": 0.89,
    "cambio_7d_pct": -0.35
   }
  ],
  "categoria": "Lending",
  "protocolos_total": 576,
  "tvl_categoria_usd": 55507745514
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-protocol-category-tvl-ranking-0cfbeaf9/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)