DeFiLlama Scraper — DeFi Protocols, TVL, Chains & Yields avatar

DeFiLlama Scraper — DeFi Protocols, TVL, Chains & Yields

Pricing

from $1.50 / 1,000 results

Go to Apify Store
DeFiLlama Scraper — DeFi Protocols, TVL, Chains & Yields

DeFiLlama Scraper — DeFi Protocols, TVL, Chains & Yields

Scrape DeFiLlama DeFi data: protocols with TVL, chain, category, 1h/1d/7d change and market cap; chain-level TVL rankings; and yield pools with APY, base/reward APY and TVL. Filter by chain, category or search. For crypto research, dashboards and DeFi analytics. Not affiliated with DeFiLlama.

Pricing

from $1.50 / 1,000 results

Rating

0.0

(0)

Developer

Haketa

Haketa

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

8 days ago

Last modified

Categories

Features

Limited permissions

Share

DeFiLlama Scraper — DeFi Protocols, TVL, Chains & Yield APY

The premier DeFiLlama scraper for extracting real-time decentralized finance (DeFi) data across protocols, blockchains, and yield farming pools — without API keys or rate barriers. Scrape and monitor thousands of DeFi protocols with Total Value Locked (TVL), 1h/1d/7d percentage changes, and market capitalization; chain-level TVL rankings across hundreds of EVM and non-EVM ecosystems; and detailed yield pools featuring base APY, reward APY, 30-day historical averages, and algorithmic outlook predictions.

Export thousands of records seamlessly to JSON, CSV, Excel, or direct API integration.

Apify Actor DeFi Market

Essential for crypto analysts, quantitative trading desks, DeFi portfolio managers, yield farmers, Web3 founders, tokenomics researchers, and data journalists building automated crypto dashboards and market screening pipelines.


⚡ At a glance

CapabilityFeature Details
Primary Data SourceDeFiLlama — the Web3 industry's independent, gold-standard TVL and yield aggregator
Supported Modes3-in-1: Protocols (TVL & changes), Chains (ecosystem TVL rankings), and Yields (APY & pool metrics)
Protocol Detail ModeDeep breakdowns by protocol slug (per-chain TVL allocations, contract audits, descriptions)
Total UniverseAccess to 8,800+ protocols, 400+ blockchains, and 15,000+ yield farming pools
Scale & PaginationUnlocked deep ingestion supporting 1,000+ to 10,000+ items per single run with zero artificial caps
Execution SpeedHigh-throughput HTTP engine: pulls and filters 1,000+ records in under 15 seconds
Authentication100% keyless, public data access; zero session cookies or wallet connections required
Export FormatsClean JSON, NDJSON, CSV, Excel (.xlsx), HTML tables, and Apify REST API

🔎 Why scrape DeFiLlama?

DeFiLlama is the undisputed benchmark of decentralized finance data. It tracks real-time capital allocation across all major decentralized applications: automated market makers (DEXes), collateralized debt positions (CDPs), decentralized lending markets, liquid staking providers, restaking protocols, real-world asset (RWA) tokenization, and cross-chain bridges. Because DeFiLlama enforces transparent, vendor-neutral TVL calculations, its numbers are cited universally by institutional investors, research desks, and financial media.

However, extracting systematic data directly from the DeFiLlama web interface presents significant bottlenecks:

  • No Native Bulk Export: The web dashboard does not offer comprehensive CSV exports for multi-chain comparisons or historical backtesting.
  • Complex Multi-Chain Breakdowns: Protocols often operate across dozens of Layer 1 and Layer 2 networks simultaneously (e.g., Uniswap across Ethereum, Arbitrum, Optimism, Base, Polygon). Isolating true canonical TVL from pseudo-categories (borrowed, pool2, staking) requires complex parsing.
  • Dynamic Yield Volatility: Yield farming APYs fluctuate hourly. Manual tracking makes it impossible to detect sudden yield spikes or liquidity drainage events.

This DeFiLlama scraper bridges the gap. It queries DeFiLlama's live endpoints, sanitizes and parses complex multi-nested JSON payloads, removes redundant non-canonical allocations, filters by chain and category, and exports standardized datasets directly into your analytical stack.


🎯 Key Use Cases & Business Applications

1. Institutional DeFi Research & Ecosystem Mapping

Compare capital concentration and market dominance across blockchains (Ethereum, Solana, Arbitrum, Base, BSC, Tron). Track capital flight or rapid growth across newly launched Layer 2 networks.

2. High-Yield APY Screening & Farming Strategies

Screen 15,000+ yield opportunities across lending platforms and liquidity pools. Filter specifically for stablecoin pools (USDC, USDT, DAI), single-token exposures without impermanent loss risk, and minimum TVL thresholds (e.g., TVL > $5M) to optimize treasury yields.

3. Quantitative Trading & TVL Momentum Signals

Analyze short-term capital inflows and outflows using change1h, change1d, and change7d indicators. Build programmatic alerts for protocols experiencing explosive liquidity accumulation or rapid capital withdrawal.

4. Protocol Watchlist & Risk Management

Monitor specific protocols (e.g., Lido, Aave, Maker/Sky, EigenLayer, Pendle) using protocolSlugs to track per-chain TVL allocations, audited contract changes, and market cap-to-TVL ratios.

5. Automated Web3 Dashboards & Data Feeds

Feed daily or hourly market snapshots into Google Sheets, Notion databases, Metabase dashboards, or custom Telegram/Discord alerting bots via the Apify REST API.


Filter your extraction across specialized decentralized finance sectors:

Sector CategoryKey Protocols IncludedPrimary Metrics Analyzed
DexesUniswap, Curve, PancakeSwap, RaydiumSpot volume, LP pool TVL, token fee generation
LendingAave, Compound, Morpho, SparkBorrowed amounts, collateralization, supply APY
Liquid StakingLido, Rocket Pool, Jito, MarinadeStaked ETH/SOL TVL, consensus validation yields
RestakingEigenLayer, Symbiotic, KarakDelegated restaking TVL, operator coverage
CDP & StablecoinsMaker/Sky, Ethena, LiquityBacking asset reserves, synthetic debt issuance
Yield & AggregatorsPendle, Yearn Finance, ConvexMulti-tier yield vaults, principal token splits
RWA (Real World Assets)Ondo Finance, Maple, CentrifugeTokenized US Treasury bonds, private credit

✨ Key Features & Technical Highlights

  • ✅ Three Specialized Extraction Modes:
    • Protocols Mode: Captures TVL, symbol, category, parent chain, market cap, and 1h/1d/7d changes.
    • Chains Mode: Captures total value locked per blockchain, native gas tokens, EVM chain IDs, and CoinGecko IDs.
    • Yields Mode: Captures live base APY, reward APY, 30-day mean APY, 7-day APY trend, volume, and predictive outlook classes.
  • ✅ Deep Protocol Breakdown: Supply specific protocol slugs to extract comprehensive per-chain TVL distributions (e.g., exactly how much TVL Aave holds on Arbitrum vs. Ethereum vs. Avalanche).
  • ✅ Full Catalog Access with 1K+ Results: Access thousands of protocols or yield pools in a single execution. Setting maxItems: 0 removes all bounds, returning the entire dataset.
  • ✅ Rich Filtering Controls: Narrow down results by target blockchain, protocol sector (Dexes, Lending, Liquid Staking, Yield), free-text queries, or minimum TVL cutoffs.
  • ✅ Predictive APY Outlook Modeling: Extracts DeFiLlama's proprietary machine-learning yield predictions (predictedClass and predictedProbability) indicating whether an APY is stable, decreasing, or unsustainable.
  • ✅ Cost-Effective Datacenter Execution: Executes as a lightweight HTTP client with no browser overhead, running in seconds for fractions of a penny.

🥊 DeFiLlama Scraper vs Manual Research

FeatureDeFiLlama ScraperManual Dashboard CopyingGeneric Scraping Tools
Coverage8,800+ protocols, 15,000+ pools~10-20 items per sessionStalls on large JSON payloads
Execution Time5-15 secondsHours of manual spreadsheet entryOften times out
Yield APY MetricsBase + Reward + 30d Mean APYUsually records only headline APYMisses nested reward breakdowns
Per-Chain BreakdownsCleanly parsed array of TVLsCumbersome tab clickingFails to filter pseudo-chains
Update FrequencyFully automated on scheduleManual labor requiredHigh maintenance overhead
Export OptionsJSON, CSV, Excel, REST APIManual file exportSingle format export

📥 Input Parameters

All parameters are optional. Running with default parameters fetches the top protocols globally ranked by TVL.

ParameterTypeDefaultDescription
entityTypeString"protocols"Target entity: "protocols" (TVL), "chains" (ecosystem TVL), or "yields" (APY pools).
searchTermsArray[]Filter by protocol name, token symbol, or yield project name.
chainsArray[]Filter by blockchain (e.g., ["Ethereum", "Arbitrum", "Solana"]).
categoriesArray[]Filter protocols by sector (e.g., ["Dexes", "Lending", "Liquid Staking"]).
protocolSlugsArray[]Specific slugs for deep inspection (e.g., ["lido", "aave", "uniswap"]).
minTvlInteger0Minimum TVL in USD threshold (0 = no minimum).
sortByString"tvl"Sort criteria for yields: "tvl" or "apy". Protocols and chains always sort by TVL.
maxItemsInteger0Maximum items to return (0 = unlimited, all available entries).
proxyConfigurationObject{ "useApifyProxy": true }Proxy configuration. Datacenter proxies are fully supported.

Example Input: Top Ethereum & Arbitrum Yield Pools

{
"entityType": "yields",
"chains": ["Ethereum", "Arbitrum"],
"sortBy": "apy",
"minTvl": 1000000,
"maxItems": 250,
"proxyConfiguration": {
"useApifyProxy": true
}
}

📤 Output Data Structure

The output schema varies depending on the chosen entityType. All records are normalized with clean numeric types and ISO timestamps.

Sample Yield Pool Record (entityType: "yields")

{
"project": "aave-v3",
"chain": "Ethereum",
"symbol": "USDC",
"poolMeta": "Core Instance",
"tvlUsd": 482910400,
"apy": 6.84,
"apyBase": 5.12,
"apyReward": 1.72,
"apyMean30d": 6.45,
"apyPct1D": 0.12,
"apyPct7D": -0.45,
"apyPct30D": 1.15,
"rewardTokens": ["0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"],
"stablecoin": true,
"ilRisk": "no",
"exposure": "single",
"underlyingTokens": ["0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"],
"volumeUsd1d": 18450200,
"volumeUsd7d": 129400500,
"predictedClass": "Stable/Up",
"predictedProbability": 88,
"poolId": "7e382b6b-4228-40b3-96b0-466d338a0886",
"defillamaUrl": "https://defillama.com/yields/pool/7e382b6b-4228-40b3-96b0-466d338a0886",
"scrapedAt": "2026-11-10T14:40:00.000Z"
}

Sample Protocol Record (entityType: "protocols")

{
"name": "Uniswap",
"slug": "uniswap",
"symbol": "UNI",
"category": "Dexes",
"chain": "Ethereum",
"chains": ["Ethereum", "Arbitrum", "Optimism", "Polygon", "Base", "Avalanche"],
"tvl": 4850120000,
"change1h": 0.15,
"change1d": -1.24,
"change7d": 4.82,
"mcap": 5920000000,
"url": "https://uniswap.org",
"twitter": "https://twitter.com/Uniswap",
"logo": "https://icons.llama.fi/uniswap.png",
"listedAt": "2020-11-04T00:00:00.000Z",
"defillamaUrl": "https://defillama.com/protocol/uniswap",
"scrapedAt": "2026-11-10T14:40:00.000Z"
}

📊 Complete Field Reference & Data Coverage

💎 Protocol Fields

FieldTypeDescriptionCoverage
nameStringOfficial protocol name🟢 High (100%)
slugStringDeFiLlama URL slug🟢 High (100%)
symbolStringNative token ticker symbol🟢 High (~85%)
categoryStringSector classification (Dexes, Lending, etc.)🟢 High (100%)
chainStringPrimary native blockchain🟢 High (100%)
chainsArrayAll deployed blockchains🟢 High (100%)
tvlNumberTotal Value Locked in USD🟢 High (100%)
change1h / change1d / change7dNumberTVL percentage delta over 1 hour, 1 day, 7 days🟢 High (~95%)
mcapNumberFully diluted token market capitalization🟡 Conditional (~70%)
urlStringOfficial protocol website link🟢 High (~98%)
twitterStringOfficial X / Twitter handle link🟢 High (~92%)
logoStringIcon image link🟢 High (~95%)
defillamaUrlStringDirect canonical link to DeFiLlama protocol page🟢 High (100%)
scrapedAtStringISO 8601 UTC timestamp🟢 High (100%)

🌾 Yield Pool Fields

FieldTypeDescriptionCoverage
projectStringProtocol hosting the pool🟢 High (100%)
chainStringBlockchain network hosting the contract🟢 High (100%)
symbolStringToken pair or single-asset ticker🟢 High (100%)
tvlUsdNumberTotal liquidity locked in the pool in USD🟢 High (100%)
apyNumberTotal annualized percentage yield🟢 High (100%)
apyBaseNumberOrganic protocol yield excluding reward incentives🟢 High (~95%)
apyRewardNumberAdditional incentive yield from reward tokens🟡 Conditional (~40%)
apyMean30dNumberHistorical 30-day moving average APY🟢 High (~90%)
stablecoinBooleanTrue if pool consists solely of pegged stable assets🟢 High (100%)
exposureStringAsset exposure structure (single or multi)🟢 High (100%)
predictedClassStringAlgorithmic APY outlook prediction🟢 High (~80%)
poolIdStringCanonical UUID of the yield pool🟢 High (100%)
scrapedAtStringISO 8601 UTC timestamp🟢 High (100%)

⛓️ Chain Fields (entityType: "chains")

FieldTypeDescriptionCoverage
nameStringBlockchain network name (e.g., Ethereum, Solana, Base)🟢 High (100%)
tvlNumberTotal cumulative value locked across all network protocols🟢 High (100%)
tokenSymbolStringNative gas token symbol (ETH, SOL, BNB)🟢 High (~90%)
chainIdNumberStandard EVM network chain ID where applicable🟡 Conditional (~70%)
geckoIdStringCoinGecko asset identifier for native gas token🟢 High (~85%)
cmcIdStringCoinMarketCap identifier🟡 Conditional (~60%)
defillamaUrlStringCanonical chain overview URL on DeFiLlama🟢 High (100%)
scrapedAtStringISO 8601 UTC timestamp🟢 High (100%)

📈 Downstream Web3 Dashboards & Pipelines

  • Google Sheets & Looker Studio: Schedule daily TVL sync runs to populate institutional executive dashboards and token research models.
  • Telegram & Discord Liquidity Bots: Connect Apify webhooks to alert trading channels when a protocol's change1d exceeds +25% or drops below -20%.
  • DeFi Yield Automation: Query yields for stablecoin pools above $10M TVL and push top opportunities into automated treasury rebalancing workflows.
  • Data Warehouses (Snowflake, BigQuery): Stream historical TVL snapshots into relational tables to perform quantitative regression against token prices.

🚀 Step-by-Step Usage Guide

1. Web Console Interface

  1. Open DeFiLlama Scraper on the Apify Console.
  2. Select your entityType (protocols, chains, or yields).
  3. Set optional filters: enter chains (e.g., Arbitrum), categories, or minTvl.
  4. Enter your desired maxItems (e.g., 1000 or 0 for all).
  5. Click Start to run the scraper and view the dataset live.

2. Python API Client

from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run_input = {
"entityType": "yields",
"chains": ["Ethereum", "Solana"],
"sortBy": "apy",
"minTvl": 5000000,
"maxItems": 500
}
run = client.actor("haketa/defillama-scraper").call(run_input=run_input)
for pool in client.dataset(run["defaultDatasetId"]).iterate_items():
print(f"🌾 {pool['project']} ({pool['chain']}) - {pool['symbol']}: {pool['apy']}% APY | TVL: ${pool['tvlUsd']:,.0f}")

3. Node.js API Client

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({
token: 'YOUR_APIFY_TOKEN',
});
const run = await client.actor('haketa/defillama-scraper').call({
entityType: 'protocols',
categories: ['Dexes'],
maxItems: 250,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Retrieved ${items.length} DEX protocols.`);

4. Direct cURL / REST API

curl -X POST "https://api.apify.com/v2/acts/haketa~defillama-scraper/runs?token=YOUR_APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"entityType": "protocols",
"categories": ["Lending"],
"maxItems": 100
}'

❓ Frequently Asked Questions (FAQ)

Do I need a DeFiLlama API key or account?

No. This actor utilizes public, keyless data feeds requiring zero API keys, credit cards, or personal registration.

How frequently is the data updated?

Data is updated in real time from live protocol contracts. Running the actor provides the most current TVL snapshots and APY calculations available on DeFiLlama.

Can I extract all 8,800+ protocols in one run?

Yes. Setting maxItems: 0 removes all item limits, streaming the complete catalog of protocols or yield pools directly into your dataset.

What does predictedClass mean in yield pools?

DeFiLlama computes machine-learning forecasts on yield persistence based on historical volume, token inflation, and TVL trends, classifying pools as Stable/Up or Down.

Can I export directly to Google Sheets or Excel?

Yes. You can export datasets in CSV or Excel formats, or configure Apify webhooks to stream new records directly into Airtable, PostgreSQL, or Google Sheets.


🔒 Data Freshness & Best Practices

To maximize the efficiency of your DeFi market data extraction:

  • Use Protocol Slugs for Granularity: If you only need deep multi-chain distribution for specific projects (e.g. lido, aave), pass protocolSlugs instead of running full catalog sweeps.
  • Set Minimum TVL Floors: Setting minTvl: 1000000 ($1M) filters out inactive or abandoned liquidity pools, keeping your datasets focused on high-liquidity markets.
  • Automate with Schedules: Schedule runs at UTC midnight to capture standardized daily closes for quantitative backtesting.

📋 Changelog

Version 1.2.0 (2026-11)

  • Deep 1,000+ Results Pagination: Unlocked full catalog ingestion with maxItems: 0 for all entities (protocols, chains, and yields).
  • Streamlined Fast Prefill: Optimized default prefill inputs to execute complete verification runs in under 15 seconds.
  • Enhanced Protocol Detail Parsing: Filtered out internal pseudo-chains (borrowed, pool2) to ensure per-chain breakdowns reflect genuine TVL allocations.
  • Output Schema Modernization: Standardized string typing and updated dataset projection views.

Version 1.1.0 (2026-10)

  • Added yield pool prediction attributes (predictedClass, predictedProbability).
  • Introduced protocol detail mode via protocolSlugs.

Version 1.0.0 (2026-10)

  • Initial release featuring protocols, chain rankings, and yield pool extraction.