DeFiLlama Scraper — DeFi Protocols, TVL, Chains & Yields
Pricing
from $1.50 / 1,000 results
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.
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.
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
| Capability | Feature Details |
|---|---|
| Primary Data Source | DeFiLlama — the Web3 industry's independent, gold-standard TVL and yield aggregator |
| Supported Modes | 3-in-1: Protocols (TVL & changes), Chains (ecosystem TVL rankings), and Yields (APY & pool metrics) |
| Protocol Detail Mode | Deep breakdowns by protocol slug (per-chain TVL allocations, contract audits, descriptions) |
| Total Universe | Access to 8,800+ protocols, 400+ blockchains, and 15,000+ yield farming pools |
| Scale & Pagination | Unlocked deep ingestion supporting 1,000+ to 10,000+ items per single run with zero artificial caps |
| Execution Speed | High-throughput HTTP engine: pulls and filters 1,000+ records in under 15 seconds |
| Authentication | 100% keyless, public data access; zero session cookies or wallet connections required |
| Export Formats | Clean 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.
🧭 Popular DeFi Sectors & Categories Tracked
Filter your extraction across specialized decentralized finance sectors:
| Sector Category | Key Protocols Included | Primary Metrics Analyzed |
|---|---|---|
| Dexes | Uniswap, Curve, PancakeSwap, Raydium | Spot volume, LP pool TVL, token fee generation |
| Lending | Aave, Compound, Morpho, Spark | Borrowed amounts, collateralization, supply APY |
| Liquid Staking | Lido, Rocket Pool, Jito, Marinade | Staked ETH/SOL TVL, consensus validation yields |
| Restaking | EigenLayer, Symbiotic, Karak | Delegated restaking TVL, operator coverage |
| CDP & Stablecoins | Maker/Sky, Ethena, Liquity | Backing asset reserves, synthetic debt issuance |
| Yield & Aggregators | Pendle, Yearn Finance, Convex | Multi-tier yield vaults, principal token splits |
| RWA (Real World Assets) | Ondo Finance, Maple, Centrifuge | Tokenized 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: 0removes 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 (
predictedClassandpredictedProbability) 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
| Feature | DeFiLlama Scraper | Manual Dashboard Copying | Generic Scraping Tools |
|---|---|---|---|
| Coverage | 8,800+ protocols, 15,000+ pools | ~10-20 items per session | Stalls on large JSON payloads |
| Execution Time | 5-15 seconds | Hours of manual spreadsheet entry | Often times out |
| Yield APY Metrics | Base + Reward + 30d Mean APY | Usually records only headline APY | Misses nested reward breakdowns |
| Per-Chain Breakdowns | Cleanly parsed array of TVLs | Cumbersome tab clicking | Fails to filter pseudo-chains |
| Update Frequency | Fully automated on schedule | Manual labor required | High maintenance overhead |
| Export Options | JSON, CSV, Excel, REST API | Manual file export | Single format export |
📥 Input Parameters
All parameters are optional. Running with default parameters fetches the top protocols globally ranked by TVL.
| Parameter | Type | Default | Description |
|---|---|---|---|
entityType | String | "protocols" | Target entity: "protocols" (TVL), "chains" (ecosystem TVL), or "yields" (APY pools). |
searchTerms | Array | [] | Filter by protocol name, token symbol, or yield project name. |
chains | Array | [] | Filter by blockchain (e.g., ["Ethereum", "Arbitrum", "Solana"]). |
categories | Array | [] | Filter protocols by sector (e.g., ["Dexes", "Lending", "Liquid Staking"]). |
protocolSlugs | Array | [] | Specific slugs for deep inspection (e.g., ["lido", "aave", "uniswap"]). |
minTvl | Integer | 0 | Minimum TVL in USD threshold (0 = no minimum). |
sortBy | String | "tvl" | Sort criteria for yields: "tvl" or "apy". Protocols and chains always sort by TVL. |
maxItems | Integer | 0 | Maximum items to return (0 = unlimited, all available entries). |
proxyConfiguration | Object | { "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
| Field | Type | Description | Coverage |
|---|---|---|---|
name | String | Official protocol name | 🟢 High (100%) |
slug | String | DeFiLlama URL slug | 🟢 High (100%) |
symbol | String | Native token ticker symbol | 🟢 High (~85%) |
category | String | Sector classification (Dexes, Lending, etc.) | 🟢 High (100%) |
chain | String | Primary native blockchain | 🟢 High (100%) |
chains | Array | All deployed blockchains | 🟢 High (100%) |
tvl | Number | Total Value Locked in USD | 🟢 High (100%) |
change1h / change1d / change7d | Number | TVL percentage delta over 1 hour, 1 day, 7 days | 🟢 High (~95%) |
mcap | Number | Fully diluted token market capitalization | 🟡 Conditional (~70%) |
url | String | Official protocol website link | 🟢 High (~98%) |
twitter | String | Official X / Twitter handle link | 🟢 High (~92%) |
logo | String | Icon image link | 🟢 High (~95%) |
defillamaUrl | String | Direct canonical link to DeFiLlama protocol page | 🟢 High (100%) |
scrapedAt | String | ISO 8601 UTC timestamp | 🟢 High (100%) |
🌾 Yield Pool Fields
| Field | Type | Description | Coverage |
|---|---|---|---|
project | String | Protocol hosting the pool | 🟢 High (100%) |
chain | String | Blockchain network hosting the contract | 🟢 High (100%) |
symbol | String | Token pair or single-asset ticker | 🟢 High (100%) |
tvlUsd | Number | Total liquidity locked in the pool in USD | 🟢 High (100%) |
apy | Number | Total annualized percentage yield | 🟢 High (100%) |
apyBase | Number | Organic protocol yield excluding reward incentives | 🟢 High (~95%) |
apyReward | Number | Additional incentive yield from reward tokens | 🟡 Conditional (~40%) |
apyMean30d | Number | Historical 30-day moving average APY | 🟢 High (~90%) |
stablecoin | Boolean | True if pool consists solely of pegged stable assets | 🟢 High (100%) |
exposure | String | Asset exposure structure (single or multi) | 🟢 High (100%) |
predictedClass | String | Algorithmic APY outlook prediction | 🟢 High (~80%) |
poolId | String | Canonical UUID of the yield pool | 🟢 High (100%) |
scrapedAt | String | ISO 8601 UTC timestamp | 🟢 High (100%) |
⛓️ Chain Fields (entityType: "chains")
| Field | Type | Description | Coverage |
|---|---|---|---|
name | String | Blockchain network name (e.g., Ethereum, Solana, Base) | 🟢 High (100%) |
tvl | Number | Total cumulative value locked across all network protocols | 🟢 High (100%) |
tokenSymbol | String | Native gas token symbol (ETH, SOL, BNB) | 🟢 High (~90%) |
chainId | Number | Standard EVM network chain ID where applicable | 🟡 Conditional (~70%) |
geckoId | String | CoinGecko asset identifier for native gas token | 🟢 High (~85%) |
cmcId | String | CoinMarketCap identifier | 🟡 Conditional (~60%) |
defillamaUrl | String | Canonical chain overview URL on DeFiLlama | 🟢 High (100%) |
scrapedAt | String | ISO 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
change1dexceeds +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
- Open DeFiLlama Scraper on the Apify Console.
- Select your
entityType(protocols,chains, oryields). - Set optional filters: enter
chains(e.g.,Arbitrum),categories, orminTvl. - Enter your desired
maxItems(e.g.,1000or0for all). - Click Start to run the scraper and view the dataset live.
2. Python API Client
from apify_client import ApifyClientclient = 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), passprotocolSlugsinstead 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: 0for 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.