DefiLlama

Access DeFi protocols data using the DefiLlama API

Actions20

Bridge Actions
- List Bridges
- Get Bridge Volume
Category Actions
- List Categories
Chain Actions
- List All Chains
- Get Chain TVL
DEXs & Volume Actions
- Get DEXs Overview
- Get DEX Volume
Fees & Revenue Actions
- Get Fees Overview
- Get Protocol Fees
Hack Actions
- List Hacks
Oracle Actions
- List Oracles
Protocol Actions
Raise Actions
- List Raises
Stablecoin Actions
TVL Actions
- Get Historical TVL
Yield Actions
- Get Yield Pools

Overview

This node integrates with the DefiLlama API to fetch decentralized finance (DeFi) data related to blockchain chains, specifically focusing on retrieving historical Total Value Locked (TVL) data for a given blockchain chain. The "Get Chain TVL" operation allows users to obtain time-series data showing how the TVL of a specific chain has evolved over time.

Typical use cases include:

Monitoring the growth or decline of TVL on a particular blockchain network.
Analyzing trends in DeFi activity on chains like Ethereum, Polygon, or Arbitrum.
Feeding historical TVL data into dashboards or analytics workflows for investment or research purposes.

Example: A user wants to track the historical TVL of the Ethereum chain to understand its DeFi ecosystem's health and growth over the past months.

Properties

Name	Meaning
Chain Slug	The identifier slug of the blockchain chain to query (e.g., "ethereum", "polygon").
Additional Fields	A collection of optional parameters; for this operation, no additional fields are used.

Note: For the "Get Chain TVL" operation under the "Chain" resource, only the required "Chain Slug" property is relevant.

Output

The output JSON contains an array of historical TVL data points for the specified chain. Each data point typically includes:

date: Timestamp of the data point (usually in UNIX epoch seconds).
totalLiquidityUSD or similar field representing the TVL value in USD at that date.

Additionally, the node formats some fields for easier readability (e.g., formatted currency strings). Metadata about the resource, operation, and fetch timestamp is also included in each output item.

If AI Agent Mode is enabled via additional fields (not typical for this operation), the output will be simplified and include a human-readable summary alongside the raw data.

Dependencies

Requires access to the public DefiLlama API endpoint (https://api.llama.fi).
Optionally supports using an API key credential if provided, which is sent as a Bearer token in the Authorization header.
No other external dependencies are required.

Troubleshooting

Invalid Chain Slug: If the chain slug is incorrect or not supported by DefiLlama, the API may return an error or empty data. Verify the slug spelling and availability on DefiLlama.
API Rate Limits: Excessive requests without an API key might hit rate limits. Using an API key credential can help mitigate this.
Network Issues: Ensure your environment can reach https://api.llama.fi.
Empty Data: If no historical TVL data is returned, confirm that the chain has available historical data on DefiLlama.

Links and References

This summary focuses exclusively on the "Chain" resource with the "Get Chain TVL" operation as requested.

DefiLlamaInstall