DeFiLlama Scraper — TVL, Protocols, Yields, Stablecoins & Chain Data

Extract real-time DeFi market intelligence from DeFiLlama: protocol TVL rankings, yield pool APYs, stablecoin circulating supply, and per-chain breakdowns — all keyless, no API key required.

What does DeFiLlama Scraper do?

DeFiLlama Scraper connects directly to the official DeFiLlama public API (api.llama.fi, yields.llama.fi, stablecoins.llama.fi) and retrieves bulk structured data across five distinct modes. In protocols mode it fetches the complete list of thousands of DeFi protocols including TVL, 1-day and 7-day TVL changes, market cap, chain assignments, and category labels. In yields mode it pulls tens of thousands of yield pool records covering project name, chain, APY breakdowns (base vs. reward), TVL, IL risk, and stablecoin flags. In chains mode it fetches per-chain TVL snapshots. In stablecoins mode it retrieves all stablecoins with peg type, mechanism, circulating supply, previous-day circulating, and live price. In protocolDetail mode it pulls per-chain TVL history for a list of protocol slugs. No API key or login is required; data is public. Filters by chain name and minimum TVL are supported.

Who is it for?

• DeFi researchers and analysts tracking protocol TVL trends and market share over time.
• Crypto fund managers and traders monitoring yield opportunities and APY shifts across hundreds of pools.
• Data journalists building DeFi market dashboards or charts for publications.
• Developers and data engineers ingesting DeFi data into databases, warehouses, or BI tools.
• Stablecoin researchers monitoring peg stability, circulating supply changes, and depeg risk.

Use cases

• Build a TVL leaderboard dashboard updating daily to show the top 100 protocols by total value locked.
• Monitor all Ethereum yield pools above 5% APY and alert when new high-yield pools appear.
• Track stablecoin circulating supply over time to detect USDT/USDC/DAI expansion or contraction.
• Export per-chain TVL data to analyze which L2s and alt-L1s are gaining market share.
• Combine protocol TVL history with price data to compute protocol revenue and token valuation multiples.

Why use DeFiLlama Scraper?

• Keyless: No API key, no login, no credentials — just run and get data immediately.
• High volume: Thousands of rows in a single run — 3000+ protocols, 10000+ yield pools, 200+ stablecoins.
• Five modes: Protocols, yields, chains, stablecoins, and protocol detail — one actor, full DeFi coverage.
• Filtered output: Filter by chain name or minimum TVL to get only the data you care about.
• Export anywhere: Push to Google Sheets, Zapier, Make, webhooks, or download CSV/JSON/Excel.
• Pay-per-result: Apify billing is per compute unit — large runs stay cheap, no monthly quota.

What data can you extract?

Output fields

Field	Type	Description
mode	string	The scrape mode used (protocols, yields, chains, stablecoins, protocolDetail)
name	string	Protocol or asset name
symbol	string	Token symbol
slug	string	DeFiLlama URL slug (used for protocolDetail)
chain	string	Primary blockchain
chains	string	All chains (comma-separated)
category	string	Protocol category (e.g. Dexes, Lending, CDP, Bridge)
tvl	number	Total Value Locked in USD
tvlUsd	number	TVL in USD (yields and chains modes)
change1d	number	TVL or APY 1-day percentage change
change7d	number	TVL 7-day percentage change
mcap	number	Token market capitalization in USD
mcapTvl	number	Market cap / TVL ratio
url	string	Protocol official URL
description	string	Protocol description
logo	string	Protocol logo URL
pool	string	Yield pool unique ID
project	string	Yield pool project name
apy	number	Total APY percentage
apyBase	number	Base APY (from trading fees)
apyReward	number	Reward APY (from incentive tokens)
stablecoin	string	Whether the pool involves a stablecoin
ilRisk	string	Impermanent loss risk level
exposure	string	Pool exposure type (single, multi)
pegType	string	Stablecoin peg type (peggedUSD, peggedEUR, etc.)
pegMechanism	string	How the peg is maintained (algorithmic, fiat-backed, etc.)
circulating	number	Stablecoin circulating supply in USD
circulatingPrevDay	number	Circulating supply previous day
price	number	Stablecoin price in USD
fetchedAt	string	ISO timestamp of when the data was fetched

Sample output (protocols mode)

{
  "mode": "protocols",
  "name": "Aave V3",
  "symbol": "AAVE",
  "slug": "aave-v3",
  "chain": "Multi-Chain",
  "chains": "Ethereum, Arbitrum, Polygon, Optimism, Avalanche",
  "category": "Lending",
  "tvl": "15234567890",
  "tvlUsd": null,
  "change1d": "1.23",
  "change7d": "-2.45",
  "mcap": "2100000000",
  "mcapTvl": "0.1379",
  "url": "https://aave.com",
  "description": "Aave is a decentralised non-custodial liquidity protocol",
  "logo": "https://icons.llama.fi/aave-v3.png",
  "pool": null,
  "project": null,
  "apy": null,
  "apyBase": null,
  "apyReward": null,
  "stablecoin": null,
  "ilRisk": null,
  "exposure": null,
  "pegType": null,
  "pegMechanism": null,
  "circulating": null,
  "circulatingPrevDay": null,
  "price": null,
  "fetchedAt": "2026-07-08T12:00:00.000Z"
}

How to use

Option A: Scrape all protocols (bulk TVL ranking)

Set mode to protocols. Optionally filter by chain or minimum TVL. This returns thousands of rows covering every tracked DeFi protocol.

{
  "mode": "protocols",
  "chainFilter": "Ethereum",
  "minTvl": 1000000,
  "maxResults": 500
}

Option B: Get yield pools with APY

Set mode to yields to retrieve all yield pools across every protocol and chain on DeFiLlama. Filter by chain to focus on a single network.

{
  "mode": "yields",
  "chainFilter": "Arbitrum",
  "maxResults": 1000
}

Option C: Protocol detail (TVL history by chain)

Set mode to protocolDetail and provide a list of slugs. Find slugs from the protocols mode output (slug field).

{
  "mode": "protocolDetail",
  "slugs": ["aave", "uniswap-v3", "curve-dex"]
}

Option D: Stablecoins market overview

{
  "mode": "stablecoins"
}

Option E: Per-chain TVL

{
  "mode": "chains",
  "minTvl": 10000000
}

Input parameters

Parameter	Type	Default	Description
mode	string	protocols	Scrape mode: protocols, protocolDetail, chains, yields, stablecoins
slugs	array	[]	Protocol slugs for protocolDetail mode (e.g. ["aave", "uniswap"])
chainFilter	string	—	Filter by blockchain name (Ethereum, BSC, Polygon, Arbitrum, Solana…)
minTvl	integer	—	Minimum TVL in USD to include (protocols and chains modes)
maxResults	integer	0 (unlimited)	Cap output row count
proxyConfiguration	object	—	Optional Apify proxy settings

Full input example:

{
  "mode": "protocols",
  "chainFilter": "Ethereum",
  "minTvl": 5000000,
  "maxResults": 200,
  "proxyConfiguration": { "useApifyProxy": true }
}

Output example

{
  "mode": "yields",
  "name": "USDC-USDT",
  "symbol": "USDC-USDT",
  "slug": null,
  "chain": "Ethereum",
  "chains": null,
  "category": "multi",
  "tvl": "245000000",
  "tvlUsd": "245000000",
  "change1d": "0.12",
  "change7d": "-0.05",
  "mcap": null,
  "mcapTvl": null,
  "url": null,
  "description": null,
  "logo": null,
  "pool": "aa13b1c4-d3b2-4ec6-8ed8-5c1dea31efb3",
  "project": "curve",
  "apy": "4.82",
  "apyBase": "3.91",
  "apyReward": "0.91",
  "stablecoin": "true",
  "ilRisk": "no",
  "exposure": "multi",
  "pegType": null,
  "pegMechanism": null,
  "circulating": null,
  "circulatingPrevDay": null,
  "price": null,
  "fetchedAt": "2026-07-08T12:00:00.000Z"
}

Tips for best results

• Use protocols mode for market overviews: It returns the full universe of DeFi protocols sorted by TVL — ideal for dashboards and competitive analysis.
• Use yields mode for yield farming: Combine with chain filter and sort by APY in your downstream tool to find the best opportunities.
• Find slugs before using protocolDetail: Run protocols mode first, copy the slug field, then use those in protocolDetail to get historical chain breakdowns.
• Apply minTvl to reduce noise: Most protocols have negligible TVL. Setting minTvl=1000000 (1M USD) removes small projects.
• Chain names are case-insensitive: "ethereum", "Ethereum", "ETHEREUM" all work for chainFilter.
• Chain names to know: Ethereum, BSC, Polygon, Arbitrum, Optimism, Avalanche, Solana, Tron, Base, Blast.
• Max results for quick tests: Set maxResults=50 to do a fast test run before committing to a full scrape.
• Schedule with Apify Scheduler: DeFiLlama data is updated continuously — schedule this actor daily or hourly for time-series analysis.
• Export to Google Sheets: Use the Apify → Google Sheets integration for live-updating DeFi dashboards.
• Stablecoins mode for peg monitoring: Run daily and compare circulating vs circulatingPrevDay to detect supply changes.

Integrations

This actor works natively with the entire Apify ecosystem:

• Google Sheets: Use the Google Sheets integration in your actor run to write DeFi data directly to a spreadsheet for dashboards and charts.
• Slack: Set up a webhook notification to alert your Slack channel whenever a new run completes or TVL drops significantly.
• Zapier / Make: Trigger downstream automation — send TVL data to Airtable, Notion, or a CRM whenever this actor finishes.
• Webhooks: Configure a webhook on the actor run to POST result metadata to your own API endpoint.
• Schedule: Use Apify Scheduler to run this actor hourly, daily, or weekly for continuous DeFi monitoring.

API usage

cURL

curl -X POST "https://api.apify.com/v2/acts/logiover~defillama-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"protocols","minTvl":1000000,"maxResults":500}'

Node.js (Apify client)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('logiover/defillama-scraper').call({
  mode: 'yields',
  chainFilter: 'Ethereum',
  maxResults: 1000,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} yield pools`);

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")

run = client.actor("logiover/defillama-scraper").call(run_input={
    "mode": "stablecoins",
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["name"], item["circulating"])

Use with AI agents (MCP)

This actor is available as an MCP (Model Context Protocol) tool through the Apify MCP server. You can connect it to Claude, GPT-4, or any MCP-compatible agent and ask questions like: "What are the top 10 DeFi protocols by TVL on Ethereum right now?" or "Show me all yield pools with APY above 10% on Arbitrum." The agent will invoke this actor, receive the data, and synthesize an answer — no manual API calls required.

FAQ

Does this require an API key?

No. DeFiLlama provides a generous public API with no authentication required. This actor calls the official endpoints directly and returns data immediately without any setup.

How many records does a typical run return?

Protocols mode returns 3000–4000+ rows (all tracked DeFi protocols). Yields mode returns 10000+ pool records. Chains mode returns 100–200 chains. Stablecoins mode returns 150–300 assets.

What chains are covered?

DeFiLlama tracks 200+ blockchains including Ethereum, BSC, Polygon, Arbitrum, Optimism, Avalanche, Solana, Tron, Base, Blast, Mantle, Linea, zkSync, Scroll, and all major L1/L2 networks.

What happens if a field is null?

Some fields only apply to specific modes (e.g. apy only has a value in yields mode, pegType only in stablecoins). Null values indicate the field is not applicable for that record type.

Can I get historical TVL data?

Use protocolDetail mode with specific protocol slugs. This returns chain-level TVL breakdown for each requested protocol. Full historical time-series (daily TVL per date) is available in the raw API response structure.

How do I export to CSV or Excel?

After your run finishes, go to the Storage tab in the Apify Console, open the dataset, and click Download — choose CSV, JSON, XLSX, or JSONL.

How fast does it run?

Protocols mode typically completes in under 30 seconds. Yields mode with 10000+ pools runs in 30–60 seconds. The DeFiLlama API is fast and well-optimised for bulk access.

Is the data real-time?

DeFiLlama updates protocol TVL every few minutes from on-chain data. Yield pool APYs are updated approximately hourly. Stablecoin supply is updated frequently via blockchain indexing.

What if I get zero results?

First verify the chain name spelling (case-insensitive but must match DeFiLlama's naming exactly, e.g. "BSC" not "Binance"). Try removing chainFilter and minTvl to see the full dataset. For protocolDetail, ensure your slugs are correct (find them in protocols mode output).

Is this legal to use?

DeFiLlama provides a public API explicitly intended for developer and researcher access. The data is indexed from public blockchains. This actor accesses only public endpoints in the same manner as any API client. Review DeFiLlama's terms of service at defillama.com for specifics regarding your use case.

How often should I run this for monitoring?

For TVL trend analysis, daily runs are sufficient. For yield farming monitoring where APYs can shift significantly hour-to-hour, schedule runs every 1–4 hours.

Are there related scrapers?

• CoinGecko Scraper — coin prices, market cap, volume for 10000+ tokens
• CoinGecko Exchanges Scraper — CEX and DEX exchange volume data
• DexScreener Token Pairs Scraper — real-time DEX pair data and price feeds

Is it legal?

This actor accesses DeFiLlama's official public API (api.llama.fi, yields.llama.fi, stablecoins.llama.fi) which is openly available for programmatic access without authentication. All data returned by DeFiLlama originates from public blockchain ledgers. This actor does not scrape any user account data, personal information, or private endpoints. Users are responsible for ensuring their use of the extracted data complies with applicable laws and DeFiLlama's terms of service. This actor is intended for research, analytics, and informational purposes only and does not constitute financial advice.