DeFiLlama Protocols TVL Scraper avatar

DeFiLlama Protocols TVL Scraper

Pricing

from $7.50 / 1,000 results

Go to Apify Store
DeFiLlama Protocols TVL Scraper

DeFiLlama Protocols TVL Scraper

Scrapes DeFi protocol TVL data from DeFiLlama. Filter by category, chain, name, or minimum TVL and get a flat dataset of protocols with their total value locked.

Pricing

from $7.50 / 1,000 results

Rating

0.0

(0)

Developer

ParseForge

ParseForge

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

3 days ago

Last modified

Share

ParseForge

DeFiLlama Protocols TVL Scraper

Scrape DeFi protocol TVL, chain, and category data from DeFiLlama, up to a million protocols per run. Every protocol comes with its total value locked, chain breakdowns, and category tags. No API key required. Export to CSV, JSON, Excel, or XML.

DeFiLlama is the open-source, community-maintained reference for decentralized finance analytics, but querying its API for bulk protocol data means writing scripts and handling pagination. This Actor reads the public DeFiLlama protocol endpoints directly, filters by category, chain, name, or minimum TVL, and returns each match in one fixed schema.\n\nNo registration, no API key, and no rate-limit headaches.

Who uses itWhat they scrape DeFiLlama for
DeFi analystsRank protocols by TVL within a specific category or chain to identify market leaders.
Crypto investorsScreen protocols above a minimum TVL threshold to filter out low-liquidity projects.
Blockchain researchersPull the full protocol list for a chain to map its DeFi ecosystem.
Data journalistsTrack TVL changes across categories over time for DeFi market reports.

What it does

This Actor collects DeFiLlama protocol listings by category, chain, name, or minimum TVL, and returns each one as a flat row with its total value locked and metadata.

  • ๐Ÿท๏ธ Category filter: Narrow results to a single DeFi category like Dexes, Lending, or Liquid Staking.
  • โ›“๏ธ Chain filter: Restrict protocols to those deployed on a specific blockchain.
  • ๐Ÿ” Name search: Case-insensitive substring match to find protocols by partial name.
  • ๐Ÿ’ฐ TVL threshold: Exclude protocols below a minimum total value locked in USD.

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

What you can do with DeFiLlama data

๐Ÿ“Š Rank top DeFi protocols by category.

A DeFi analyst sets the category to 'Lending' and a high minTvl to pull only the largest lending protocols, then ranks them by TVL for a quarterly market report.

โ›“๏ธ Map a single chain's DeFi ecosystem.

A blockchain researcher sets the chain to 'Arbitrum' and collects every protocol deployed there to analyze ecosystem growth and category diversity.

๐Ÿ” Find protocols by name fragment.

An investor sets nameContains to 'swap' and minTvl to 1000000 to discover all DEX protocols with meaningful liquidity that match the search term.

๐Ÿ“ˆ Monitor TVL thresholds across categories.

A data journalist runs the Actor weekly with different category values and a fixed minTvl to track which DeFi sectors are gaining or losing total value locked.

Why choose this scraper

What you get
No API keyReads DeFiLlama public endpoints directly, no registration or token needed.
Bulk extractionCollect up to a million protocols in a single run.
Fixed schemaEvery protocol lands as a flat row, ready for CSV, JSON, Excel, or XML export.
Server-side filteringFilters apply during collection so your dataset contains only the protocols you need.

How it compares

This Actor focuses on protocol-level TVL with server-side filtering by category, chain, name, and minimum TVL, while other DeFiLlama scrapers target different endpoints or offer broader data types.

FeatureParseForgeDefiLlama ScraperDeFiLlama Protocol TVL ScraperDeFiLlama Scraper - TVL, Yields & Stablecoins
Protocol TVL dataYesYesYesYes
Filter by categoryYesNot listedNot listedNot listed
Filter by chainYesNot listedNot listedYes
Filter by minimum TVLYesNot listedNot listedNot listed
Name substring searchYesNot listedNot listedNot listed
Yield and APY dataNot listedNot listedNot listedYes
Stablecoin supply dataNot listedYesNot listedYes

Configure the run

Drive the Actor from a category, chain, name substring, and minimum TVL, alone or together, and filters run as each protocol 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 collectedApproximate 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 Protocols 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-protocols-tvl-scraper"

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

Troubleshooting

Why am I getting no results?

Check that your filter values match DeFiLlama's naming conventions. Chain names should be lowercase slugs like 'ethereum'. Category names should match exactly, such as 'Dexes' or 'Lending'. Try removing filters one at a time to identify which one is too restrictive.

Why is the TVL value different from what I see on the DeFiLlama website?

DeFiLlama updates TVL data frequently. The Actor returns the value at the moment of collection. Small discrepancies are normal due to timing differences.

The run timed out before reaching my maxItems limit.

Increase the Actor's timeout setting in the run configuration. Very large collections may need more time. You can also split the work by running separate collections per category or chain.

My nameContains filter is not finding a protocol I know exists.

The filter is case-insensitive but requires an exact substring match. Try a shorter fragment of the name. For example, 'aave' will match 'Aave V3' but 'aave v3' will not match 'Aave'.

The Actor returns fewer protocols than expected.

DeFiLlama's public API may paginate or limit results. Check that your maxItems value is high enough and that your filters are not unintentionally narrowing the result set.

FAQ

QuestionAnswer
Do I need a DeFiLlama API key?No. This Actor reads DeFiLlama's public endpoints directly. No registration, no API key, and no authentication are required.
What data does each protocol row include?Each row includes the protocol name, its total value locked in USD, the chains it is deployed on, its category, and additional metadata from the DeFiLlama API.
Can I filter by multiple categories at once?The category filter accepts a single category per run. To collect multiple categories, run the Actor once per category and merge the datasets afterward.
How many protocols can I scrape in one run?You can set maxItems up to 1,000,000. The Actor will collect protocols until it reaches that limit or exhausts the matching results from DeFiLlama.
Does this Actor get historical TVL data?No. This Actor returns the current TVL snapshot for each protocol. For historical TVL charts, you would need a different endpoint or Actor.
What export formats are supported?You can export your dataset to CSV, JSON, Excel, or XML directly from the Apify platform.
Can I run this on a schedule?Yes. Use Apify's scheduler to run the Actor hourly, daily, or weekly to track TVL changes over time.
What happens if I leave all filters empty?The Actor returns all protocols from DeFiLlama, up to the maxItems limit you set, ordered by the default DeFiLlama ranking.
Is the chain filter case-sensitive?Chain names should match DeFiLlama's naming convention. Use lowercase slugs like 'ethereum', 'arbitrum', or 'polygon' for best results.
Does this Actor scrape yield pools or stablecoins?No. This Actor focuses on protocol-level TVL data. For yield pools, stablecoin pegs, or APY data, consider a different Actor that targets those DeFiLlama endpoints.

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.