GeckoTerminal池K线：辨认补空蜡烛、计价与历史覆盖
链小知 · 进阶 · 核验 · 依官方文档整理
按池OHLCV参数核缺口，避免将补出的零量蜡烛当真实成交，或把100条默认结果当全量。
开始前准备
- 准备已有脱敏请求、响应或面板记录及读取时间；本教程按公开官方资料整理，未调用业务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与目标资产方向对应。
2. 记录周期和计价
timeframe与aggregate共同决定K线，例如minute配15是15分钟；currency默认usd，可为token，不能把两种计价混比较。每条ohlcv_list为timestamp/open/high/low/close/volume，顺序不能按普通价格序列读取。
检查结果：周期、aggregate、currency及六列结构明确。
3. 区分无交易省略和人工补空
默认include_empty_intervals=false，无swap区间被省略。设true则用前一close填OHLC并将volume置0；这类蜡烛不能证明期间发生交易或池维持可成交深度。请求失败与这种明确补空规则是不同状态。
检查结果：补空参数及零量来源可追溯，没有凭填充价格确认真实成交。
4. 检查条数与历史边界
limit默认100、最大1000；before_timestamp是epoch整数秒，并不是页号。每次最多6个月范围，不代表一请求返回六个月全部分钟K线。结合已取得最早时间、参数和重复边界核覆盖，缺后续记录时不宣称全量。
历史可用性还依赖套餐与该池开始追踪时间。Pro说明Basic过去6个月，Analyst以上可至2021年9月；Demo页也出现该套餐说明，不能单凭它认定Demo获完整历史。
检查结果：条数、实际最早时点、秒单位及套餐/追踪范围分别记录。
5. 保留数据刷新与业务未知项
池端点缓存标付费10秒、公开侧60秒（共享模板标Demo/keyless），这不证明同一路由可匿名访问，也不保证这次记录新鲜。核实际入口、响应时间与权限；限流及缺记录单列。价格K线不等本人的订单报价、模拟或到账，本教程均未执行。
检查结果：缓存说明、响应时点及未验证交易范围分列。
怎样确认完成
- 形成有边界的池K线记录，说明补空、计价和实际覆盖。
常见错误与边界
- OHLC补前收盘价不表示真实swap；缺记录也不等零业务。
- 池地址、token方向、计价与时间单位错配会产生不同图。