# CoinGecko历史图：三个月为何变日频，成交量能否相加？

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

对照range端点的窗口、自动粒度和24小时成交量，不把采样价格当K线或累计成交。

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

## 前置条件
- 准备已有脱敏请求、响应或面板记录及读取时间；本教程按公开官方资料整理，未调用业务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原值及时间解释清楚。
依据：[CoinGecko Pro range：窗口与序列](https://docs.coingecko.com/reference/coins-id-market-chart-range.md)
依据：[CoinGecko Demo range：历史限制](https://docs.coingecko.com/demo/reference/coins-id-market-chart-range.md)

## 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及实际序列间隔相符或记录差异。
依据：[CoinGecko Pro range：窗口与序列](https://docs.coingecko.com/reference/coins-id-market-chart-range.md)
依据：[CoinGecko Demo range：历史限制](https://docs.coingecko.com/demo/reference/coins-id-market-chart-range.md)

## 3. 区分三组采样序列

prices、market_caps、total_volumes各是[timestamp,value]序列；total_volumes表示24小时成交量，重复小时采样彼此重叠，不能相加得到当日或三个月总成交。prices也不是open/high/low/close。

按实际timestamp对齐三组数据，不凭数组下标保证时点相同。返回示例的13位timestamp不能当秒直接解释；字段缺项、单位不足和序列缺口保持未知。

核对结果：价格、市值与24小时量分别解释，未重复累计滚动成交量。
依据：[CoinGecko Pro range：窗口与序列](https://docs.coingecko.com/reference/coins-id-market-chart-range.md)
依据：[CoinGecko Demo range：历史限制](https://docs.coingecko.com/demo/reference/coins-id-market-chart-range.md)

## 4. 核历史权限和缓存

range文档分别限制Demo过去365天、Basic过去两年；完整历史需Analyst或以上。两页当前range说明已完成UTC日值00:35可用、00:40缓存过期及5分钟缓存，不能推广到全部其他端点。

Demo与Pro根/key类型不匹配、10005套餐限制或429应保留错误。缺历史记录不证明当时市场无成交；本页未取得实际API响应。

核对结果：套餐、端点缓存和错误边界对应，未把访问失败填零。
依据：[CoinGecko Pro range：窗口与序列](https://docs.coingecko.com/reference/coins-id-market-chart-range.md)
依据：[CoinGecko Demo range：历史限制](https://docs.coingecko.com/demo/reference/coins-id-market-chart-range.md)
依据：[CoinGecko错误、key类型与限流](https://docs.coingecko.com/docs/errors-and-rate-limits.md)

## 常见错误
- 三个月不总等于90天，自动粒度可能变化。
- 24小时滚动量不能按每个采样点累加；采样价不等OHLC。

## 完成检查
- 输出可复查的资产、窗口、粒度与序列解释记录。

## 相关知识

## 官方依据
- [CoinGecko Pro range：窗口与序列](https://docs.coingecko.com/reference/coins-id-market-chart-range.md)
- [CoinGecko Demo range：历史限制](https://docs.coingecko.com/demo/reference/coins-id-market-chart-range.md)
- [CoinGecko错误、key类型与限流](https://docs.coingecko.com/docs/errors-and-rate-limits.md)