# Blockchain TVL History & Cycle Analytics

> Blockchain TVL History & Cycle Analytics 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-01).

Returns TVL history for a blockchain including current value, all-time high, drawdown from ATH, and 30-day/1-year changes, sourced live from DefiLlama.

## Facts

- Endpoint: POST https://api.vextorium.com/cadena-historico-pago?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockchain-tvl-history-cycle-analytics-99dc2f73
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uLeo4cLREO9s5IUDQCfp8

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 blockchain-tvl-history-cycle-analytics-99dc2f73 -d '<json body>'
```

Example prompt: Pull the TVL history for Solana over the last 365 days — I want to see the current TVL, the all-time high and when it happened, how far it is from that ATH, and the 30-day and 1-year percentage changes.

## When to prefer this

Use this endpoint when you need historical TVL data for a specific blockchain with cycle-context metrics (ATH, drawdown, momentum) rather than just a current snapshot. Ideal for DeFi research, chain comparisons, and market cycle analysis. Prefer over raw DefiLlama API access when you need preprocessed metrics like ATH date, drawdown percentage, and sampled series in a single call.

## Known failure modes

- Unknown or misspelled chain name returns null or empty result
- DefiLlama upstream outage causes stale or unavailable data
- Days parameter outside 30–2000 range is rejected with validation error
- Chain with very short history may return incomplete series data

## How this service works

TVL history of a blockchain: current value, all-time high and its date, distance from ATH, 30d and 1y change, plus a sampled series. Shows where a chain sits in the cycle. Live from DefiLlama.

## Output

Returns a JSON object with the chain name, current TVL in USD, all-time high TVL in USD, the date of the ATH, percentage drawdown from ATH, 30-day and 1-year percentage changes, and a sampled time series of {date, tvl_usd} data points covering the requested look-back window. May also include a human-readable note.

## 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": [
      "cadena"
     ],
     "properties": {
      "dias": {
       "type": "integer",
       "maximum": 2000,
       "minimum": 30,
       "description": "Look-back window in days (30-2000, default 365)"
      },
      "cadena": {
       "type": "string",
       "description": "Chain name, e.g. Ethereum, Base, Solana, Arbitrum"
      }
     }
    },
    "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": {
      "nota": {
       "type": [
        "string",
        "null"
       ]
      },
      "serie": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "fecha": {
          "type": [
           "null",
           "string"
          ]
         },
         "tvl_usd": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      },
      "cadena": {
       "type": [
        "string",
        "null"
       ]
      },
      "fecha_maximo": {
       "type": [
        "string",
        "null"
       ]
      },
      "cambio_1a_pct": {
       "type": [
        "number",
        "null"
       ]
      },
      "cambio_30d_pct": {
       "type": [
        "number",
        "null"
       ]
      },
      "tvl_actual_usd": {
       "type": [
        "number",
        "null"
       ]
      },
      "desde_maximo_pct": {
       "type": [
        "number",
        "null"
       ]
      },
      "maximo_historico_usd": {
       "type": [
        "number",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "nota": "TVL histórico de la cadena. La distancia al máximo indica en qué punto del ciclo está. Fuente: DefiLlama.",
  "serie": [
   {
    "fecha": "2025-10-01",
    "tvl_usd": 87979353983
   },
   {
    "fecha": "2025-10-31",
    "tvl_usd": 84255331431
   },
   {
    "fecha": "2025-11-30",
    "tvl_usd": 68281250873
   },
   {
    "fecha": "2025-12-30",
    "tvl_usd": 67691816494
   },
   {
    "fecha": "2026-01-29",
    "tvl_usd": 71205336803
   },
   {
    "fecha": "2026-02-28",
    "tvl_usd": 52641185798
   },
   {
    "fecha": "2026-03-30",
    "tvl_usd": 52537857961
   },
   {
    "fecha": "2026-04-29",
    "tvl_usd": 44908393612
   },
   {
    "fecha": "2026-05-29",
    "tvl_usd": 42638382399
   },
   {
    "fecha": "2026-06-28",
    "tvl_usd": 37572359707
   },
   {
    "fecha": "2026-07-28",
    "tvl_usd": 41302987685
   },
   {
    "fecha": "2026-08-27",
    "tvl_usd": 49935445405
   },
   {
    "fecha": "2026-09-26",
    "tvl_usd": 53549828460
   }
  ],
  "cadena": "Ethereum",
  "fecha_maximo": "2021-11-09",
  "cambio_1a_pct": -40.24,
  "cambio_30d_pct": 8.32,
  "tvl_actual_usd": 52830721315,
  "desde_maximo_pct": -50.84,
  "maximo_historico_usd": 107458598469
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockchain-tvl-history-cycle-analytics-99dc2f73/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)