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:

{
    "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:

{
    "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:

{
    "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:

{
    "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:

{
    "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.