# DefiLlama (`real1ty/defillama`) Actor This Actor scrapes data from DefiLlama, a popular DeFi analytics platform. It extracts detailed information about blockchains, protocols, DEXes, fees, and stablecoins. - **URL**: https://apify.com/real1ty/defillama.md - **Developed by:** [Real1ty](https://apify.com/real1ty) (community) - **Categories:** Developer tools, Automation - **Stats:** 47 total users, 1 monthly users, 0.0% runs succeeded, 3 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## DefiLlama Scraper This Actor scrapes data from [DefiLlama](https://defillama.com/), 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. # Actor input Schema ## `maxChains` (type: `integer`): Maximum number of chains to scrape. ## `scrapeProtocols` (type: `boolean`): Whether to scrape protocol data for each chain from DefiLlama. ## `scrapeDexes` (type: `boolean`): Whether to scrape DEX (decentralized exchange) data for each chain. ## `scrapeFees` (type: `boolean`): Whether to scrape fee data for each chain. ## `scrapeStablecoins` (type: `boolean`): Whether to scrape stablecoin data for each chain. ## Actor input object example ```json { "maxChains": 20, "scrapeProtocols": false, "scrapeDexes": false, "scrapeFees": false, "scrapeStablecoins": false } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("real1ty/defillama").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("real1ty/defillama").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call real1ty/defillama --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=real1ty/defillama", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "DefiLlama", "description": "This Actor scrapes data from DefiLlama, a popular DeFi analytics platform. It extracts detailed information about blockchains, protocols, DEXes, fees, and stablecoins.", "version": "0.0", "x-build-id": "Bu2823pPskcBxZT1b" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/real1ty~defillama/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-real1ty-defillama", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/real1ty~defillama/runs": { "post": { "operationId": "runs-sync-real1ty-defillama", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/real1ty~defillama/run-sync": { "post": { "operationId": "run-sync-real1ty-defillama", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "maxChains": { "title": "Maximum Chains", "type": "integer", "description": "Maximum number of chains to scrape.", "default": 20 }, "scrapeProtocols": { "title": "Scrape Protocols", "type": "boolean", "description": "Whether to scrape protocol data for each chain from DefiLlama.", "default": false }, "scrapeDexes": { "title": "Scrape DEXes", "type": "boolean", "description": "Whether to scrape DEX (decentralized exchange) data for each chain.", "default": false }, "scrapeFees": { "title": "Scrape Fees", "type": "boolean", "description": "Whether to scrape fee data for each chain.", "default": false }, "scrapeStablecoins": { "title": "Scrape Stablecoins", "type": "boolean", "description": "Whether to scrape stablecoin data for each chain.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```