✈️ Aerodrome Finance Scraper

Want Aerodrome liquidity pools on Base in a spreadsheet? This scraper makes it easy.

Use structured filters (pool type, TVL, APR) — structured filters work better for AI agents — or paste an input_url from Aerodrome Liquidity once you've already filtered in the browser. When input_url is set it overrides the filters below.

This actor is Aerodrome on Base only. For every DEX at once use vfat Pools Scraper or vfat Yields Scraper.

💡 Perfect for...

• LPs: Compare Basic Volatile, Basic Stable, and Concentrated (Slipstream) pools.
• Dashboards: Track TVL and APR on Base.
• Market research: Slice Aerodrome by pool type or fee.
• Data analysts: Export structured Aerodrome pool data.
• 🤖 AI Agents: Power bots and OpenClaw workflows with live Aerodrome 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 an Aerodrome /liquidity 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 pool types as the Liquidity page — Basic Volatile, Basic Stable, Concentrated.
• ⛽ Base DEX: Aerodrome only (~1,200 incentivized pools), not the full multi-chain catalog.

📦 What's inside the data?

Every row includes all of these fields:

• Core: id, url, title, protocol, chain, chain_id, pool_type, type, subtype
• Contracts: farm_address, pool_address, tokens, token_addresses, token_1, token_2
• Flags: fee, is_stable, is_nft, has_incentives, is_killed
• Liquidity: tvl_usd, active_tvl_usd, pool_tvl_usd
• Returns: apr, avg_apr, max_apr, lp_apr, staking_apr, fees_or_rewards_7d_usd, first_seen_at

🚀 Quick start

Option A — Input URL

1. Open Aerodrome Liquidity, apply filters, copy the URL — e.g. https://aerodrome.finance/liquidity?filters=basicVolatile.
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 pool type and TVL / APR ranges.
3. Set max_results (up to 2000) and click Start.

---

Tech details for developers 🧑‍💻

Input Example (filters):

{
  "pool_type": "volatile",
  "min_tvl": 100000,
  "max_results": 100
}

Input Example (URL override):

{
  "input_url": "https://aerodrome.finance/liquidity?filters=concentrated&sort=tvl:desc",
  "max_results": 50
}

Output Example:

{
  "id": "8453:0x4f09bab2f0e15e2a078a227fe1537665f55b8360:0x6cdcb1c4a4d1c3c6d054b27ac5b77e89eafb971d:poolId=:poolIndex=",
  "url": "https://aerodrome.finance/deposit?token0=0x833589fcd6edb6e08f4c7c32d4f71b54bda02913&token1=0x940181a94a35a4569e4529a3cdfb74e38fd98631",
  "title": "USDC/AERO",
  "protocol": "Aerodrome",
  "chain": "Base",
  "chain_id": 8453,
  "pool_type": "Basic Volatile",
  "type": "AERODROME_V2",
  "subtype": "volatile",
  "farm_address": "0x4f09bab2f0e15e2a078a227fe1537665f55b8360",
  "pool_address": "0x6cdcb1c4a4d1c3c6d054b27ac5b77e89eafb971d",
  "tokens": ["USDC", "AERO"],
  "token_addresses": [
    "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
    "0x940181a94a35a4569e4529a3cdfb74e38fd98631"
  ],
  "token_1": "USDC",
  "token_2": "AERO",
  "fee": 30,
  "is_stable": false,
  "is_nft": false,
  "has_incentives": true,
  "is_killed": false,
  "tvl_usd": 28706627.15,
  "active_tvl_usd": 28706627.15,
  "pool_tvl_usd": 0,
  "apr": 22.86,
  "avg_apr": 22.86,
  "max_apr": 22.86,
  "lp_apr": 0,
  "staking_apr": 22.86,
  "fees_or_rewards_7d_usd": 125859.21,
  "first_seen_at": "2024-11-08T13:00:00.000Z"
}

Output fields:

Field	Description
id	Listing id.
url	Aerodrome deposit link for the pair.
title	Token pair, e.g. USDC/AERO.
protocol	Always Aerodrome.
chain	Always Base.
chain_id	Always 8453.
pool_type	Basic Volatile, Basic Stable, or Concentrated.
type	Internal type, e.g. AERODROME_V2 or AERO_SLIPSTREAM_GAUGE.
subtype	volatile, stable, or concentrated.
farm_address	Gauge / farm contract.
pool_address	Liquidity pool contract.
tokens	Token symbols.
token_addresses	Token contracts.
token_1 / token_2	First and second symbols.
fee	Pool fee (native units).
is_stable	Stable pool flag.
is_nft	Concentrated / NFT position flag.
has_incentives	Extra rewards flag.
is_killed	Killed / deprecated flag.
tvl_usd	Staked TVL in USD.
active_tvl_usd	Active liquidity in USD.
pool_tvl_usd	Active pool liquidity in USD.
apr	Current APR %.
avg_apr	Average APR %.
max_apr	Max APR %.
lp_apr	LP fee APR %.
staking_apr	Staking / emissions APR %.
fees_or_rewards_7d_usd	7-day rewards (USD).
first_seen_at	When the pool was first listed.

📋 Input reference (detailed)

Parameter	Type	Required	Default	Description
input_url	string	No	—	Paste an Aerodrome /liquidity URL; overrides filters when set.
search	string	No	—	Token symbol or contract.
pool_type	string enum	No	all	volatile, stable, or concentrated.
min_tvl / max_tvl	integer	No	—	TVL bounds in USD.
min_apr / max_apr	integer	No	—	APR bounds.
min_fee / max_fee	number	No	—	Pool fee bounds.
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 labels as Aerodrome Liquidity).
• input_url always wins over filters when provided.
• filters=basicVolatile, basicStable, and concentrated on the Liquidity URL are mapped automatically.