CoinGecko历史图：三个月为何变日频，成交量能否相加？
链小知 · 进阶 · 核验 · 依官方文档整理
对照range端点的窗口、自动粒度和24小时成交量，不把采样价格当K线或累计成交。
开始前准备
- 准备已有脱敏请求、响应或面板记录及读取时间；本教程按公开官方资料整理，未调用业务API、登录、配置密钥或执行资金操作。
1. 固定coin ID、计价和日期输入
/coins/{id}/market_chart/range使用CoinGecko coin ID和vs_currency；它不是单个DEX池的价格。Pro参数schema为string，明确支持推荐ISO日期字符串或UNIX输入。Demo正文Notes虽复用ISO说明，但其参数schema为integer、description与SDK示例只写UNIX；这里按Demo schema记录UNIX，ISO兼容性留待实际端点验证。保存原格式、时区含义与读取时点，不混用CMC ID或合约。
检查结果：ID、计价、from/to原值及时间解释清楚。
2. 按实际跨度解释自动粒度
未设interval时：当前起算的一天为5分钟，其他历史一天为小时；2–90天为小时，超过90天为00:00 UTC日频。7/14至10/14同一时刻跨度为92天，不能把这个三个月窗口默认成小时数据。
Demo的interval参数enum仅hourly/daily；Pro另列5m/1m。当前range文档列hourly覆盖任意100天，5m限任意10天且Enterprise，1m限任意一天且Enterprise Beta；参数可写不代表用户套餐已获准。以实际端点/套餐/返回时点核对。
检查结果：窗口跨度、interval及实际序列间隔相符或记录差异。
3. 区分三组采样序列
prices、market_caps、total_volumes各是[timestamp,value]序列；total_volumes表示24小时成交量，重复小时采样彼此重叠，不能相加得到当日或三个月总成交。prices也不是open/high/low/close。
按实际timestamp对齐三组数据，不凭数组下标保证时点相同。返回示例的13位timestamp不能当秒直接解释；字段缺项、单位不足和序列缺口保持未知。
检查结果：价格、市值与24小时量分别解释，未重复累计滚动成交量。
4. 核历史权限和缓存
range文档分别限制Demo过去365天、Basic过去两年；完整历史需Analyst或以上。两页当前range说明已完成UTC日值00:35可用、00:40缓存过期及5分钟缓存，不能推广到全部其他端点。
Demo与Pro根/key类型不匹配、10005套餐限制或429应保留错误。缺历史记录不证明当时市场无成交；本页未取得实际API响应。
检查结果：套餐、端点缓存和错误边界对应，未把访问失败填零。
怎样确认完成
- 输出可复查的资产、窗口、粒度与序列解释记录。
常见错误与边界
- 三个月不总等于90天，自动粒度可能变化。
- 24小时滚动量不能按每个采样点累加；采样价不等OHLC。