ParseForge
DeFiLlama Chains TVL Scraper
parseforge/defillama-chains-tvl-scraper
AutomationIntegrationsBusiness
Scrapes current total value locked (TVL) for every blockchain listed on DeFiLlama. Returns each chain as a flat row with TVL in USD, chain ID, and native token. Filter by minimum TVL or name.
- Total users
- 2
- Monthly active
- 1
- Total runs
- 86
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 9 days ago
Overview
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
- Create a free Apify account with $5 in credit.
- Open the DeFiLlama Chains TVL Scraper.
- Set your inputs and any filters, then click Start.
- 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.
Input
| Field | Type | What it does | Default |
|---|---|---|---|
| maxItems | integer | Maximum number of chains to collect per run. | 10 |
| minTvl | integer | Only return chains with TVL at least this value in USD. | not set |
| nameContains | string | Case-insensitive substring match on chain name. | not set |
| sortBy | string (3 options) | Field used to order the results. | tvl |
Pricing
from $7.50 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| result | Single result in the default dataset. | $0.0075 to $0.0085 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
API
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~defillama-chains-tvl-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"helloWorld": 123
}' Examples
Input that runs as-is.
{
"helloWorld": 123
} Reviews
No reviews yet. Be the first.
Issues
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.