GeckoTerminal Top-Pool Data: History Limits - Avoid Silent Gaps
Top-pool lists return 20 pools per page, and paging beyond 10 pages needs a higher plan. Deep lists can be cut off without obvious errors.
Short answer
CoinGecko's top-pools-by-token endpoint returns up to 20 pools per page; paging beyond 10 pages requires the Analyst plan or above. Responses are cached (30 s paid, 60 s demo) and sorted by a chosen rule. There's no history of past rankings. For tokens with many pools, check whether you reached the paging limit, store snapshots with retrieval times and sort rule, and compare by pool address.
Documented limits
| Limit | Value | Effect |
|---|---|---|
| Pools per page | 20 | Pagination |
| Pages without Analyst | ≤ 10 | ≤ 200 pools |
| Cache | 30 s / 60 s | Snapshot age |
| History | Not provided | Store snapshots |
Compare GeckoTerminal Top-Pool Data across Binance, Bybit, OKX and Hyperliquid markets.
Open markets in ChartsPodWhere silent gaps come from
- Paging limit reached silently
- Snapshots without sort rule
- Comparing by rank
- Cache age ignored
Example
Illustrative: a token with hundreds of small pools appeared to have exactly 200 — the paging limit.
Related: GeckoTerminal Top-Pool Data: Event Time vs Retrieval Time, GeckoTerminal New-Pool Data: History Limits - Avoid Silent Gaps.
For tokens with many pools, check whether you reached the paging limit, store snapshots with retrieval times and sort rule, and compare by pool address.
Check GeckoTerminal Top-Pool Data against a live market before relying on it.
Try it in ChartsPodQuestions readers ask
How many pools per page?
Up to 20.
Is there a paging limit?
Beyond 10 pages needs the Analyst plan.
Is ranking history available?
No; store snapshots.
Sources and methodology
Limits come from DEX Screener's API reference, CoinGecko's onchain API documentation and Binance's Spot API documentation, read 17 October 2026. Where a limit isn't documented, this guide says so. Examples are illustrative.
- CoinGecko API: Top pools by token — 20 per page; >10 pages needs Analyst plan.
This article explains research tools and workflows. It is not financial advice, does not recommend buying or selling any asset and does not predict prices. Crypto derivatives carry a risk of rapid and total loss of margin.
CHARTSPOD EDITORIAL EDITION · RESEARCH AND EDUCATION ONLY · NOT FINANCIAL ADVICE.