# GeckoTerminal池K线：辨认补空蜡烛、计价与历史覆盖

整理：链小知（AI 辅助）
资料核对日期：2026-10-14
引用地址：https://lianxiaozhi.com/tools/guides/geckoterminal-pool-ohlcv-empty-interval-unit-check
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

按池OHLCV参数核缺口，避免将补出的零量蜡烛当真实成交，或把100条默认结果当全量。

## 使用工具
- [GeckoTerminal](https://lianxiaozhi.com/tools/geckoterminal) · [官方入口](https://www.geckoterminal.com/)
- [CoinGecko](https://lianxiaozhi.com/tools/coingecko) · [官方入口](https://www.coingecko.com/)

## 前置条件
- 准备已有脱敏请求、响应或面板记录及读取时间；本教程按公开官方资料整理，未调用业务API、登录、配置密钥或执行资金操作。

## 1. 固定network、pool与资产方向

CoinGecko链上池端点为/onchain/networks/{network}/pools/{pool_address}/ohlcv/{timeframe}；network用服务标识，pool_address是池，不是token合约。核返回meta.base/meta.quote完整地址。token默认base，可设quote或地址来反向取图。

核对结果：网络、池、base/quote与目标资产方向对应。
依据：[CoinGecko Pro：池OHLCV字段与历史范围](https://docs.coingecko.com/reference/pool-ohlcv-contract-address.md)
依据：[CoinGecko Demo：池OHLCV参考](https://docs.coingecko.com/demo/reference/pool-ohlcv-contract-address.md)

## 2. 记录周期和计价

timeframe与aggregate共同决定K线，例如minute配15是15分钟；currency默认usd，可为token，不能把两种计价混比较。每条ohlcv_list为timestamp/open/high/low/close/volume，顺序不能按普通价格序列读取。

核对结果：周期、aggregate、currency及六列结构明确。
依据：[CoinGecko Pro：池OHLCV字段与历史范围](https://docs.coingecko.com/reference/pool-ohlcv-contract-address.md)
依据：[CoinGecko Demo：池OHLCV参考](https://docs.coingecko.com/demo/reference/pool-ohlcv-contract-address.md)

## 3. 区分无交易省略和人工补空

默认include_empty_intervals=false，无swap区间被省略。设true则用前一close填OHLC并将volume置0；这类蜡烛不能证明期间发生交易或池维持可成交深度。请求失败与这种明确补空规则是不同状态。

核对结果：补空参数及零量来源可追溯，没有凭填充价格确认真实成交。
依据：[CoinGecko Pro：池OHLCV字段与历史范围](https://docs.coingecko.com/reference/pool-ohlcv-contract-address.md)
依据：[CoinGecko Demo：池OHLCV参考](https://docs.coingecko.com/demo/reference/pool-ohlcv-contract-address.md)

## 4. 检查条数与历史边界

limit默认100、最大1000；before_timestamp是epoch整数秒，并不是页号。每次最多6个月范围，不代表一请求返回六个月全部分钟K线。结合已取得最早时间、参数和重复边界核覆盖，缺后续记录时不宣称全量。

历史可用性还依赖套餐与该池开始追踪时间。Pro说明Basic过去6个月，Analyst以上可至2021年9月；Demo页也出现该套餐说明，不能单凭它认定Demo获完整历史。

核对结果：条数、实际最早时点、秒单位及套餐/追踪范围分别记录。
依据：[CoinGecko Pro：池OHLCV字段与历史范围](https://docs.coingecko.com/reference/pool-ohlcv-contract-address.md)
依据：[CoinGecko Demo：池OHLCV参考](https://docs.coingecko.com/demo/reference/pool-ohlcv-contract-address.md)

## 5. 保留数据刷新与业务未知项

池端点缓存标付费10秒、公开侧60秒（共享模板标Demo/keyless），这不证明同一路由可匿名访问，也不保证这次记录新鲜。核实际入口、响应时间与权限；限流及缺记录单列。价格K线不等本人的订单报价、模拟或到账，本教程均未执行。

核对结果：缓存说明、响应时点及未验证交易范围分列。
依据：[CoinGecko Pro：池OHLCV字段与历史范围](https://docs.coingecko.com/reference/pool-ohlcv-contract-address.md)
依据：[CoinGecko Demo：池OHLCV参考](https://docs.coingecko.com/demo/reference/pool-ohlcv-contract-address.md)
依据：[CoinGecko错误与限流](https://docs.coingecko.com/docs/errors-and-rate-limits.md)

## 常见错误
- OHLC补前收盘价不表示真实swap；缺记录也不等零业务。
- 池地址、token方向、计价与时间单位错配会产生不同图。

## 完成检查
- 形成有边界的池K线记录，说明补空、计价和实际覆盖。

## 相关知识

## 官方依据
- [CoinGecko Pro：池OHLCV字段与历史范围](https://docs.coingecko.com/reference/pool-ohlcv-contract-address.md)
- [CoinGecko Demo：池OHLCV参考](https://docs.coingecko.com/demo/reference/pool-ohlcv-contract-address.md)
- [CoinGecko错误与限流](https://docs.coingecko.com/docs/errors-and-rate-limits.md)