DefiLlama Scraper This Actor scrapes data from DefiLlama, a popular DeFi analytics platform. It extracts detailed information about blockchains, protocols, DEXes, fees, and stablecoins. ## Features - Scrapes comprehensive data from DefiLlama - Configurable options to collect different types of data: - Blockchain/chain data - DeFi protocols - Decentralized exchanges (DEXes) - Fee metrics - Stablecoin information - Extracts key metrics and statistics for each data type - Configurable maximum number of items to scrape - Data saved in structured format for easy analysis Note: Chain/blockchain data is always scraped as the baseline functionality. Additional data types (protocols, DEXes, fees, stablecoins) are scraped based on the input parameters you enable. Each additional data type will include chain-specific information when available, providing a comprehensive view of the DeFi ecosystem across different blockchains. ## Input parameters The input schema for this Actor supports the following parameters: | Field | Type | Description | | ------------------- | ------- | ---------------------------------------------------------------------- | | maxChains | integer | Maximum number of chains to scrape . Default is 100. | | scrapeProtocols | boolean | Whether to scrape protocol data. Default is false. | | scrapeDexes | boolean | Whether to scrape DEX (decentralized exchange) data. Default is false. | | scrapeFees | boolean | Whether to scrape fee data for various protocols. Default is false. | | scrapeStablecoins | boolean | Whether to scrape stablecoin data. Default is false. | Note: Chain/blockchain data is always collected regardless of these settings. The above options determine what additional data types will be scraped on top of the baseline chain data. ## Expected Cost This Actor uses a Pay-Per-Event (PPE) pricing model, which means you are charged based on the specific data elements scraped rather than compute time. Costs are transparent and proportional to the amount of data collected. ### Pricing Structure | Event Type | Description | Price (USD) | | --------------------- | ---------------------------------------- | ----------- | | Actor start | Flat fee for starting the Actor | $0.005 | | Chain data scraped | Cost per chain successfully scraped | $0.005 | | DeFi protocol scraped | Cost per protocol successfully scraped | $0.0002 | | Stablecoin scraped | Cost per stablecoin successfully scraped | $0.0002 | | Fee data scraped | Cost per protocol fee data scraped | $0.0002 | | DEX scraped | Cost per decentralized exchange scraped | $0.0002 | ### Cost Scenarios #### Default Run (20 Chains, No Additional Data Types) By default, the Actor scrapes 20 chains with the highest TVL, with no additional data types: - Actor start: 1 × $0.005 = $0.005 - Chain data: 20 × $0.005 = $0.100 - Total estimated cost: $0.105 #### Full Run (100 Chains, All Data Types) For a comprehensive run with all data types enabled and 100 chains: - Actor start: 1 × $0.005 = $0.005 - Chain data: 100 × $0.005 = $0.500 - Protocol data: ~5,000 × $0.0002 = $1.000 - DEX data: ~850 × $0.0002 = $0.170 - Fee data: ~1,600 × $0.0002 = $0.320 - Stablecoin data: ~600 × $0.0002 = $0.120 - Total estimated cost: $2.115 This full run will generate approximately 6.5 MB of rich, structured data covering the entire DeFi ecosystem, making it an extremely cost-effective method to obtain comprehensive market intelligence. Note: The exact number of protocols, DEXes, fees, and stablecoins can vary as the DeFi ecosystem changes. The estimates above represent approximate values based on recent data. The actual cost will depend on the exact number of items scraped during your run. ## Output data structure The Actor stores data according to the enabled options. Below are examples of the data structure for each option: ### Chain Data (always collected) Blockchain/chain data is always collected regardless of other settings: json { "name": "Ethereum", "tvl": 100552951726, "tvlPrevDay": 98984283644, "tvlPrevWeek": 91006653090, "tvlPrevMonth": 103526825151, "mcap": 217180928702.0885, "mcaptvl": 2.1598662692060184, "symbol": "ETH", "protocols": 1331, "extraTvl": { "doublecounted": { "tvl": 41339177591.138985, "tvlPrevDay": 40638756027.070045, "tvlPrevWeek": 37214573443.70721, "tvlPrevMonth": 42009540776.8698 }, "liquidstaking": { "tvl": 24853963415.932278, "tvlPrevDay": 24256723968.737305, "tvlPrevWeek": 21805367390.43567, "tvlPrevMonth": 27065548498.8816 }, "dcandlsoverlap": { "tvl": 17024399642.365578, "tvlPrevDay": 16542240755.342825, "tvlPrevWeek": 14947560913.36731, "tvlPrevMonth": 18727442344.684944 }, "staking": { "tvl": 4445776883.867957, "tvlPrevDay": 4123088900.2378244, "tvlPrevWeek": 3623716403.309066, "tvlPrevMonth": 4166460407.4565616 }, "excludeparent": { "tvl": 2126424579.0037584, "tvlPrevDay": 2113977055.2102487, "tvlPrevWeek": 1999413312.309705, "tvlPrevMonth": 2142844273.4384265 }, "borrowed": { "tvl": 15972860054.698555, "tvlPrevDay": 15753402274.323843, "tvlPrevWeek": 14882014120.986639, "tvlPrevMonth": 16082441049.557865 }, "vesting": { "tvl": 425635701.11098516, "tvlPrevDay": 390408678.12103724, "tvlPrevWeek": 352409011.0396751, "tvlPrevMonth": 281263202.34101504 }, "pool2": { "tvl": 87937381.29142818, "tvlPrevDay": 85975483.84500602, "tvlPrevWeek": 82308666.34883396, "tvlPrevMonth": 91189843.14718029 } }, "change_1d": 1.5847647972497962, "change_7d": 10.489671152458817, "change_1m": -2.8725631455059397, "nftVolume": 2509182.7, "totalVolume24h": 1441110450, "totalFees24h": 400422, "totalRevenue24h": 102394, "stablesMcap": 125085530762.5843, "users": 325670, "totalAppRevenue24h": 1019584 } ### Protocol Data (scrapeProtocols = true) When scrapeProtocols is enabled, the actor will extract comprehensive protocol information: json { "name": "Lido", "slug": "lido", "chains": ["Ethereum", "Terra", "Solana", "Moonriver", "Moonbeam", "Terra Classic"], "category": "Liquid Staking", "tvl": { "default": { "tvl": 17024254048.609468, "tvlPrevDay": 16542096625.940102, "tvlPrevWeek": 14947431575.522327, "tvlPrevMonth": 18727270345.652336 }, "doublecounted": { "tvl": 17024254048.609468, "tvlPrevDay": 16542096625.940102, "tvlPrevWeek": 14947431575.522327, "tvlPrevMonth": 18727270345.652336 }, "liquidstaking": { "tvl": 17024254048.609468, "tvlPrevDay": 16542096625.940102, "tvlPrevWeek": 14947431575.522327, "tvlPrevMonth": 18727270345.652336 } }, "tvlChange": { "change1d": 2.914729816734857, "change7d": 13.89417615055761, "change1m": -9.093777499923979 }, "mcap": 802690019.8603034, "mcaptvl": 0.05, "strikeTvl": true, "fees": { "total24h": 1385834, "total7d": 9578904, "total30d": 43309980, "total1y": 932705548, "average1y": 2555357.6657534246, "totalAllTime": 2363225616, "pf": 1.54 }, "revenue": { "total24h": 138583, "total7d": 957889, "total30d": 4330994, "total1y": 93270542, "average1y": 255535.73150684932, "totalAllTime": 236322562, "ps": 15.44 } } ### DEX Data (scrapeDexes = true) When scrapeDexes is enabled, the actor will extract detailed information about decentralized exchanges: json { "total24h": 112017096, "total48hto24h": 198928137, "total7d": 1312524427, "total14dto7d": 1250979558, "total30d": 6454925870, "total60dto30d": 6980951660, "total1y": 96247622419, "totalAllTime": 231794888476, "average1y": 263692116.21643835, "total7DaysAgo": 102052081, "total30DaysAgo": 310029587, "change_1d": -43.69, "change_7d": 9.76, "change_1m": -63.87, "change_7dover7d": 4.92, "change_30dover30d": -7.54, "defillamaId": "3", "name": "Curve DEX", "displayName": "Curve DEX", "module": "curve", "category": "Dexs", "logo": "https://icons.llamao.fi/icons/protocols/curve", "chains": [ "Ethereum", "Polygon", "Fantom", "Arbitrum", "Avalanche", "OP Mainnet", "Gnosis", "Fraxtal", "Base" ], "protocolType": "protocol", "methodologyURL": "https://github.com/DefiLlama/dimension-adapters/blob/master/dexs/curve", "methodology": { "UserFees": "Swap fees paid by users", "Fees": "Swap fees paid by users", "Revenue": "Percentage of swap fees going to treasury and/or token holders" }, "latestFetchIsOk": true, "parentProtocol": "parent#curve-finance", "slug": "curve-dex", "linkedProtocols": ["Curve Finance", "Curve DEX"], "tvl": 1560101391.3143232, "dominance": 7.755808992758276, "volumetvl": 0.07180116409333502 } ### Fees Data (scrapeFees = true) When scrapeFees is enabled, the actor will extract comprehensive fee information for protocols: json { "name": "WBTC", "displayName": "WBTC", "id": "2", "defillamaId": "2", "slug": "wbtc", "module": "wbtc", "category": "Bridge", "protocolType": "protocol", "chains": ["Ethereum"], "logo": "https://icons.llamao.fi/icons/protocols/wbtc", "total24h": 0, "total48hto24h": 0, "total7d": 0, "total14dto7d": 17038, "total30d": 17038, "total60dto30d": 39049, "total1y": 3674080, "totalAllTime": 16252526, "average1y": 10065.972602739726, "total7DaysAgo": 17021, "total30DaysAgo": 0, "change_7d": -100, "change_7dover7d": -100, "change_30dover30d": -56.37, "revenue24h": 0, "revenue7d": 0, "revenue30d": 17038, "revenue1y": 3674080, "averageRevenue1y": 10065.972602739726, "tvl": null, "dominance": 0, "mcap": null, "pf": null, "ps": null, "methodologyURL": "https://github.com/DefiLlama/dimension-adapters/blob/master/fees/wbtc", "methodology": {}, "latestFetchIsOk": true } ### Stablecoin Data (scrapeStablecoins = true) When scrapeStablecoins is enabled, the actor will extract detailed information about stablecoins: json { "name": "Tether", "symbol": "USDT", "price": 1, "circulating": 63778496398.21153, "chains": [ "Tron", "Ethereum", "BSC", "Solana", "TON", "Polygon", "Arbitrum", "Avalanche", "Aptos", "Near" // Additional chains truncated for brevity ], "change_1d": 0.5335217996987016, "change_7d": 0.49677077358297156, "change_1m": -3.746626034265764, "mcap": 63804420318.6, "gecko_id": "tether", "pegType": "peggedUSD", "pegMechanism": "fiat-backed", "pegDeviation": 0, "pegDeviation_1m": 0.09999999999998899, "change_1d_nol": "+$338.6m", "change_7d_nol": "+$315.39m", "change_1m_nol": "-$2.484b", "circulatingPrevDay": 63465816352.640236, "circulatingPrevWeek": 63490676153.58016, "circulatingPrevMonth": 66327580718.75613 } ## Important Notes Warning: This actor returns raw data from DefiLlama, which can be quite extensive, especially when multiple options are enabled. When working with all data types, be prepared to handle large JSON responses that could be several megabytes in size. ## Data uses The data extracted by this Actor can be used for: - DeFi market analysis and research - TVL (Total Value Locked) tracking across protocols and chains - Comparing DEX volumes and performance metrics - Fee analysis across different DeFi platforms - Stablecoin market analysis and stability monitoring - Investment research and decision making - Building comprehensive DeFi analytics dashboards - Academic research on decentralized finance ## Feature requests and bug reports If you need additional data from DefiLlama that is not currently being scraped by this Actor or want to request any additional feature, please open an issue in the Apify platform. Describe the specific data points you need and their location on the website, and we'll consider implementing these features in future updates. Similarly, if you encounter any bugs or issues while using this Actor, please report them through the issue tracker with detailed steps to reproduce. ### Additional Data Types Available On Request DefiLlama offers many more data categories that could be added to this Actor based on user demand. If you need any of the following data types, please open an issue: - Oracles - Airdrops - Forks - NFT collections and marketplaces - Yields - Unlocks - Hacks - Fundraising rounds - Bridges - Options Or any other data category available on DefiLlama that isn't currently included. When requesting additional data types, please specify the exact metrics you need. ## Support the project If you find this Actor useful, please consider: - Rating it on the Apify platform - Writing a review about your experience Your feedback helps improve the Actor and guides future development priorities.