💧 vfat Pools Scraper

Want vfat.io Pools liquidity pools in a spreadsheet? This scraper makes it easy.

Use structured filters (chain, protocol, TVL, APR) — structured filters work better for AI agents — or paste an input_url from your browser once you've already filtered on vfat. When input_url is set it overrides the filters below. Either way, you get clean CSV/JSON with TVL, APR, tokens, and chain.

This actor is pools only. For incentivized farms use vfat Yields Scraper.

💡 Perfect for...

• LPs & traders: Compare Uniswap, Aerodrome, Velodrome, PancakeSwap and more in one table.
• Dashboards: Track TVL and APR across chains.
• Market research: Slice pools by protocol, chain, fee, or age.
• Data analysts: Export structured DeFi pool data.
• 🤖 AI Agents: Power bots and OpenClaw workflows with live vfat pool results.
• 📚 RAG Systems: Feed pool titles and metrics into retrieval pipelines.
• 🔗 AI Workflows: Plug into LangChain, AutoGPT, CrewAI, and similar stacks.

✨ Why you'll love this scraper

• 🔗 Input URL or Filters: Paste a vfat /pools URL (input_url) if you already filtered in the browser, or use structured filters (better for AI agents). input_url always wins when set.
• 🎯 Website-Matched Filters: Same chain, protocol, TVL, APR, fee, and age controls as vfat.io Pools.
• 💧 Liquidity catalog: ~18k pools, not the smaller Yield tab.

📦 What's inside the data?

For every pool, you will get:

• Core Details: id, url, title, protocol, chain, type
• Metrics: tvl_usd, apr, avg_apr, fees_or_rewards_7d_usd
• Contracts: pool_address, tokens, token_addresses

🚀 Quick start

Option A — Input URL

1. Open vfat Pools, apply filters, copy the URL — e.g. https://vfat.io/pools?chains=8453&protocols=uniswap.
2. Paste it into input_url.
3. Set max_results and click Start.

Option B — Structured filters (better for AI agents)

1. Leave input_url empty.
2. Optionally pick chain, protocol, TVL / APR ranges.
3. Set max_results (up to 2000) and click Start.

---

Tech details for developers 🧑‍💻

Input Example (filters):

{
  "chain_name": "base",
  "protocol": "uniswap",
  "min_tvl": 100000,
  "max_results": 100
}

Input Example (URL override):

{
  "input_url": "https://vfat.io/pools?chains=8453&protocols=aerodrome",
  "max_results": 50
}

Output Example:

{
  "id": "8453:0x6c561b446416e1a00e8e93e221854d6ea4171372:0x6c561b446416e1a00e8e93e221854d6ea4171372:poolId=:poolIndex=",
  "url": "https://vfat.io/pools?chains=8453&search=0x6c561b446416e1a00e8e93e221854d6ea4171372",
  "catalog": "pools",
  "title": "WETH/USDC",
  "protocol": "Uniswap",
  "chain": "Base",
  "chain_id": 8453,
  "type": "UNISWAP_V3",
  "tvl_usd": 116466745.36,
  "apr": 98.78,
  "fees_or_rewards_7d_usd": 221430.12,
  "pool_address": "0x6c561b446416e1a00e8e93e221854d6ea4171372",
  "tokens": ["WETH", "USDC"]
}

📋 Input reference (detailed)

Parameter	Type	Required	Default	Description
input_url	string	No	—	Paste a vfat /pools URL; overrides filters when set.
search	string	No	—	Token symbol or contract (search=).
chain_name	string enum	No	all	Chain name, e.g. base, ethereum, arbitrum.
protocol	string enum	No	all	Protocol id, e.g. uniswap, aerodrome (protocols=).
min_tvl / max_tvl	integer	No	—	TVL bounds in USD (minTVL / maxTVL).
min_apr / max_apr	integer	No	—	APR bounds (minAPR / maxAPR).
min_fee / max_fee	number	No	—	Pool fee bounds (minFee / maxFee).
max_age_days	integer	No	—	Only pools added within N days (maxAgeDays).
coverable_only	boolean	No	false	Insurance / coverable toggle (coverableOnly).
sort_key	string enum	No	tvl	tvl, apr, or created.
sort_direction	string enum	No	desc	desc or asc.
max_results	integer	No	50	Maximum rows (1–2000).

Notes on filters

• Prefer exact enum strings from the Apify input dropdowns (same values as vfat).
• input_url always wins over filters when provided.