🌾 vfat Yields Scraper

Want vfat.io Yield farms in a spreadsheet? This scraper makes it easy.

Use structured filters (chain, protocol, farm type, TVL, APR, weekly rewards) — 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, rewards, tokens, and chain.

This actor is yield farms only. For the full liquidity catalog use vfat Pools Scraper.

💡 Perfect for...

• Farmers: Compare Aerodrome, Velodrome, Thena, PancakeSwap incentives in one table.
• Dashboards: Track APR and weekly rewards across chains.
• Market research: Slice farms by protocol, chain, or volatile / stable / concentrated.
• Data analysts: Export structured DeFi farm data.
• 🤖 AI Agents: Power bots and OpenClaw workflows with live vfat yield results.
• 📚 RAG Systems: Feed farm 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 /yield 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, farm type, TVL, APR, and rewards controls as vfat.io Yield.
• 🌾 Incentivized farms: The Yield tab (~4.5k farms), not unincentivized pools.

📦 What's inside the data?

For every farm, you will get:

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

🚀 Quick start

Option A — Input URL

1. Open vfat Yield, apply filters, copy the URL — e.g. https://vfat.io/yield?chains=8453&protocols=aerodrome.
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, farm type, TVL / APR / rewards ranges.
3. Set max_results (up to 2000) and click Start.

---

Tech details for developers 🧑‍💻

Input Example (filters):

{
  "chain_name": "base",
  "protocol": "aerodrome",
  "farm_type": "volatile",
  "max_results": 100
}

Input Example (URL override):

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

Output Example:

{
  "id": "8453:0x...:poolId=:poolIndex=",
  "url": "https://vfat.io/yield?chains=8453&search=0x...",
  "catalog": "farms",
  "title": "USDC/AERO",
  "protocol": "Aerodrome",
  "chain": "Base",
  "chain_id": 8453,
  "type": "AERODROME_V2",
  "tvl_usd": 29037011.82,
  "apr": 23.13,
  "fees_or_rewards_7d_usd": 129400.12,
  "tokens": ["USDC", "AERO"]
}

📋 Input reference (detailed)

Parameter	Type	Required	Default	Description
input_url	string	No	—	Paste a vfat /yield 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. aerodrome, velodrome (protocols=).
farm_type	string enum	No	all	volatile, stable, or concentrated.
min_tvl / max_tvl	integer	No	—	TVL bounds in USD (minTVL / maxTVL).
min_apr / max_apr	integer	No	—	APR bounds (minAPR / maxAPR).
min_rewards / max_rewards	integer	No	—	Weekly rewards bounds in USD (minRewards / maxRewards).
min_fee / max_fee	number	No	—	Pool fee bounds (minFee / maxFee).
max_age_days	integer	No	—	Only farms 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.