# Coin Metrics地址活动为何不能直接比用户数？核指标、catalog与下载窗口

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

按账本活动、美元阈值及链特例定义读原指标，再核可见覆盖与分页。

## 使用工具
- [Coin Metrics](https://lianxiaozhi.com/tools/coin-metrics) · [官方入口](https://docs.coinmetrics.io/)

## 前置条件
- 准备自己已有的脱敏材料与请求参数，保留产品、日期、单位和权限说明；缺值不补零。

## 1. 固定metric而不是只写活跃度

记录asset和metric id：AdrActCnt、AdrAct7dCnt、AdrAct30dCnt都以Addresses计数、按1 Day输出，分别覆盖截至区间末尾的尾随1/7/30天。7/30天是窗口内唯一地址去重数，不能把每日AdrActCnt简单相加代替。一个人多个地址、低成本伪造活动均会影响解释。

核对结果：metric、单位、输出频率与尾随去重窗口明确；没有从地址数推自然人数。
依据：[Coin Metrics：活跃地址定义、链差异与美元阈值](https://gitbook-docs.coinmetrics.io/network-data/network-data-overview/addresses/active-addresses.md)

## 2. 核账本变化与链特例

总活跃地址统计账本变化的发送/接收双方，窗口内每地址一次；活动可包括转账、签块、挖矿/质押奖励、投票、建账户，视协议而定。ETH的零额、自转、失败交易涉及的活动及矿工收手续费均可计入，null发行地址排除。SOL包括owner和sub accounts；隐私完整链如Monero/Grin不提供此指标，ZCash仅非隐私活动，不用跨链相同名字推相同人群。

核对结果：原链、活动范围和排除规则保存；失败交易相关活动未误当成功经济转账。
依据：[Coin Metrics：活跃地址定义、链差异与美元阈值](https://gitbook-docs.coinmetrics.io/network-data/network-data-overview/addresses/active-addresses.md)

## 3. 经济阈值按单次转移核

AdrActUSD1Cnt要求区间内至少一次native转移按当天PriceUSD折算大于1美元，不能把多次小额先合计。文档例十次每笔0.11美元合计1.10仍不计，十次各1 BTC只记一地址；没有原交易和计价资料时只核定义，不计算本人结果。

核对结果：严格大于1美元、当天价格与单次转移门槛明确，地址仍只计一次。
依据：[Coin Metrics：活跃地址定义、链差异与美元阈值](https://gitbook-docs.coinmetrics.io/network-data/network-data-overview/addresses/active-addresses.md)

## 4. catalog-all不当本人权限

旧Community walkthrough中不带key的客户端示例为btc/eth；catalog返回当前key可用数据，catalog-all返回全数据集，两个集合不同。保存当前已有catalog的asset、metrics、频率/时间范围，不把旧例147/696等数量当当前套餐。文档所列某链指标存在，也不代表Community可取得它或任意频率。

核对结果：数据集存在、本人可见与实际响应分别记录；旧例数量没有变成今日覆盖。
依据：[Coin Metrics：Community示例与catalog/catalog-all区别](https://gitbook-docs.coinmetrics.io/tutorials-and-examples/tutorials/walkthrough_community.md)

## 5. 窗口、格式和限流分别验收

既有JSON记录应核start_time/end_time及next_page_url；默认page_size100、最大10,000，首100条不是完整窗口。json_stream为application/x-ndjson，逐行JSON且无需同样分页，不能当单个JSON文档。limit_per_asset示例要求page_size至少为asset数量乘每实体limit。Community10次/6秒/IP，PRO默认6,000次/20秒/key，最多10并行；429与X-RateLimit-Plan/请求错误保留，不将空值或未授权改成零活动。

核对结果：请求窗口、格式、分页/每实体范围及权限限流一致；没有靠首批数量宣布全量。
依据：[Coin Metrics：JSON分页、json_stream及实体范围](https://gitbook-docs.coinmetrics.io/tutorials-and-examples/user-guides/how-to-use-the-coin-metrics-api-efficiently-http.md)
依据：[Coin Metrics：Community/PRO限流与并行范围](https://gitbook-docs.coinmetrics.io/api-reference/rate-limits.md)

## 常见错误
- 2024.08.20客户端示例仅方法参考，本轮没有安装或运行客户端。
- 指标定义和可见范围不证明增长原因、收入、活跃自然人或市场安全。

## 完成检查
- 保存对象、原字段、窗口/版本、可核结果与未知分支；文档方法已核，实时数据与本人权限未验证。

## 相关知识

## 官方依据
- [Coin Metrics：Community示例与catalog/catalog-all区别](https://gitbook-docs.coinmetrics.io/tutorials-and-examples/tutorials/walkthrough_community.md)
- [Coin Metrics：活跃地址定义、链差异与美元阈值](https://gitbook-docs.coinmetrics.io/network-data/network-data-overview/addresses/active-addresses.md)
- [Coin Metrics：JSON分页、json_stream及实体范围](https://gitbook-docs.coinmetrics.io/tutorials-and-examples/user-guides/how-to-use-the-coin-metrics-api-efficiently-http.md)
- [Coin Metrics：Community/PRO限流与并行范围](https://gitbook-docs.coinmetrics.io/api-reference/rate-limits.md)