如何创建每周加密市场报告：分步指南
周度市场报告与盯盘是两码事。前者是一个具有固定时间窗口的文档，而后者是一种没有终点的习惯。
本指南将介绍如何构建该文档。它将逐步引导您确定固定时间窗口、提取所需字段以及如何构建波动排行表。此外，它还将介绍如何让下周的加密货币市场报告只需几分钟即可完成，而不是耗费一整个下午。
这只是一个报告工作流程，不构成投资或税务建议。 本文不包含任何价格预测，以下任何数据均不应被视为买卖任何资产的建议。
周度加密货币市场报告的用途
它的定位非常明确，而保持这种明确性正是让报告具有可读性的关键。
周度加密货币市场报告只回答一个问题：在过去七天里，发生了什么变化，变化幅度有多大？
它不回答接下来会发生什么。预测是另一种文档，承担着不同的职责。将两者混为一谈会降低两部分内容的可信度。
受众同样重要。在周一早上分发的加密货币市场报告通常在 90 秒内就会被看完，因此它需要一个固定的版式，让读者看一次就能熟悉。
开始前需要准备的工作
四个只需决定一次、之后每周复用的要素。
资产范围。 哪些资产属于报告范围，依据什么规则。例如，“市值前 25 名”是一项规则；而“手动挑选的列表”则是一种容易发生偏差的个人偏好。
时间窗口。 确切的七天截止时间。如果一份报告仅标注“本周”而没有明确的截止时间，那么数据将无法复现。
基准货币。 所有数据均使用同一种货币，并在页面上明确注明。
数据源。 明确命名一个数据源，并在记录数据的同时捕获其自带的时间戳。
最后一点往往容易被人们忽略。两个不同的数据源在细节上总会存在差异，读者一旦发现这种偏差，就会对整个页面的内容失去信任。
确定时间窗口和截止时间
选择一个截止时间，并且永远不要更改。周日 23:59 UTC 是一个不错的选择，因为跨时区时它不会产生歧义。
在报告中写明截止时间。例如，“截至 2026 年 8 月 24 日周日 23:59 UTC 的一周”是可复现的，而“上周”则不是。
然后单独记录数据源自身的时间戳。市场数据 API 会报告每个资产的更新时间，这与您执行数据提取的时间并不相同。
CoinGecko 的市场端点会返回每个资产的 last_updated 值。将其与您的数据保存在一起，可以让您在一个月后轻松回答“为什么这与交易所的数据不同”的问题。
提取市场数据
CoinGecko API 提供了一个几乎涵盖周报所需一切的单一端点。其带有市场数据的 coins list with market data 端点被描述为一种查询支持的代币“价格、市值、交易量和市场相关数据”的方法。
响应数据直接包含了周视图。除了 current_price、market_cap、market_cap_rank 和 total_volume 之外，它还会返回多个时间窗口内的百分比变化。
您需要的字段名称与其功能完全对应。price_change_percentage_7d_in_currency 表示您所选基准货币的 7 天价格变动，而 sparkline_in_7d 则呈现了该周的价格走势图。
获取访问权限只需简单的设置。CoinGecko 关于设置 API 密钥的指南介绍了如何注册、打开开发者控制面板（Developer Dashboard）以及添加新密钥。
身份验证方式取决于您的方案。CoinGecko 为付费方案（包括 Basic、Analyst、Lite、Pro、Pro+ 和 Enterprise）提供了 Pro 路由，并为免费方案提供了单独的 Demo 路由。
在进行任何自动化操作之前，请先养成处理两种错误状态的习惯。CoinGecko 的错误和速率限制页面将 429 错误记录为“超出速率限制。请降低调用频率或升级您的方案”，将 401 错误记录为 API 密钥缺失或无效。
503 错误条目值得多读几遍。它会引导您访问公共状态页面，这意味着报告内容为空有时是因为服务中断，而不是您的代码出现了 bug。
构建波动排行表
表格是加密货币市场报告的核心。其他一切都只是辅助框架。
报告由六个列组成，增加第七个列通常得不偿失。
| 列 | 数据源字段 | 包含该列的原因 |
|---|---|---|
| 资产 | name 和 symbol |
读者浏览的是代币符号，而不是 ID |
| 排名 | market_cap_rank |
区分大盘波动与小币种的噪音 |
| 价格 | current_price |
核心参考数据，以一种指定的货币表示 |
| 7 天变化 | price_change_percentage_7d_in_currency |
周报的实际主题 |
| 交易量 | total_volume |
交易量低迷时的波动性质完全不同 |
| 市值 | market_cap |
为波动提供规模感 |
按 7 天变化进行排序，并展示两端的数据。展示前 5 名和后 5 名比单纯展示前 10 名能提供更全面的信息。
这一选择比看起来更重要。单边列表读起来就像是精彩集锦，而周度加密货币市场报告应该描述整个时间窗口的完整情况。
两条规则可以保证表格的客观性：显示排名，以免人们将微型市值代币的波动误认为是重大市场事件；显示交易量，以免人们将低交易量下的波动误认为是市场共识。
保持舍入规则一致。对于一份人们只需 90 秒就能读完的文档，百分比保留两位小数，市值保留整数单位就足够了。
撰写支撑报告的三句话
没有文字导读的表格很容易被草草扫过并被误记。三句话可以解决这个问题，而且三句话就是上限。
第一句：总体情况。 您设定的资产范围的总市值及其 7 天变化。
第二句：分化程度。 范围内表现最好和最差的资产之间的差距有多大。
第三句：异常情况。 走势不符合常规规律的单一资产，并附带其交易量数据。
请根据表格内容撰写，而不是凭记忆。这三句话中的每一个数字都应该能追溯到上方表格的单元格中。
坚决不要写第四句来解释原因。归因是一项研究任务，而一份带有推测性质的周报很容易过时。
实现每周自动更新
第一期报告可能需要花费一个下午的时间。但从第二期开始，应该只需要几分钟，而这只有在您固定了加密货币市场报告的版式后才能实现。
在引入自动化之前，需要先固定三件事：资产范围规则、时间窗口和列清单。
一旦这些固定下来，每周的工作就只剩下提取数据和审核。定时任务会处理数据提取，而您的工作将缩减为在报告发布前浏览一下表格。
Powerdrill Bloom 公布了每个方案的定时任务限制。免费版支持 1 个定时任务，Pro 版支持 20 个，这足够用于一份周报以及一系列其他循环任务。
无论如何，请保留审核步骤。一份在发送前无人阅读的自动化报告，很容易将过时的时间戳呈现在受众面前。
开始使用 Powerdrill Bloom
步骤 1：上传导出的市场数据
拖入您提取的文件。Powerdrill Bloom 会在文件导入时分析各列，因此在绘制任何表格之前，缺失的资产、混合的类型和重复的代币符号都会显现出来。
步骤 2：用自然语言描述报告
明确说明交付成果，而不是查询语句。指明资产范围规则、时间窗口、基准货币以及您需要的六个列。
然后进一步细化。询问哪些资产因数据缺失而被剔除，并询问总市值与什么数据相符。
步骤 3：导出表格和三句话总结
将波动排行表和文字导读一起导出。我们关于分析加密货币交易所 CSV 导出数据的指南介绍了如何将同样的方法应用于您自己的交易历史。
在去定价页面对比方案之前，可以先从免费版开始。如果合适，可以尝试在真实的数据提取（而非示例数据）中体验 Powerdrill Bloom。
结论
周度加密货币市场报告本质上是一个披着市场数据外衣的可复现性练习。确定资产范围、确定时间窗口、指明数据源，文档自然就水到渠成了。
最重要的两个习惯其实非常朴实无华：将数据源自身的时间戳与您的数据保存在一起，并且永远不要让报告对下周进行推测。
做到这一点，第二份加密货币市场报告就只需花费几分钟时间。我们关于分析加密货币投资组合 CSV 和在电子表格中跟踪加密货币钱包交易的指南涵盖了个人数据方面的内容。而 AI crypto analyst 页面则介绍了相关工具。
常见问题解答
周度加密货币市场报告应该使用什么时间窗口？
选择一个固定的截止时间并坚持使用，例如周日 23:59 UTC。明确的截止时间能让报告具有可复现性，而“上周”则不能。
我实际需要哪些字段？
资产名称和符号、市值排名、当前价格、7 天百分比变化、总交易量和市值。CoinGecko 的市场端点会在一次响应中返回所有这些数据。
为什么我的数据与交易所的数据不同？
聚合的市场数据与单个交易所的订单簿是不同的测量维度。将数据源自身的 last_updated 时间戳与您的数据保存在一起，可以让您解释这种差距，而不是为此争论不休。
报告中应该包含价格展望吗？
我们建议不要包含。周报描述的是一个已结束的时间窗口，混入预测会降低事实部分的可信度。
如何处理空数据或部分数据提取？
在断定是 bug 之前，请先检查状态码。CoinGecko 将 429 记录为速率限制， 401 记录为密钥缺失或无效，503 则指向其状态页面以指示服务中断。