DefiLlama Scraper

Pull DeFi metrics from DefiLlama's public APIs — protocols, TVL, stablecoins, yield pools, DEX volumes, lending markets, fees, bridge volumes, and current token prices. No auth, no proxy, no cookies required.

Quick Start

{
  "mode": "protocols",
  "minTvlUsd": 1000000,
  "category": "Lending",
  "maxItems": 20
}

Modes

Mode	What it does	Key inputs
protocols	Every DeFi protocol with current TVL, chain breakdown, market cap, FDV, 1h/1d/7d change	category, minTvlUsd
byProtocol	Summary + full historical TVL series for one protocol	protocolSlug
tvl	Current TVL by chain (all chains)	chain, minTvlUsd
historicalChainTvl	Daily TVL series for one chain	chain
stablecoins	Every stablecoin with circulating supply, peg type, chains, current price	stablecoinIncludePrices
stablecoinChains	Aggregate stablecoin circulating supply per chain	—
stablecoinPrices	Historical price series for one stablecoin	stablecoinId
yields	Every yield pool with APY, TVL, project, chain, IL risk	chain, minTvlUsd
yieldsByPool	Historical APY + TVL for one pool	poolId
dexVolumes	DEX overview — every DEX with 24h/7d/30d/all-time volume	—
dexByProtocol	Summary + daily-volume history for one DEX	protocolSlug
lendingMarkets	Lending overview — every lending protocol with totals	—
lendingByProtocol	Summary + daily-volume history for one lending protocol	protocolSlug
fees	Protocol fees & revenue overview	—
bridges	Cross-chain bridge volumes (24h/7d/30d, daily txs)	—
bridgeByName	Daily volume history for one bridge	bridgeName
currentPrices	Current USD prices for tokens (DefiLlama coin ID format)	tokenIds
byUrl	Auto-detect mode from any defillama.com URL	url

Sample record (mode=protocols)

{
  "recordType": "protocol",
  "name": "Aave",
  "slug": "aave",
  "symbol": "AAVE",
  "url": "https://aave.com",
  "logo": "https://icons.llama.fi/aave.png",
  "chains": ["Ethereum", "Polygon", "Avalanche", "Optimism", "Arbitrum"],
  "category": "Lending",
  "tvlUsd": 12345678901.23,
  "chainTvls": {"Ethereum": 10000000000, "Polygon": 1000000000},
  "change1d": -1.2,
  "change7d": 5.7,
  "marketCapUsd": 999000000,
  "fullyDilutedValuationUsd": 1500000000,
  "defillamaUrl": "https://defillama.com/protocol/aave",
  "scrapedAt": "2026-05-09T12:00:00+00:00"
}

Token IDs for currentPrices

DefiLlama uses a <source>:<id> format:

• coingecko:bitcoin, coingecko:ethereum
• ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 (USDC on mainnet)
• bsc:0x55d398326f99059ff775485246999027b3197955 (USDT on BSC)
• arbitrum:0xff970a61a04b1ca14834a43f5de4533ebddb5cc8 (USDC on Arbitrum)

Up to 100 IDs per call.

FAQ

Do I need an API key? No. All endpoints used by this actor are public. Heavy traffic may hit DefiLlama's rate limits — the actor honors Retry-After headers and uses exponential backoff.

How do I find the right protocolSlug / chain / bridgeName / poolId? Browse defillama.com, copy any URL you see, and use mode=byUrl to auto-detect everything. Or paste the slug from the URL directly into protocolSlug.

Why don't I see TVL series with mode=protocols? The protocols endpoint returns current TVL only (with 1h/1d/7d change). For full historical TVL, use mode=byProtocol with a protocolSlug — that returns the entire TVL time series since the protocol launched.

Some chains show "0" TVL — why? DefiLlama's "all-chain" totals include chainTvls that distinguish staked, borrowed, and pooled TVL. Entries with 0 are stripped from output to keep records clean.

Can I filter by chain inside mode=protocols? Use the chain dropdown — but for chain-specific TVL series, mode=historicalChainTvl is faster and more accurate.

What's the rate limit? DefiLlama's public API doesn't publish a hard limit but recommends ~300 req/min. The actor paces itself with exponential backoff.

Limitations

• bridges and bridgeByName now require a paid DefiLlama plan (the public bridges.llama.fi endpoint was migrated behind their subscription wall in 2025). The actor still ships these modes — they soft-fail with a clean set_status_message pointing users at https://defillama.com/subscription. Every other mode remains free.
• DefiLlama merges some legacy / forked protocols under a parent record — the slug is authoritative.
• currentPrices confidence scores are upstream-provided; tokens with confidence < 0.5 may be stale.
• tokenIds cap is 100 per call; for larger lists, run multiple calls.
• Stablecoin pegType is a free-text upstream field; new pegs may appear that aren't yet in the canonical set.

Output schema

Every record carries recordType and scrapedAt, plus mode-specific fields. Empty / null fields are stripped before push (no null, "", [], {} in the dataset).

URL fields

Every record includes a verified defillamaUrl pointing to the canonical DefiLlama page for the entity (/protocol/, /chain/, /stablecoin/, /yields/pool/). Note that defillama.com is fronted by Cloudflare, which 403s default-curl requests; visit in a browser (or send a normal browser User-Agent) for HTML rendering. Logo / icon URLs (icons.llamao.fi, icons.llama.fi) are 200 from any client without anti-bot protection.