ParseForge
GeckoTerminal DEX Pools Scraper
parseforge/geckoterminal-dex-pools-scraper
Developer toolsAutomationOther
Scrape GeckoTerminal DEX pools across 30 blockchains. Returns each pool with price, volume, liquidity, FDV, and transaction counts from trending, new, search, or direct pool address modes.
- Total users
- 1
- Monthly active
- 0
- Total runs
- 88
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 12 days ago
Overview
GeckoTerminal DEX Pools Scraper
Scrape DEX pool data from GeckoTerminal for any blockchain, up to a million pools per run. Get trending pools, newly created pools, or search by token name and address. Every pool returns price, volume, liquidity, and transaction counts. No API key required. Export to CSV, JSON, Excel, or XML.
GeckoTerminal tracks real-time liquidity pools across dozens of blockchains, but there is no public API for bulk pool data. This Actor reads the public pool feeds directly, letting you pull trending pools, newly created pools, or search results for any token. You can target a single pool by its on-chain address or collect thousands of pools from Ethereum, Solana, BNB Chain, and 27 other networks.
| Who uses it | What they scrape GeckoTerminal for |
|---|---|
| DeFi traders | Spot new liquidity pools and trending tokens before they appear on major exchanges. |
| Crypto analysts | Track volume and liquidity shifts across chains to gauge market sentiment. |
| Bot builders | Feed real-time pool data into trading bots or Telegram alerts. |
| Market researchers | Map the DEX landscape by collecting pool counts and activity per blockchain. |
What it does
This Actor collects DEX pool listings from GeckoTerminal by trending rank, newest pools, token search, or pool address, and returns each pool as a flat row with its price, volume, liquidity, and transaction metrics.
- 🔥 Trending pools: the most active pools by volume and transactions on any network, ranked in real time.
- 🆕 Newly created pools: the latest liquidity pools added to GeckoTerminal, often within minutes of launch.
- 🔍 Search by query: find pools by token symbol, name, or partial address across a chosen network.
- 📍 Single pool by address: pull full details for one specific on-chain pool contract.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with GeckoTerminal data
📈 Monitor trending pools across chains.
A DeFi trader runs the Actor daily on Ethereum and Solana to collect the top 100 trending pools, then filters for those with rising volume and positive price change to identify early momentum plays.
🆕 Detect newly created pools for sniper bots.
A bot builder schedules the Actor every 60 seconds on Base and Arbitrum in New mode, feeding fresh pool addresses and initial liquidity into a Telegram alert channel.
🔍 Research token liquidity depth.
A crypto analyst searches for a token ticker across BNB Chain, Polygon, and Avalanche, then compares pool liquidity and 24h volume to decide which chain offers the best execution.
📍 Audit a specific pool by address.
A researcher pastes a pool contract address into the Actor to pull its current price, FDV, and transaction counts for a due-diligence report before committing capital.
Why choose this scraper
| What you get | |
|---|---|
| No API key | Reads public GeckoTerminal feeds directly, no registration or rate-limit headaches. |
| 30+ blockchains | Ethereum, Solana, BNB Chain, Base, Arbitrum, Polygon, Optimism, Avalanche, Fantom, TON, and more. |
| Fixed schema | Every pool returns the same flat structure: price, volume, liquidity, FDV, and buy/sell counts. |
| Scalable | Collect up to 1,000,000 pools in a single run, then export to CSV, JSON, Excel, or XML. |
How it compares
This Actor focuses on pool-level data with four distinct collection modes and 30 supported networks, while the listed competitors offer token-level data and OHLCV history.
| Feature | ParseForge | GeckoTerminal DEX Pools & Tokens Scraper | GeckoTerminal DEX Scanner - Trending & New Pools |
|---|---|---|---|
| Trending pools mode | Yes | Yes | Yes |
| New pools mode | Yes | Yes | Yes |
| Search pools by token query | Yes | Not listed | Not listed |
| Single pool by address | Yes | Not listed | Not listed |
| 30 supported blockchains | Yes | Not listed | Not listed |
| Pool OHLCV data | Not listed | Yes | Not listed |
| Token-level data | Not listed | Yes | Not listed |
Configure the run
Drive the Actor from trending lists, new pool feeds, search queries, and direct pool addresses, alone or together, and filters run as each pool is read so only matches reach your dataset. The Input tab lists every parameter.
A first run with the defaults:
{
"searchQuery": "PEPE",
"maxItems": 10
}
A larger pull:
{
"searchQuery": "PEPE",
"maxItems": 200
}
Pricing
Pay-per-result: $0.001 per result collected. You pay only for the results written to your dataset.
| Results collected | Approximate cost |
|---|---|
| 100 results | $0.10 |
| 1,000 results | $1.00 |
| 10,000 results | $10.00 |
New Apify accounts start with $5 in free credit.
Free users
Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.
Run it
- Create a free Apify account with $5 in credit.
- Open the GeckoTerminal DEX Pools Scraper.
- Set your inputs and any filters, then click Start.
- Export the results as CSV, Excel, JSON, or XML from the Dataset tab.
Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.
Use with AI agents (MCP)
Give an AI agent live access to GeckoTerminal through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/geckoterminal-dex-pools-scraper"
Then prompt it in plain language to run the scraper and read back the results.
Troubleshooting
Why am I getting no results for a search query?
Check that the token symbol or name is spelled correctly and that the selected network has pools for that token. Try a broader search term or switch to Ethereum, which has the most pools.
The Actor returns fewer pools than my maxItems setting.
GeckoTerminal may not have enough pools to fill your request for that mode and network. Trending and New lists are capped by what GeckoTerminal displays. Try a different network or mode.
I get an error when using a pool address.
Make sure the address is a valid liquidity pool contract on the selected network. The Actor expects the full on-chain address. If the pool is very new, wait a few minutes and retry.
The run is slow or times out.
Large maxItems values on networks with many pools can take time. Reduce the maximum pools, or increase the run timeout in the Actor's advanced settings. Using Apify proxies can also improve reliability.
Some fields are empty in the output.
GeckoTerminal may not have every metric for every pool, especially newly created ones. Missing data appears as null or empty in the dataset. This is expected for pools with low activity.
FAQ
| Question | Answer |
|---|---|
| Do I need a CoinGecko API key to use this scraper? | No. The Actor reads the public GeckoTerminal web interface directly. No API key, no registration, and no authentication are required. |
| Which blockchains are supported? | The Actor supports 30 networks including Ethereum, Solana, BNB Chain, Base, Arbitrum, Polygon POS, Optimism, Avalanche, Fantom, Blast, Linea, ZkSync, Mantle, Scroll, Sui, TON, Aptos, Pulsechain, Core, Sei, Merlin, Gnosis, CELO, Cronos, Kaia, Ronin, Metis, Mode, Manta Pacific, and ZetaChain. |
| What data does each pool row include? | Each pool returns its name, token pair, price, 24h volume, total liquidity locked, fully diluted valuation, price change percentage, buy and sell transaction counts, and the network it lives on. The exact fields are shown in the sample output on the Actor's page. |
| Can I scrape a single pool by its contract address? | Yes. Set the mode to 'Single pool by address' and paste the on-chain pool contract address. The Actor returns that pool's full data row. |
| How do I search for a token across all pools? | Set the mode to 'Search pools by query' and enter a token symbol, name, or partial address. You can narrow results to one network or leave the network on Ethereum to search broadly. |
| What is the difference between Trending and New pools? | Trending pools are ranked by current activity such as volume and transactions. New pools are the most recently created liquidity pools on GeckoTerminal, often within minutes of deployment. |
| How many pools can I collect in one run? | You can set the maximum pools from 1 up to 1,000,000. The Actor stops when it reaches your limit or when no more pools are available for the chosen mode and network. |
| Can I export the data to CSV or JSON? | Yes. Apify stores every run's results in a dataset that you can export to CSV, JSON, Excel, XML, or push directly to an API endpoint or cloud storage. |
| Does this scraper handle rate limiting? | The Actor reads public pages and includes built-in retries and delays to avoid being blocked. For very large runs, Apify's proxy rotation can be enabled. |
| Can I schedule this Actor to run automatically? | Yes. Apify lets you schedule runs on a cron expression, so you can pull trending pools every hour or check for new pools every few minutes without manual intervention. |
Related actors
Browse the full ParseForge collection for more scrapers.
🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.
⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by CoinGecko. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.
Input
| Field | Type | What it does | Default |
|---|---|---|---|
| mode | string (4 options) | Pick the kind of pool data to pull. Trending and New return a ranked list for the chosen network. Search finds pools matching a query. Pool by address returns one specific pool. | trending |
| searchQuery | string | Only used when Mode is Search. Token symbol, name, or pool address to look up, for example PEPE or WETH. | PEPE |
| poolAddress | string | Only used when Mode is Pool by address. The on-chain liquidity pool contract address. | not set |
| network | string (30 options) | Which chain to read pools from. Defaults to Ethereum. Applies to Trending, New, Pool, and narrows Search. | eth |
| maxItems | integer | How many pools to collect per run. | 10 |
Pricing
from $0.80 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| result | Single result in the default dataset. | $0.0008 to $0.001 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
API
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~geckoterminal-dex-pools-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"helloWorld": 123
}' Examples
Input that runs as-is.
{
"helloWorld": 123
} Reviews
No reviews yet. Be the first.
Issues
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.