L logiover
developer-tools · May 28, 2026 · 6 min read

How to Scrape GeckoTerminal DEX Pools in 2026

Bulk-export live DEX liquidity pools from GeckoTerminal across 100+ chains — price, FDV, market cap, liquidity, 1h/6h/24h volume, price change and tx counts.

GeckoTerminal is the most comprehensive public view of on-chain DEX activity — live liquidity pools across 100+ blockchains, spanning EVM chains, Solana, Move-based chains, and more, covering Uniswap V2/V3/V4, PancakeSwap, SushiSwap, Curve, Balancer, Raydium, Orca, and a long tail of others. If you want a single multichain feed of where liquidity is and how it’s moving, this is the source. It’s powered by an official public REST API, so the work isn’t beating an anti-bot stack — it’s iterating per-chain endpoints at scale while respecting rate limits. This guide covers the data, the multichain extraction mechanics, and how to turn it into a clean flat feed.

What’s worth extracting

GeckoTerminal returns rich per-pool records. Flattened, each pool row carries:

  • Pool identity — on-chain pool contract address, network slug, and a human-readable pool name (e.g. WETH / USDC).
  • Token prices — base and quote token USD prices.
  • Valuation — fully diluted valuation (FDV) and market cap.
  • Liquidity — total pool liquidity (reserve) in USD.
  • Volume — 1h, 6h, and 24h trading volume.
  • Momentum — short- and medium-term price-change percentages.
  • Activity — 24h transaction counts.
  • Provenance — pool creation timestamp and a direct GeckoTerminal link.

That’s enough to rank pools by liquidity or volume, spot freshly created pools, and compute basic fundamentals — across every chain in one dataset.

The extraction reality: multichain API iteration and rate limits

The challenge with GeckoTerminal isn’t access; it’s breadth and pacing. The actor handles the parts that make a naive script fall over:

  • Per-chain paginated endpoints. GeckoTerminal’s API is organized by network, each with paginated pool lists. A complete pull means iterating 100+ networks and paging each up to the API’s per-network ceiling.
  • Rate limits with backoff. The public API is rate-limited. The actor throttles and uses exponential backoff so a big multichain sweep doesn’t get rejected or banned mid-run.
  • In-stream volume filtering. You can filter by minimum volume as rows stream, so you keep the active pools and drop the dust without storing it first.
  • JSON-API flattening. GeckoTerminal returns nested JSON-API-style responses with relationships. The actor flattens these into one flat row per pool, so the output drops straight into a warehouse or spreadsheet.
  • High-throughput design. Built for thousands of pools per run across chains, with frequent scheduled refreshes in mind.

The pay-per-result pricing here ($0.003/result) reflects that each row is a genuinely enriched, cross-chain pool record — so volume filtering isn’t just a convenience, it’s how you keep runs focused and cost-efficient.

Run the GeckoTerminal DEX Pools Scraper — live pools across 100+ chains with price, FDV, liquidity, 1h/6h/24h volume, price change and tx counts. Thousands of pools per run, schedulable for a fresh on-chain feed.

How querying works

The inputs control which chains, how deep, and what survives the filter:

networks:     all | a list of chain slugs (eth, bsc, solana, base, ...)
min_volume:   in-stream USD volume floor, e.g. 10000
sort:         volume | liquidity | creation time
max_per_net:  page depth per network (up to API ceiling)
limit:        overall cap on returned pools

Two dominant patterns:

  • Liquidity/volume leaderboard — all networks, sorted by 24h volume, with a meaningful min_volume floor. You get the active, tradeable pools across DeFi in one feed.
  • New-pool discovery — frequent scheduled runs, sorted/filtered by recent creation timestamp plus a minimum volume. This is the memecoin and new-listing radar: catch pools shortly after they’re created and start showing real volume.

Schema design for downstream use

A flat per-pool row, easy to query across chains:

{
  "network": "base",
  "dex": "uniswap-v3",
  "pool_address": "0x4c36388be6f416a29c8d8eee81c771ce6be14b18",
  "pool_name": "WETH / USDC",
  "base_token_price_usd": 3412.55,
  "quote_token_price_usd": 1.0001,
  "fdv_usd": 0,
  "market_cap_usd": 0,
  "liquidity_usd": 8421337.10,
  "volume_1h_usd": 142003.4,
  "volume_6h_usd": 910442.7,
  "volume_24h_usd": 3984221.0,
  "price_change_1h_pct": 0.42,
  "price_change_24h_pct": -2.13,
  "tx_count_24h": 5821,
  "pool_created_at": "2026-04-02T11:08:00Z",
  "geckoterminal_url": "https://www.geckoterminal.com/base/pools/0x4c36...",
  "scraped_at": "2026-05-28T12:00:00Z"
}

Schema choices that matter on-chain:

  • Key on (network, pool_address). The same address can theoretically appear on different chains; the pair is your safe unique key. The address alone is not globally unique.
  • Always store scraped_at. On-chain liquidity and volume move by the minute; a pool record is only meaningful with its capture time. For longitudinal TVL studies, (network, pool_address, scraped_at) is your key.
  • Treat fdv_usd/market_cap_usd as sometimes-zero. Stablecoin pairs and tokens without supply data report 0 or null. Don’t divide by them blindly.
  • Keep all three volume windows. The 1h/6h/24h spread is the signal for momentum and freshness; collapsing to just 24h loses the “is this heating up right now” read.
  • Store prices as high-precision decimals. Long-tail tokens trade at extreme small or large values; floats lose them.

Typical use cases

  • Cross-DEX / cross-chain arbitrage discovery — pull top pools per chain, sort by volume and liquidity, find price dislocations.
  • New-token and memecoin discovery — frequent scans filtered by recent pool creation and minimum volume.
  • Multichain liquidity dashboards — aggregate liquidity per network, per DEX, or per token.
  • MEV research and market making — target on-chain pool contracts and fresh high-volume pools.
  • Tokenomics and pricing research — combine price, FDV/market cap, and liquidity to assess fundamentals.
  • On-chain analytics and indexer pipelines — use the feed as an upstream price/liquidity source with periodic refresh.
  • DeFi TVL and volume studies — scheduled snapshots build longitudinal datasets.
  • Portfolio and wallet valuation — price long-tail tokens using on-chain USD price and liquidity signals.

Cost math

Pricing is pay-per-result at $0.003 per pool row, plus a negligible start fee. That makes the volume filter your primary cost lever. A focused liquidity leaderboard — say, all chains, min_volume of $10K, returning ~3,000 active pools — costs about $9 per run. A daily new-pool radar with a tight filter returning a few hundred fresh pools costs cents. The lesson: set a real min_volume floor. Pulling every dust pool across 100+ chains is both expensive and analytically useless.

Building this yourself is a serious undertaking — 100+ per-network endpoints, pagination, rate-limit backoff, and JSON-API flattening, re-validated whenever GeckoTerminal changes its API. For a one-chain experiment that’s a day; for a maintained multichain feed it’s ongoing infrastructure the actor absorbs.

Common pitfalls

  • No volume floor. The fastest way to waste money and drown in noise. Always set min_volume; the long tail of dead pools is enormous.
  • Address-only keys. Collisions and joins break without the network component. Always key on (network, pool_address).
  • Stale-feed assumptions. This is a snapshot. A pool’s volume from an hour ago is not its volume now. Schedule at the cadence your use case demands and respect scraped_at.
  • FDV/market-cap nulls. Many pools legitimately have no FDV; treat zero/null as “unknown,” not “worthless.”
  • Rate-limit greed. Don’t override the throttle to go faster — the public API will reject you. Let the backoff logic pace the sweep.

Wrapping up

GeckoTerminal gives you the broadest public window into on-chain liquidity, and its REST API means the hard part is breadth, pacing, and flattening — not getting in. For a single-chain look, the API is approachable. For a maintained multichain feed powering arbitrage discovery, memecoin radar, liquidity dashboards, or TVL studies, a managed actor that already iterates every network, respects rate limits, filters by volume, and flattens to clean rows is the fastest path to a usable on-chain dataset.

Open the GeckoTerminal DEX Pools Scraper on Apify — 100+ chains, volume-filtered, flat rows, schedulable. Pay per pool row; set a min-volume floor to keep runs lean.

Related guides