DeFiLlama Chains TVL Scraper

DeFiLlama Chains TVL Scraper

Scrape total value locked (TVL) for every blockchain on DeFiLlama, filtered by minimum TVL or name, up to a million chains per run. Each chain comes with its current TVL in USD, chain ID, and native token. Export to CSV, JSON, Excel, or XML.

DeFiLlama's public dashboard shows chain TVL rankings, but pulling that data into a spreadsheet or a model means manual copy-paste or writing your own API glue. This Actor reads the chain list directly, lets you set a minimum TVL threshold and a name filter, and returns every matching chain in one flat table. No API key, no rate-limit headaches.

Who uses it	What they scrape DeFiLlama for
Crypto analysts	Compare ecosystem size across chains to spot capital rotation trends.
DeFi researchers	Pull a clean dataset of chain TVLs for a weekly market report.
Portfolio managers	Filter chains above a TVL floor to identify investable ecosystems.
Data engineers	Feed a live chain TVL feed into an internal dashboard or data warehouse.

What it does

This Actor collects DeFiLlama chain TVL data and returns each chain as a flat row with its name, TVL in USD, chain ID, and native token.

• 📊 TVL threshold: set a minimum TVL in USD so only chains above that value reach your dataset.
• 🔍 Name filter: pass a substring to return only chains whose name contains it, case-insensitive.
• 📈 Sort control: order results by TVL (descending), name, or chain ID.
• ⚡ High throughput: collect up to a million chains in a single run, limited only by what DeFiLlama lists.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with DeFiLlama data

📈 Rank ecosystems by size.

A crypto analyst runs the Actor daily with sort by TVL to track which L1s and L2s are gaining or losing total value locked.

🔎 Filter for a specific chain family.

A researcher sets nameContains to 'Ethereum' to pull only Ethereum, Ethereum Classic, and Ethereum rollups into one dataset.

💰 Screen for investable chains.

A portfolio manager sets minTvl to 100000000 to list only chains with at least $100M TVL, then exports the list for due diligence.

📡 Feed a live dashboard.

A data engineer schedules the Actor every hour and pipes the JSON output into a Grafana panel that shows chain TVL trends.

Why choose this scraper

	What you get
No API key required	Reads the public chain list directly, no registration or OAuth.
Flat, predictable schema	Every chain lands as one row with the same columns, ready for Excel or SQL.
Built-in filters	Min TVL and name contains let you narrow the list before it hits storage.
Flexible export	Download as CSV, JSON, Excel, or XML from the Apify dataset.

How it compares

Three other Apify actors also scrape DeFiLlama chain TVL data; this one focuses on a clean, filterable current snapshot with no extra endpoints.

Feature	ParseForge	DefiLlama Scraper	DefiLlama Chain TVL Scraper	⛓️ DefiLlama Chain TVL Rankings
Current chain TVL	Yes	Yes	Yes	Yes
Min TVL filter	Yes	Not listed	Not listed	Not listed
Name contains filter	Yes	Not listed	Not listed	Not listed
Sort by TVL, name, or chain ID	Yes	Not listed	Not listed	Not listed
Historical TVL series	Not listed	Yes	Yes	Not listed
Protocol-level metrics	Not listed	Yes	Not listed	Not listed

Configure the run

Drive the Actor with an optional minimum TVL, a name substring, and a sort field; filters run as each chain is read so only matches reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

{
 "maxItems": 10
}

A larger pull:

{
 "maxItems": 200
}

Pricing

Pay-per-result: $0.0085 per result collected. You pay only for the results written to your dataset.

Results collected	Approximate cost
100 results	$0.85
1,000 results	$8.50
10,000 results	$85.00

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

1. Create a free Apify account with $5 in credit.
2. Open the DeFiLlama Chains TVL Scraper.
3. Set your inputs and any filters, then click Start.
4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to DeFiLlama through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

$claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/defillama-chains-tvl-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting fewer results than I expected?

Check your minTvl and nameContains filters. If minTvl is set high, many chains may be excluded. Remove the filters and run again to see the full list.

The run finished but the dataset is empty.

Your filters may be too restrictive. Try lowering minTvl or clearing nameContains. Also confirm DeFiLlama is reachable from your network.

I need historical TVL, not current.

This Actor only returns the current TVL snapshot. Look for a scraper that targets the DeFiLlama historical charts endpoint for time-series data.

The TVL values look different from the DeFiLlama website.

DeFiLlama updates TVL continuously. A small difference is normal if the website refreshed after your run. Re-run the Actor to get the latest values.

Can I get protocol TVL inside each chain?

This Actor returns chain-level TVL only. You would need a different scraper that calls the DeFiLlama protocols endpoint for per-protocol data.

FAQ

Question	Answer
Does this Actor need a DeFiLlama API key?	No. It reads the same public endpoints the DeFiLlama frontend uses, so no registration or API key is required.
What TVL metric does it return?	It returns the current total value locked in USD as reported by DeFiLlama for each chain at the moment the Actor runs.
Can I get historical TVL data?	This Actor returns the current TVL snapshot. For historical TVL series, consider a scraper that targets the historical charts endpoint.
How many chains can I collect in one run?	You can set maxItems up to 1,000,000. The actual number returned depends on how many chains DeFiLlama lists and your filters.
Does it return protocol-level TVL inside each chain?	No, this Actor returns chain-level TVL only. For protocol-level data you would need a different scraper that targets the protocols endpoint.
Can I filter by chain ID?	You can sort by chain ID, but there is no chain ID filter input. Use the nameContains filter to narrow by name instead.
What output formats are supported?	You can export the dataset as CSV, JSON, Excel, or XML directly from the Apify run console.
How often does the data refresh?	The Actor pulls live data from DeFiLlama on every run. Schedule it to run as often as you need fresh snapshots.
Is this Actor affiliated with DeFiLlama?	No, it is an independent community scraper that reads publicly available data from DeFiLlama.
Can I run this for free on Apify?	Yes, Apify's free tier includes enough compute to run this Actor regularly, depending on the number of chains you collect.

Related actors

Browse the full ParseForge collection for more scrapers.

🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by DeFiLlama. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.