GeckoTerminal Pool OHLCV: History Limits - Avoid Silent Gaps
CoinGecko's pool OHLCV returns at most 1,000 candles and a 6-month range per call. Long histories need pagination — and empty intervals are skipped unless you ask.
Short answer
The pool OHLCV endpoint returns up to 1,000 candles per call (default 100) and covers at most a 6-month range per call; use before_timestamp to page back. History depth depends on plan (6 months on Basic; from September 2021 on higher plans, depending on when tracking began). Intervals without swaps are skipped by default, so a missing candle can mean 'no trades' — or a gap in your pagination. Set include_empty_intervals=true to make quiet intervals explicit.
Documented limits
| Limit | Value | Effect |
|---|---|---|
| Candles per call | ≤ 1,000 (default 100) | Paginate |
| Range per call | ≤ 6 months | Paginate |
| History by plan | 6 months (Basic) / longer | Coverage |
| Empty intervals | Skipped by default | Ambiguous gaps |
Check GeckoTerminal Pool OHLCV against a live market before relying on it.
Try it in ChartsPodWhere silent gaps come from
- Default limit of 100 treated as full history
- Overlapping or missing pages
- Skipped intervals read as data gaps (or vice versa)
- Plan history limit reached silently
Example
Illustrative: a script using the default limit fetched 100 hourly candles and concluded the pool was four days old.
Related: GeckoTerminal Pool OHLCV: Event Time vs Retrieval Time, GeckoTerminal Token OHLCV: History Limits - Avoid Silent Gaps.
Set include_empty_intervals=true to make quiet intervals explicit.
Compare GeckoTerminal Pool OHLCV across Binance, Bybit, OKX and Hyperliquid markets.
Open markets in ChartsPodQuestions readers ask
How many candles per call?
Up to 1,000; default 100.
How far back?
Depends on plan; 6-month range per call.
What about intervals with no trades?
Skipped unless include_empty_intervals is true.
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: Pool OHLCV — limit ≤ 1000; 6-month range per call; before_timestamp; plan-based history; empty intervals skipped by default.
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.