加密货币研究（cmc-cli）

使用 cmc CLI 进行结构化单币种研究。其分析框架源自多模型机构级分析流水线，经压缩优化为单次执行工作流，任何 Claude Code 用户均可直接运行。

前提条件

本技能要求：

• cmc CLI 已安装并位于系统 PATH 中 — 安装方式请参阅 CoinMarketCap CLI 文档
• CMC_API_KEY 已通过会话环境变量提供给 Claude

若任一依赖缺失，请立即中止并报告缺失项。

适用场景

• 用户说“research BTC”、“look into SOL”、“tell me about ETH”、“coin overview”等指令
• 用户需要某特定加密资产的结构化资产画像
• 用户询问“what's happening with X”（X 为具体币种）

不适用场景

• 全市场扫描（无指定币种）→ 直接使用 cmc markets / cmc trending
• 股票分析 → cmc-cli 不支持
• 用户仅需快速查价 → 直接使用 cmc price

研究流水线

步骤 1：身份解析
    ↓
步骤 2：行情特征分析          ← 对比该币种与 BTC/ETH 的走势关系
    ↓
步骤 3：价格 + 基本面 + 链上数据    ← 单次增强调用
    ↓
步骤 4：历史价格行为         ← 7 日小时级 + 30 日日级 OHLCV 数据
    ↓
步骤 5：市场结构             ← 交易对与流动性分布
    ↓
步骤 6：市场环境             ← 全局指标 + 涨跌幅榜头部资产
    ↓
步骤 7：新闻与情绪           ← 新闻聚合 + 社区热度
    ↓
合成：结构化研究报告

执行流程

步骤 1：身份解析

# 通过符号解析为确定性的 CMC ID，供后续命令使用
cmc resolve --symbol  -o json

# 若存在歧义或未识别，先执行搜索
cmc search  -o json

提取字段：cmc_id、slug、name、symbol、rank

所有后续命令必须使用 --id （而非 --symbol），以确保结果确定性。

若身份解析失败或仍存在歧义，请中止并报告目标资产无法被清晰解析。

步骤 2：行情特征分析

本步骤用于判断该币种近期价格变动主要由整体市场驱动，还是由币种自身因素驱动。

# 一次调用获取 BTC、ETH 及目标币种价格
cmc price btc eth --id  -o json

分析逻辑 —— 比较 BTC、ETH 与目标币种的 percent_change_24h：

请记录该分类结果 —— 它将指导最终合成报告的重点侧重方向。

步骤 3：价格 + 基本面 + 链上统计数据

# 单次增强调用 —— 同时返回行情、项目信息与区块链统计
cmc price --id  --with-info --with-chain-stats -o json

从行情（quotes）中提取：价格、市值、24 小时交易量、1 小时/24 小时/7 天/30 天/90 天涨跌幅、流通供应量、总供应量、最大供应量

从项目信息（info）中提取：描述、标签（→ 所属赛道/类别）、上线日期、链接（官网、区块浏览器、GitHub、Twitter、Reddit）

从链上统计（chain_stats）中提取：共识机制、24 小时算力、24 小时 TPS、总交易数、总区块数、区块奖励

注意：--with-chain-stats 对部分代币（尤其是 ERC-20）可能返回空值。请优雅降级处理。

步骤 4：历史价格行为

# 7 日小时级 K 线（短期结构）
cmc history --id  --days 7 --ohlc --interval hourly -o json

# 30 日日级 K 线（中期趋势）
cmc history --id  --days 30 --ohlc -o json

分析框架（源自技术分析方法论）：

1. 趋势结构：识别更高高点/更高低点（上升趋势）或更低高点/更低低点（下降趋势）。标注趋势反转信号。
2. 关键价位：基于 OHLCV 数据识别支撑位（近期低点、盘整底部）与阻力位（近期高点、价格受阻点）。
3. 量价关系：价格上涨/下跌伴随成交量放大 = 趋势确认；量价背离 = 潜在反转信号。
4. 波动率评估：将近期日波动幅度（最高价−最低价）与 30 日均值对比，按该资产自身历史表现划分为高 / 中 / 低三档。

步骤 5：市场结构

# 覆盖现货与衍生品市场的头部交易对
cmc pairs  --category all --limit 20 -o json

分析要点：

• 流动性分布：哪些交易所占据主要交易量？
• 现货 vs 衍生品比例：衍生品占比高 → 投机情绪主导
• 交易对集中度：交易量集中在 1–2 家交易所 → 流动性风险升高

步骤 6：市场环境

# 全局指标（BTC 主导率、总市值、总交易量）
cmc metrics -o json

# 涨跌幅榜头部资产 —— 我们的标的是否在列？
cmc top-gainers-losers --time-period 24h --limit 20 -o json

分析要点：

• 标的 vs 市场表现：该币种是跑赢、跑输还是跟随大盘？
• BTC 主导率趋势：上升 → 风险规避（资金流入 BTC）；下降 → 风险偏好（山寨季信号）。
• 总市值轨迹：流动性环境是在扩张还是收缩？
• 赛道动量：将该币种标签与涨跌幅榜头部资产交叉比对，评估赛道轮动情况。

步骤 7：新闻与情绪

# 最新加密领域新闻
cmc news --limit 10 -o json

# 社区热度榜资产
cmc trending --limit 20 -o json

分析要点：

• 催化剂识别：是否有直接提及该标的的新闻？是否有即将发生的事件（升级、上线、合作）？
• 叙事契合度：该币种是否符合当前主流市场叙事（如 AI、RWA、L2、Meme）？
• 社交热度：该资产是否进入热度榜？排名呈上升还是下降趋势？

合成框架

在收集全部数据后，使用以下分析视角进行综合研判（各视角均源自机构级分析方法论）：

视角 1：基本面快照

评估项目内在价值驱动因素：

• 解决什么问题？ 解决方案是否具备差异化优势？
• 代币经济健康度：供应动态（通胀/通缩）、价值捕获机制（销毁、质押、手续费分红）
• 生态活力：开发者活跃度信号（GitHub 链接）、DApp 数量、社区规模
• 竞争格局：在所属赛道/类别中处于何种位置？主要竞争对手是谁？

视角 2：技术面状态

基于 OHLCV 数据，提供简明市场结构研判：

• 当前趋势方向与强度
• 最近支撑位与阻力位对应价格
• 成交量趋势（是否与价格同向？是否存在背离？）
• 短期与中期趋势是否一致或冲突

视角 3：资金流向与情绪

结合行情特征分类结果与市场环境分析：

• 若为 Market Beta：重点强调宏观环境、BTC 主导率趋势、整体市场健康度
• 若为 Idiosyncratic：重点强调项目专属催化剂、新闻事件、社交信号
• 交易量 / 市值比率作为活跃度指标
• 在涨跌幅榜中的位置

视角 4：催化剂扫描

识别可操作的信息信号：

• 具体新闻事件或公告
• 即将发生的协议升级或代币解锁（若 info/news 中有提及）
• 与当前主流叙事的契合或偏离程度
• 社交热度变化方向

视角 5：多空研判

基于数据的结构化评估，每项结论均需引用具体证据：

• 看涨理由（Bull Case）（3 条）：最具说服力的上涨依据，每条须注明数据来源
• 看跌理由（Bear Case）（3 条）：最具说服力的下跌依据，每条须注明数据来源
• 综合判断（Verdict）：依据证据权重，平衡点倾向何方？（看涨 / 中性 / 看跌）

输出格式

以结构化报告形式呈现研究成果：

#  () — 研究报告

> 生成于 cmc-cli | 

## 概览
| 指标 | 数值 |
|--------|-------|
| **排名** | #X |
| **价格** | $X |
| **市值** | $X |
| **24 小时交易量** | $X （交易量/市值：X%） |
| **24 小时 / 7 天 / 30 天涨跌幅** | X% / X% / X% |
| **流通供应量 / 最大供应量** | X / X |

## 行情特征
**分类**：Market Beta / Idiosyncratic  
- 标的 24 小时涨跌幅：X% | BTC 24 小时：X% | ETH 24 小时：X%  
- <对当前行情驱动因素的解读>

## 基本面
- **描述**：<1–2 句话>  
- **赛道/标签**：<来自 CMC 标签>  
- **代币经济**：<供应模型、价值捕获机制、突出特性>  
- **链上数据**：<共识机制、算力/TPS（如可用）>  
- **关键链接**：官网 | 区块浏览器 | GitHub | Twitter  

## 价格行为
### 短期（7 天）
- **趋势**：<方向 + 关键价位>  
- **成交量模式**：<确认中 / 背离中>  

### 中期（30 天）
- **趋势**：<方向 + 关键价位>  
- **波动率**：<相比自身历史为高 / 中 / 低>  

## 市场结构
- **头部交易所**：<按交易量排序前三>  
- **现货/衍生品占比**：<比例>  
- **流动性评估**：<集中 / 分散>  

## 市场环境
- **BTC 主导率**：X% （<上升 / 下降>）  
- **总市值**：$X （<扩张 / 收缩>）  
- **标的 vs 大盘表现**：<跑赢 / 跑输 / 同步>  

## 新闻与情绪
- **关键头条**：<最相关 2–3 条>  
- **热度榜状态**：<是否上榜？当前排名？>  
- **叙事契合度**：<是否符合当前主流市场主题？>  
- **催化剂关注**：<如有即将发生事件，请列出>  

## 综合研判

### 看涨理由
1. <含证据支撑的观点>  
2. <含证据支撑的观点>  
3. <含证据支撑的观点>  

### 看跌理由
1. <含证据支撑的观点>  
2. <含证据支撑的观点>  
3. <含证据支撑的观点>  

### 综合判断
<看涨 / 中性 / 看跌> — <1–2 句话总结证据权重平衡>  

---
> ⚠️ 本报告仅供信息参考，不构成任何投资建议。加密货币市场波动剧烈，请务必自行完成尽职调查。

并行执行指南

在完成步骤 1（身份解析）后，步骤 2 至步骤 7 之间无依赖关系。为提升执行效率，请并行运行全部 CLI 命令：

步骤 1（串行 —— 获取 cmc_id 所必需）
    ↓
步骤 2–7（全部并行执行）
    ↓
合成（串行 —— 需要全部数据输入）

提示

• 身份解析完成后，始终使用 --id 而非 --symbol —— 规避符号歧义
• 所有数据获取命令统一使用 -o json —— 结构化输出便于精准分析
• 若 --with-chain-stats 返回空值，请优雅跳过“链上数据”部分
• 合成内容须简洁、基于证据 —— 引用具体数据点，避免无依据推断
• 行情特征分析（Move Profile）是最关键的分析步骤 —— 它决定了其余所有分析的解读视角
• 对于未预置映射列表中的币种（如 BTC、ETH、SOL 等之外），可通过 cmc search + cmc resolve 准确定位