GeckoTerminal DEX Scraper

Extract real-time DEX (decentralized exchange) trading data from GeckoTerminal across 100+ blockchain networks. Get trending pools, token prices, OHLCV candles, liquidity, trading volume, and transaction counts -- all without an API key.

What does GeckoTerminal DEX Scraper do?

GeckoTerminal DEX Scraper pulls live decentralized exchange data from GeckoTerminal's public API. It covers every major blockchain -- Ethereum, Solana, BSC, Base, Arbitrum, Polygon, Avalanche, Optimism, and 100+ more networks.

The scraper supports five modes:

• Trending Pools -- discover the hottest trading pools globally or on a specific network
• Search Pools -- find pools by token name, symbol, or contract address
• Token Info -- get detailed token data including price, market cap, FDV, and volume
• Network Top Pools -- list the top pools on any blockchain by liquidity and volume
• OHLCV Candles -- fetch historical price data (daily, hourly, or minute candles)

Who is it for

• DeFi traders and analysts who need real-time pool data to identify trading opportunities
• Crypto researchers building dashboards, alerts, or analytical reports on DEX activity
• Portfolio managers tracking token prices, liquidity, and volume across chains
• Quant developers who need OHLCV candlestick data for backtesting trading strategies
• Market intelligence teams monitoring trending tokens and new pool launches

Why use GeckoTerminal DEX Scraper instead of the API directly?

• No rate limit headaches -- built-in throttling handles GeckoTerminal's API limits automatically
• Structured output -- clean, flat JSON ready for spreadsheets, databases, or analysis tools
• Pagination handled -- automatically fetches multiple pages of results
• Cloud scheduling -- run on a schedule to build historical datasets without managing infrastructure
• Integrations -- pipe data directly to Google Sheets, Slack, webhooks, or 1000+ apps via Zapier

What data can you extract?

Pool data fields

Field	Description
poolName	Pool name (e.g., "WETH / USDT 0.01%")
poolAddress	Pool contract address
network	Blockchain network (eth, solana, bsc, etc.)
dex	DEX name (uniswap_v3, raydium, pancakeswap, etc.)
baseTokenSymbol	Base token symbol
baseTokenAddress	Base token contract address
quoteTokenSymbol	Quote token symbol
quoteTokenAddress	Quote token contract address
priceUsd	Current price in USD
priceChange5m/15m/30m/1h/6h/24h	Price change percentages
volume5m/15m/30m/1h/6h/24h	Trading volume in USD
buys5m/1h/24h	Buy transaction counts
sells5m/1h/24h	Sell transaction counts
buyers5m/1h/24h	Unique buyer counts
sellers5m/1h/24h	Unique seller counts
liquidityUsd	Pool liquidity in USD
marketCap	Market capitalization
fdv	Fully diluted valuation
poolCreatedAt	Pool creation timestamp

Token data fields

Field	Description
tokenName	Full token name
tokenSymbol	Token symbol
tokenAddress	Contract address
priceUsd	Current price in USD
marketCap	Market capitalization
fdv	Fully diluted valuation
volume24h	24-hour trading volume
totalReserveUsd	Total reserve across all pools
coingeckoId	CoinGecko identifier

OHLCV candle fields

Field	Description
timestamp	Unix timestamp
datetime	ISO 8601 datetime
open / high / low / close	Candle prices
volume	Trading volume

How much does it cost to scrape DEX trading data?

GeckoTerminal DEX Scraper uses pay-per-event pricing so you only pay for what you extract:

• Run started: $0.005 per run
• Per pool/token/candle: $0.00115 per data point (volume discounts available)

Example costs (Free tier):

• 20 trending pools = $0.005 + $0.023 = $0.028
• 100 pools search = $0.005 + $0.115 = $0.120
• 100 OHLCV candles = $0.005 + $0.115 = $0.120
• 1 token lookup = $0.005 + $0.00115 = $0.006

Free tier users get $5/month of platform credits -- enough for thousands of data points.

How to scrape trending DEX pools

1. Go to the GeckoTerminal DEX Scraper on Apify
2. Select Trending pools mode
3. Optionally set a blockchain network (leave empty for global trending)
4. Set max results (default: 20)
5. Click Start and download your data

Input configuration

Field	Description	Default
Mode	Scraping mode (trending, search, token info, network pools, OHLCV)	Trending pools
Blockchain network	Network ID (eth, solana, bsc, base, arbitrum, polygon_pos, avax, optimism)	solana
Search query	Token name/symbol to search for	PEPE
Token addresses	Contract addresses for token info mode	--
Pool address	Pool address for OHLCV mode	--
OHLCV timeframe	Candle period (day, hour, minute)	day
OHLCV aggregate	Aggregation (1, 4, 12 for hour; 1, 5, 15 for minute)	1
OHLCV candle limit	Number of candles (max 1000)	30
Max results	Maximum data points to return	20
Max pages	Maximum API pages to fetch	3

Output format

Results are saved as clean JSON objects in the Apify dataset. Here is an example pool record:

{
    "poolName": "LOL / SOL",
    "poolAddress": "Dx5wFoszXvND6XYYAjAjUQrGLqDAUrTVH2JmHz6eJDNt",
    "network": "solana",
    "dex": "pumpswap",
    "baseTokenSymbol": "LOL",
    "priceUsd": 0.009672,
    "priceChange24h": -10.77,
    "volume24h": 1681751.61,
    "liquidityUsd": 376208.31,
    "marketCap": 9590764.73,
    "buys24h": 9860,
    "sells24h": 6571,
    "poolCreatedAt": "2026-03-18T23:57:45Z"
}

Tips for getting the best results

• Use network filter for trending pools to focus on a specific chain (Solana, Ethereum, BSC, etc.)
• Combine modes -- run trending pools first to discover hot tokens, then use token info for deeper analysis
• OHLCV aggregation -- use 1-minute candles for scalping analysis, daily candles for swing trading
• Schedule runs to build historical trending pool datasets -- trending pools change constantly
• Network IDs are lowercase: eth, solana, bsc, base, arbitrum, polygon_pos, avax, optimism

Integrations and workflow patterns

GeckoTerminal DEX Scraper connects to 1000+ apps through Apify integrations:

• Google Sheets -- auto-update a DEX trading dashboard with trending pool data
• Slack / Discord -- get alerts when new pools hit the trending list
• Webhook -- trigger custom workflows when specific tokens appear in trending
• Zapier / Make -- connect to any app for automated DeFi data pipelines
• PostgreSQL / BigQuery -- store historical pool data for analysis

API usage

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('automation-lab/geckoterminal-scraper').call({
    mode: 'trendingPools',
    network: 'solana',
    maxResults: 50,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

from apify_client import ApifyClient

client = ApifyClient('YOUR_API_TOKEN')

run = client.actor('automation-lab/geckoterminal-scraper').call(run_input={
    'mode': 'trendingPools',
    'network': 'solana',
    'maxResults': 50,
})

items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)

cURL

curl -X POST "https://api.apify.com/v2/acts/automation-lab~geckoterminal-scraper/runs?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode": "trendingPools", "network": "solana", "maxResults": 50}'

Using with MCP (Model Context Protocol)

Connect GeckoTerminal DEX Scraper to AI assistants using the Apify MCP server.

Claude Code

$claude mcp add apify-mcp -s user -- npx -y @anthropic/apify-mcp-server@latest --actors='automation-lab/geckoterminal-scraper'

Then ask Claude: "Get trending pools on Solana from GeckoTerminal" or "Fetch OHLCV candles for this pool address on Ethereum."

Claude Desktop

Add to your MCP config:

{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": ["-y", "@anthropic/apify-mcp-server@latest"],
            "env": {
                "APIFY_TOKEN": "YOUR_API_TOKEN"
            }
        }
    }
}

Visit the Apify MCP server for more details.

Example MCP prompts

• "What are the top trending DEX pools right now?"
• "Get the price and volume for PEPE token pools"
• "Fetch daily OHLCV candles for the WETH/USDT pool on Ethereum"
• "Show me the top liquidity pools on Arbitrum"

Legality

GeckoTerminal provides a free public REST API specifically designed for programmatic access. This scraper uses that official API -- no scraping of web pages, no bypassing of protections, no authentication required. The API is documented and intended for developer use.

Always review GeckoTerminal's Terms of Service for the latest policies on API usage.

FAQ

Q: Do I need an API key for GeckoTerminal? A: No. GeckoTerminal's API is free and public. No authentication is required.

Q: What blockchain networks are supported? A: Over 100 networks including Ethereum, Solana, BSC, Base, Arbitrum, Polygon, Avalanche, Optimism, Fantom, Cronos, and many more. Use the networks endpoint for the full list.

Q: Why am I getting fewer results than expected? A: GeckoTerminal's API returns up to 20 pools per page. Increase the "Max pages" setting to fetch more results. Also check that the network ID is correct (e.g., eth not ethereum, bsc not binance).

Q: The scraper returns 0 results for my search. What should I do? A: Verify the token name/symbol spelling. Try searching by contract address instead of name. Make sure the token exists on GeckoTerminal by checking geckoterminal.com first.

Q: How often does the data update? A: GeckoTerminal data is near real-time. Pool prices, volumes, and transaction counts update every few seconds on the platform. OHLCV candles update at the end of each period.

Q: Can I get historical data? A: Yes, use OHLCV mode for historical price candles (up to 1000 candles per request). For historical trending pools, schedule regular runs to build your own dataset over time.

Pricing

This actor uses pay-per-event pricing. See the Pricing tab on Apify Store for current rates.

Related

• DexScreener Scraper -- extract DEX data from DexScreener
• CoinGecko Scraper -- cryptocurrency market data from CoinGecko
• CoinMarketCap Scraper -- crypto prices and rankings from CoinMarketCap