DeFi Protocols TVL & Yield Scraper

Here is one real result, with every field the actor returns in protocols mode (chains trimmed to the first 6 of 11 for length; all other values are exactly as returned):

{
  "name": "PancakeSwap AMM",
  "slug": "pancakeswap-amm",
  "category": "Dexs",
  "symbol": "CAKE",
  "tokenAddress": "bsc:0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82",
  "chains": ["Binance", "Ethereum", "Aptos", "zkSync Era", "Base", "Arbitrum"],
  "chainCount": 11,
  "tvl": 1733995842.0122418,
  "change1d": 2.54,
  "change7d": 2.33,
  "change1h": -0.12,
  "staking": 37252823.87,
  "pool2": null,
  "mcap": null,
  "mcaptvl": null,
  "chainTvl": {
    "Binance": 1730695097.32,
    "Ethereum": 1345223.01,
    "Aptos": 896771.49,
    "Base": 345865.5,
    "zkSync Era": 363970.37,
    "Arbitrum": 203348.37,
    "staking": 37252823.87
  },
  "audits": 2,
  "auditLinks": ["https://docs.pancakeswap.finance/#is-it-safe"],
  "oracles": null,
  "governanceIds": null,
  "github": null,
  "tags": ["AMM"],
  "parentProtocol": "pancakeswap",
  "forkedFrom": null,
  "rugged": null,
  "deprecated": null,
  "deadUrl": null,
  "deadFrom": null,
  "url": "https://pancakeswap.finance/",
  "twitter": "https://twitter.com/PancakeSwap",
  "geckoId": null,
  "cmcId": null,
  "listedAt": null,
  "description": "The #1 AMM and yield farm on Binance Smart Chain",
  "logo": "https://icons.llamao.fi/icons/protocols/pancakeswap-amm",
  "aiSummary": "PancakeSwap is a leading automated market maker (AMM) and yield farming platform primarily operating on the Binance Smart Chain, with a total value locked (TVL) of approximately $1.73 billion.",
  "aiRiskFlags": [],
  "aiRiskLevel": "low",
  "source": "DefiLlama",
  "observedAt": "2026-08-14T07:10:15.564Z"
}

The most complete DeFi protocols scraper available. It returns every field DefiLlama exposes for each protocol, including TVL, per-chain TVL, momentum, audits, tokens and links, plus opt-in AI summaries and risk red-flags, and gives you category, chain, minimum-TVL and sort filters across three modes (protocols, chains, and yield pools).

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor reads DeFi data from DefiLlama in one of three modes. protocols returns DeFi protocols with TVL, per-chain TVL, momentum (1h/1d/7d change), category, audits, tokens and links. chains returns total value locked per blockchain. yields returns liquidity pools with APY. Filters for category (or project in yields mode), chain, minimum TVL and sort order narrow the results, sorted by TVL or by momentum. Missing source values are returned as null, never invented.

Two opt-in AI add-ons (protocols mode only) attach a plain-English protocol summary and DeFi due-diligence risk red-flags (rugged, deprecated, unaudited, forked, sharp TVL drop) with an overall risk level. They are off by default and only run for paying Apify users.

Quickstart

Open the actor, paste this into the input, and press Run. It returns the two largest DEX protocols above 1M TVL, with AI summary and risk.

{
  "mode": "protocols",
  "category": "dexs",
  "maxProtocols": 2,
  "minTvl": 1000000,
  "sort": "tvl",
  "withSummary": true,
  "withRisk": true
}

Switch mode to chains for per-blockchain TVL or yields for pools with APY. Default maxProtocols is 10.

Input reference

Field	Type	Required	Default	Description
maxProtocols	integer	no	10	Maximum number of records to collect.
mode	enum	no	protocols	What to collect: protocols (TVL, category, chains), chains (TVL per blockchain), or yields (pools with APY).
category	string	no	(empty)	In protocols mode keep only one category (for example Dexes, Lending, Liquid Staking, CDP). In yields mode keep only one project (for example aave-v3, lido).
chain	string	no	(empty)	Keep only protocols, pools or the chain matching this blockchain (for example Ethereum, Solana, Base, Arbitrum).
minTvl	integer	no	(none)	Keep only records whose total value locked is at least this many US dollars.
sort	enum	no	tvl	Order by tvl (highest first) or change (biggest 1-day change / APY move first).
withSummary	boolean	no	false	Paid add-on (protocols mode). AI plain-English overview of each protocol. Billed per summary. Disabled on free plans.
withRisk	boolean	no	false	Paid add-on (protocols mode). AI due-diligence red flags and overall risk level. Billed per analysis. Disabled on free plans.

Output reference

One dataset item per record. The fields below cover protocols mode; chains and yields modes return their own record shapes. Types: string, number, integer, boolean, string[], object, or null when the source value is absent.

Field	Type	Description
name	string	Protocol name.
slug	string	DefiLlama protocol slug.
category	string	Protocol category, for example Dexs, Lending.
symbol	string	Governance/token symbol, else null.
tokenAddress	string	Token contract address (chain-prefixed), else null.
chains	string[]	Blockchains the protocol operates on.
chainCount	integer	Number of chains.
tvl	number	Total value locked in USD.
change1d	number	1-day TVL change percentage.
change7d	number	7-day TVL change percentage.
change1h	number	1-hour TVL change percentage.
staking	number	Value staked in the protocol's own token, else null.
pool2	number	Pool2 liquidity value, else null.
mcap	number	Market cap in USD, else null.
mcaptvl	number	Market cap to TVL ratio, else null.
chainTvl	object	TVL per chain as {chain: usd}.
audits	integer	Audit count indicator.
auditLinks	string[]	Links to audit reports.
oracles	string[]	Oracles used, else null.
governanceIds	string[]	Governance identifiers, else null.
github	string[]	GitHub org handles, else null.
tags	string[]	Protocol tags.
parentProtocol	string	Parent protocol slug, else null.
forkedFrom	string[]	Protocols this one was forked from, else null.
rugged	boolean	true if flagged as rugged, else null.
deprecated	boolean	true if deprecated, else null.
deadUrl	boolean	true if the site is dead, else null.
deadFrom	string	Date the protocol went dead, else null.
url	string	Protocol website URL.
twitter	string	Twitter / X URL, else null.
geckoId	string	CoinGecko ID, else null.
cmcId	string	CoinMarketCap ID, else null.
listedAt	integer	Unix timestamp the protocol was listed, else null.
description	string	Protocol description.
logo	string	Logo image URL.
aiSummary	string	AI protocol summary. null unless withSummary is enabled.
aiRiskFlags	string[]	AI due-diligence red flags. null unless withRisk is enabled.
aiRiskLevel	string	AI overall risk level. null unless withRisk is enabled.
source	string	Data source label (DefiLlama).
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	Present only on a failed run, where a single item with a populated error field is written instead.

Example output record

Real record from a live run (input {"mode":"protocols","category":"dexs","maxProtocols":2,"minTvl":1000000,"withSummary":true,"withRisk":true,"sort":"tvl"}), with chains trimmed for length:

{
  "name": "PancakeSwap AMM",
  "slug": "pancakeswap-amm",
  "category": "Dexs",
  "symbol": "CAKE",
  "tokenAddress": "bsc:0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82",
  "chains": ["Binance", "Ethereum", "Aptos"],
  "chainCount": 11,
  "tvl": 1733995842.0122418,
  "change1d": 2.54,
  "change7d": 2.33,
  "change1h": -0.12,
  "staking": 37252823.87,
  "chainTvl": { "Binance": 1730695097.32, "Ethereum": 1345223.01, "staking": 37252823.87 },
  "audits": 2,
  "auditLinks": ["https://docs.pancakeswap.finance/#is-it-safe"],
  "tags": ["AMM"],
  "parentProtocol": "pancakeswap",
  "url": "https://pancakeswap.finance/",
  "twitter": "https://twitter.com/PancakeSwap",
  "description": "The #1 AMM and yield farm on Binance Smart Chain",
  "logo": "https://icons.llamao.fi/icons/protocols/pancakeswap-amm",
  "aiSummary": "PancakeSwap is a leading automated market maker (AMM) and yield farming platform primarily operating on the Binance Smart Chain, with a TVL of approximately $1.73 billion.",
  "aiRiskFlags": [],
  "aiRiskLevel": "low",
  "source": "DefiLlama",
  "observedAt": "2026-08-14T07:10:15.564Z"
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~defillama-protocols-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"mode":"protocols","category":"Lending","chain":"Ethereum","minTvl":10000000,"maxProtocols":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~defillama-protocols-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"mode":"yields","category":"aave-v3","sort":"change","maxProtocols":100}'

Apify CLI:

apify call scrapers_lat/defillama-protocols-scraper \
  --input '{"mode":"chains","sort":"tvl","maxProtocols":20}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per record returned (result event). See the pricing tab for the current per-result price.
• Opt-in add-ons. The two AI add-ons (withSummary, withRisk) are billed as separate events only when they run and succeed, and only in protocols mode. They are off unless enabled on a paid plan.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 records per run. Upgrade for higher maxProtocols.

FAQ and troubleshooting

A run returned 0 records. Why? The filter combination matched nothing. Loosen minTvl, remove chain or category, or check the spelling. Zero-result runs are not charged.

What is the difference between the three modes? protocols returns DeFi protocols with TVL and fundamentals, chains returns TVL per blockchain, and yields returns liquidity pools with APY.

How do I filter one project's pools? Use mode: "yields" and set category to the project slug, for example aave-v3 or lido.

Why are mcap or github null? DefiLlama did not publish that value for the protocol. Missing source values are returned as null, never invented.

Why are the AI fields null? The AI add-ons are opt-in, protocols-mode only, and run only for paying Apify users. Enable withSummary or withRisk on a paid plan.

Is this an official DefiLlama tool? No. This actor is independent and reads only data that is publicly available through DefiLlama. Always do your own research before interacting with any protocol.

Related scrapers

• Crypto Airdrops Scraper: active, upcoming and claimable crypto airdrops.
• Crypto Token Unlocks Scraper: token unlock and vesting schedules.
• DexScreener Pairs Scraper: live DEX trading pairs and prices.
• DAO Governance Scraper: DAO proposals and on-chain governance votes.
• CoinGecko Crypto Scraper: coin prices, market caps and rankings.
• Polymarket Markets Scraper: prediction market prices and volumes.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with DefiLlama or any protocol. Accesses only publicly available data. Always do your own research before interacting with any protocol.