🏍️ Velodrome Finance Scraper

Want Velodrome liquidity pools in a spreadsheet? This scraper makes it easy.

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

This actor is Velodrome Superchain only. For Aerodrome on Base use Aerodrome Finance Scraper. 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 on Optimism and Superchain.
• Dashboards: Track TVL and APR across Velodrome chains.
• Market research: Slice Velodrome by chain or pool type.
• Data analysts: Export structured Velodrome pool data.
• 🤖 AI Agents: Power bots and OpenClaw workflows with live Velodrome 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 Velodrome /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 Superchain chips and pool types as the Liquidity page.
• 🌐 Superchain DEX: Optimism, Unichain, Ink, Mode, Celo, and the rest of Velodrome (~600 incentivized pools).

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

---

Tech details for developers 🧑‍💻

Input Example (filters):

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

Input Example (URL override):

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

Output Example:

{
  "id": "10:0x...:poolId=:poolIndex=",
  "url": "https://velodrome.finance/deposit?chain=10&chain0=10&chain1=10&token0=0x...&token1=0x...",
  "title": "WETH/USDC",
  "protocol": "Velodrome",
  "chain": "Optimism",
  "chain_id": 10,
  "pool_type": "Basic Volatile",
  "type": "VELODROME_V2",
  "subtype": "volatile",
  "farm_address": "0x...",
  "pool_address": "0x...",
  "tokens": ["WETH", "USDC"],
  "token_addresses": ["0x...", "0x..."],
  "token_1": "WETH",
  "token_2": "USDC",
  "fee": 30,
  "is_stable": false,
  "is_nft": false,
  "has_incentives": true,
  "is_killed": false,
  "tvl_usd": 12500000.0,
  "active_tvl_usd": 12500000.0,
  "pool_tvl_usd": 0,
  "apr": 18.4,
  "avg_apr": 18.4,
  "max_apr": 18.4,
  "lp_apr": 0,
  "staking_apr": 18.4,
  "fees_or_rewards_7d_usd": 42000.0,
  "first_seen_at": "2024-11-08T13:00:00.000Z"
}

Output fields:

Field	Description
id	Listing id.
url	Velodrome deposit link for the pair.
title	Token pair, e.g. WETH/USDC.
protocol	Always Velodrome.
chain	Superchain name, e.g. Optimism.
chain_id	Numeric chain id, e.g. 10.
pool_type	Basic Volatile, Basic Stable, or Concentrated.
type	Internal type, e.g. VELODROME_V2.
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 a Velodrome /liquidity URL; overrides filters when set.
search	string	No	—	Token symbol or contract.
chain_name	string enum	No	all	Superchain name, e.g. optimism, unichain, ink.
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 Velodrome Liquidity).
• input_url always wins over filters when provided.
• Liquidity URL filters=Optimism,basicVolatile is mapped automatically.