DeFi Scraper — TVL, Yields, Chains & Stablecoins

Scrape DeFi market data from DefiLlama — the reference source for on-chain value — across four datasets: 8,400+ protocols with TVL, 16,000+ yield pools with APY, 460+ chains, and 400+ stablecoins with supply and peg data.

No API key required.

Four datasets, one actor

Mode	Records	What it answers
Protocols	~8,400	Where is the money, by protocol and category, and which way is it moving
Yield pools	~17,000	What can I earn, at what TVL, base vs reward APY, and how risky
Chains	~470	How much value each chain holds
Stablecoins	~430	Supply, peg mechanism, price, and growth by chain

What you get — protocols

Field	Description
name, slug, symbol	Protocol identity
category	Dexes, Lending, Liquid Staking, CEX, Bridge…
chain, chains, chainCount	Primary chain and every chain it runs on
tvlUsd	Total value locked
change1h, change1d, change7d	TVL momentum in percent
marketCapUsd, mcapToTvl	Token market cap and the mcap/TVL ratio — the standard cheap-or-expensive screen
audits	Audit status, with 0 reported as none
description, website, twitter, logo	Profile data
listedAt	When DefiLlama first listed it — useful for spotting new protocols

What you get — yield pools

Field	Description
project, chain, symbol, poolMeta	Which pool, where
tvlUsd	Pool size
apy	Total APY
apyBase vs apyReward	Organic yield vs token emissions — the single most important distinction in yield farming
apyMean30d	30-day mean, far more honest than a spot number
apyChange1d/7d/30d	Whether the yield is decaying
isStablecoin, impermanentLossRisk, exposure	Risk shape
volumeUsd1d, volumeUsd7d	Trading volume behind fee yield
isOutlier	DefiLlama's own flag for statistically implausible APY
predictedDirection, predictedProbability	DefiLlama's APY outlook

Example input

{
  "dataType": "yields",
  "chain": "Ethereum",
  "stablecoinPoolsOnly": true,
  "minTvlUsd": 5000000,
  "minApy": 5,
  "maxItems": 100
}

Screen protocols by category:

{ "dataType": "protocols", "category": "Lending", "minTvlUsd": 100000000 }

Track stablecoin supply:

{ "dataType": "stablecoins", "minTvlUsd": 1000000000 }

Example output

{
  "dataType": "pool",
  "project": "lido",
  "chain": "Ethereum",
  "symbol": "STETH",
  "tvlUsd": 26335491213,
  "apy": 2.245,
  "apyBase": 2.245,
  "apyReward": null,
  "apyMean30d": 2.31,
  "isStablecoin": false,
  "impermanentLossRisk": "no",
  "exposure": "single",
  "isOutlier": false,
  "url": "https://defillama.com/yields/pool/747c1d2a-c668-4682-b9f9-296708a3dd90"
}

Who uses this

• Yield aggregators and dashboards — a complete pool universe with base/reward split, refreshed on a schedule
• Crypto funds and analysts — TVL flows by category and chain, and mcap/TVL screens
• Risk teams — exposure type, impermanent-loss risk and outlier flags before allocating
• Research and newsletters — 7-day TVL movers, new protocol listings, stablecoin supply shifts
• Treasury management — where large stablecoin yields actually exist at a given TVL floor
• Chain ecosystem teams — benchmark your chain's TVL and protocol mix against competitors

Things worth knowing

• Results are sorted largest-first before maxItems is applied, so a run of 50 gives you the 50 biggest matches, not an arbitrary slice.
• apyReward is the number to be suspicious of. A 40% APY that is all rewards is a token-emission subsidy that can stop at any time; apyBase is fee-derived yield. apyMean30d and apyChange30d tell you whether it is already decaying.
• Outlier pools are excluded by default. DefiLlama flags pools whose reported APY is statistically implausible; these are usually broken or manipulated. Turn the filter off if you want to see them.
• Filters match exactly, using DefiLlama's own spelling — Ethereum, not ethereum or ETH; Dexes, not DEX. The actor tells you when everything was filtered out so a typo does not look like an empty market.
• These payloads are large — the protocol list is ~9 MB and the yield list ~12 MB. The actor requests them compressed and filters server-side data locally; expect a few seconds of download on the yields mode.
• TVL is a point-in-time snapshot at run time, not a historical series. Schedule the actor to build your own time series.

Pricing

Pay per result. Each protocol, pool, chain or stablecoin returned counts as one result, and all filters are applied before charging — so a tight screen over 17,000 pools bills only for the handful that match.

Notes

• Data comes from DefiLlama's public API.
• Nothing here is financial advice, and APY figures are the protocol's own reporting as DefiLlama collects it.
• This is an unofficial actor and is not affiliated with DefiLlama.