# CryptoQuant ERC20 历史指标复查：Mean分母、UTC窗口与修订快照

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

明确方向交易数和MA7的区别，并保留旧公式、日期schema和非PIT警告与当前延迟快照之间的差异。

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

## 前置条件
- 已有脱敏ERC20 inflow/outflow、transactions-count或reserve文件；也可用明确标为示例的本页算术。
- 记录token、exchange、window、from/to、获取日期及方法版本；不需要密钥或真实账户。

## 1. 核对 token、exchange 和历史请求条件

ERC20 exchange-flows要求token与exchange，window默认day，可选hour/block；方法支持不等于套餐已开放。保留原请求的from/to、limit和输出format，不只记图表上的币名。

limit默认100表示最新数据点或to之前的最近N条，不是保证从from开始依次取满100条。检查实际文件的最早/最晚时点，才能声明覆盖了哪个范围。

核对结果：请求条件与已有数据覆盖范围都有记录，没有凭默认limit断言完整历史。
依据：[CryptoQuant 当前官方 OpenAPI v1](https://docs.cryptoquant.com/openapi/v1.json)
依据：[CryptoQuant 旧 ERC20 Exchange Flows 方法](https://userguide.cryptoquant.com/api/erc20-exchange-flows.md)
依据：[CryptoQuant Data API 权限与套餐](https://www.cryptoquant.com/apis)

## 2. 按 UTC 和字段类型对齐每行

from/to正文格式为YYYYMMDDTHHMMSS、UTC；day可用YYYYMMDD，block可用高度。把毫秒时间戳、块高和日期串分开；本地日期先明确时区再映射到UTC。

结果day使用date，hour/block可带datetime，blockheight是高度。当前schema把date写YYYY-DD-MM、例子却YYYY-MM-DD；保留原串与实际解析规则，出现无法辨别的日期时停止匹配，不能静默交换月日。

核对结果：每一行能对应同一UTC窗口或块高；歧义日期单列，没有按数组索引盲目合并。
依据：[CryptoQuant 当前官方 OpenAPI v1](https://docs.cryptoquant.com/openapi/v1.json)
依据：[CryptoQuant 旧 ERC20 Exchange Flows 方法](https://userguide.cryptoquant.com/api/erc20-exchange-flows.md)

## 3. 按方向检查 Mean 与交易数

当前docs方法已分别写入金Total除入金交易数、出金Total除出金交易数。对齐同token/exchange/window后，用已有inflow_total与transactions_count_inflow做核对性计算；示例200/4=50个token每笔，不能除独立地址数。

旧userguide虽然文字按方向定义，显示公式却把入与出相加除Transactions Count。本页保留这个版本冲突，并按当前方法核对；这不证明旧导出或服务实现已按新公式计算。分母为0、缺失或null时不输出正常平均值。

核对结果：入/出各自分子分母清楚，零/空分母与旧公式冲突都明确记录。
依据：[CryptoQuant 当前 In/Outflow 数据方法](https://docs.cryptoquant.com/data-guide/exchange/exchange-in-outflow-and-netflow.md)
依据：[CryptoQuant 旧 User Guide Flow 公式](https://userguide.cryptoquant.com/cryptoquant-metrics/exchange/exchange-in-outflow-and-netflow.md)
依据：[CryptoQuant 当前官方 OpenAPI v1](https://docs.cryptoquant.com/openapi/v1.json)

## 4. 区分 Mean、MA7 和字段注释缺陷

Mean是对应窗的每笔均值，Mean(MA7)是7天的均值序列移动平均；不能把每日Mean简单平均冒充整段Total/整段交易数，更不能把hour的7个点自动称为7天。

当前OpenAPI的inflow_top10注释写了流出，与inflow字段名和方法描述不一致；未取得实现证据时不据此改名、反转方向或解释为top10持有人。保留字段和值，把top10细节标为未解决。

核对结果：均值聚合采用明确权重和时间粒度，top10方向缺陷不被擅自修正。
依据：[CryptoQuant 当前 In/Outflow 数据方法](https://docs.cryptoquant.com/data-guide/exchange/exchange-in-outflow-and-netflow.md)
依据：[CryptoQuant 当前官方 OpenAPI v1](https://docs.cryptoquant.com/openapi/v1.json)

## 5. 把历史修订与延迟快照分开

BTC/ERC20 namespace说明地址聚类定期更新、非PIT，可影响历史。当前catalog的ERC20 reserve/inflow latency快照measuredAt为2026-10-11且mutable=false；BTC netflow快照为2026-07-08、mutable=true。这些不同方法与日期不能混成当前统一状态。

mutable=false不能消除namespace的非PIT历史警告，也不能证明未来标签更新绝不重写历史。blockLatencySec与processLatencySec有各自含义并按resolution/averaging window给出；目录数字不是本次实时请求或每笔数据的延迟回执。

核对结果：报告带具体端点、measuredAt和窗口；未把快照当永久不变或实时服务保证。
依据：[CryptoQuant 当前官方 OpenAPI v1](https://docs.cryptoquant.com/openapi/v1.json)
依据：[CryptoQuant 当前官方指标目录快照](https://docs.cryptoquant.com/catalog/catalog.json)

## 6. 形成可复查的历史比较结果

给两份已有导出分别记录获取日期、筛选条件、UTC覆盖、Mean定义版本和标签修订边界，再列出同窗差异。仅有方法/schema时保留算术示例和待补字段，不填写实际市场数值。

已有权限错误按当前套餐检查：链上端点Professional起，hour/block通常要Premium；credits不足和吞吐限制另列。完成结果标出null、歧义日期和top10注释缺陷，不能把这些缺口消成一条“交易所平均流量已确认”。

核对结果：比较结论能追溯输入、定义和获取时间，并明确哪些是示例/文档核对而非实际响应。
依据：[CryptoQuant Data API 权限与套餐](https://www.cryptoquant.com/apis)
依据：[CryptoQuant 当前官方 OpenAPI v1](https://docs.cryptoquant.com/openapi/v1.json)
依据：[CryptoQuant 当前官方指标目录快照](https://docs.cryptoquant.com/catalog/catalog.json)
依据：[CryptoQuant 当前 In/Outflow 数据方法](https://docs.cryptoquant.com/data-guide/exchange/exchange-in-outflow-and-netflow.md)

## 常见错误
- 不要把地址数当交易数，或把交易数直接当用户数。
- catalog快照、标签历史修订和最新完整窗口是不同问题，不能用一个mutable布尔概括全部。

## 完成检查
- 完成有方向分母、UTC窗口、版本与修订边界的历史核对记录。
- 本轮只阅读官方方法/目录，未调用认证API或实际latency端点，也未使用账户图表。

## 相关知识
- [链上指标历史数值为什么会变？](https://lianxiaozhi.com/learn/point-in-time-metrics)
- [TVL、交易额和资金流入有什么区别？](https://lianxiaozhi.com/learn/tvl-volume-and-flows)
- [原始、解码和整理后的链上数据有什么区别？](https://lianxiaozhi.com/learn/raw-decoded-curated-data)

## 官方依据
- [CryptoQuant 当前官方 OpenAPI v1](https://docs.cryptoquant.com/openapi/v1.json)
- [CryptoQuant 旧 ERC20 Exchange Flows 方法](https://userguide.cryptoquant.com/api/erc20-exchange-flows.md)
- [CryptoQuant Data API 权限与套餐](https://www.cryptoquant.com/apis)
- [CryptoQuant 当前 In/Outflow 数据方法](https://docs.cryptoquant.com/data-guide/exchange/exchange-in-outflow-and-netflow.md)
- [CryptoQuant 旧 User Guide Flow 公式](https://userguide.cryptoquant.com/cryptoquant-metrics/exchange/exchange-in-outflow-and-netflow.md)
- [CryptoQuant 当前官方指标目录快照](https://docs.cryptoquant.com/catalog/catalog.json)