Blockchain TVL History by Chain

DefiLlama

Blockchain TVL History by Chain | DefiLlama

Enter one chain slug, such as ethereum, base or arbitrum, to get that chain's historical TVL series. Valid slugs come from DefiLlama's /chains list or the chains field on /protocols. The call takes no date range, no multiple chains and no protocol filter.

You receive

One call returns the selected chain's historical TVL as date and value points, excluding liquid staking and double-counted TVL. Output fields are unpublished, so read the series. This is one chain's history, not a ranking or price. Pay per use, no subscription; catalog maximum $0 per call.

Start with your task

Retrieve the historical TVL for [Ethereum], explain its USD values and exclusions, and summarize changes over the dates available.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
pathParams`pathParams`	`object`	Required	Required fields `chain`
Chain`pathParams.chain`	`string`	Required	Required chain identifier accepted by DefiLlama, such as Ethereum. Get valid values from the chains list or the chains field on protocols. Submit one chain per call; this input is not a protocol, wallet or token address. Examples `Ethereum`

View raw JSON

{
  "type": "object",
  "required": [
    "pathParams"
  ],
  "properties": {
    "pathParams": {
      "type": "object",
      "required": [
        "chain"
      ],
      "properties": {
        "chain": {
          "type": "string",
          "examples": [
            "Ethereum"
          ],
          "description": "chain slug, you can get these from /chains or the chains property on /protocols"
        }
      },
      "additionalProperties": true
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

Follow the TVL history of one blockchain

Use this tool when a report needs the historical total value locked on one chain, rather than a current ranking of every chain. It retrieves DefiLlama's chain-level history with liquid staking and double-counted TVL excluded. A researcher can use that series to describe changes over time or provide a dated baseline for a chain ecosystem report.

Choose a valid chain identifier

Provide pathParams.chain using an identifier accepted by DefiLlama; Ethereum is the documented example. Valid values can be discovered from DefiLlama's chains list or the chains field on protocol records. A protocol slug, wallet address or token address is not a chain identifier. There is one chain input, with no date range, multiple-chain selection or protocol filter.

Understand the dated values

The official endpoint documents an array of points containing date, a Unix timestamp in seconds, and tvl, the value in US dollars for the selected chain. Convert the timestamps to a consistent UTC date when joining another dataset. The returned coverage can vary by chain and provider updates. The latest point is the latest observation supplied, not a promise of a live intraday reading.

Prepare a chart or period comparison

Check the first and last available dates, then select the points needed for your analysis from the returned series. A month or quarter is a downstream selection, not a date-range parameter on this tool. For comparisons with a second chain, obtain its series separately and align the dates and units before calculating changes. Missing points should not automatically be treated as zero TVL.

Interpret TVL changes carefully

USD TVL depends on asset prices as well as deposited balances. A falling value therefore does not, by itself, establish that users withdrew capital. The default exclusions also differ from dashboards with optional liquid-staking or double-counting toggles enabled. This endpoint does not produce individual protocol histories, wallet balances, token prices or an investment return forecast.

Source and scope

The series follows DefiLlama’s official API documentation and TVL data definitions. Retain the chain identifier and lookup time with your report. Check returned dates and values before connecting the series to another dataset.

Blockchain TVL History by Chain | DefiLlama