Crypto Market Monitor

完整的加密货币市场监控系统，支持价格追踪、经济数据发布日程查看及影响分析。

安装

快速安装：

clawhub install crypto-market

如需手动安装，请参阅 INSTALL.md。

快速上手

价格监控

实时监控 13 种主流加密货币（BTC、ETH、XRP、BNB、SOL、ADA、AVAX、DOGE、TRX、LINK、SUI、WLFI、XAUT），包含实时价格、波动率告警（±5%）、市场情绪分析及 EMA 技术指标。

在您的 crypto workspace 中执行：

cd scripts
python3 crypto_monitor_telegram.py

经济数据报告

查看未来 7 天内即将发布的经济数据（含重要性等级：高/中）及倒计时提醒。

在您的 crypto workspace 中执行：

cd economic
python3 daily_economic_report_v2.py

经济数据分析

更新实际值

当经济数据正式发布后，更新其实际值，以触发自动多空影响分析。

在您的 crypto workspace 中执行：

cd economic
python3 update_economic_data.py update "数据名称" "实际值" --datetime "发布时间"

示例：

# CPI 数据（数值越低越利多）
python3 update_economic_data.py update "CPI 消费者价格指数" "2.1%" --datetime "2026-03-13 21:30"

# NFP 数据（数值越高越利多）
python3 update_economic_data.py update "非农就业数据" "+280K" --datetime "2026-03-14 21:30"

# GDP 数据（数值越高越利多）
python3 update_economic_data.py update "GDP 季度报告" "1.8%" --datetime "2026-03-20 21:30"

# 失业率（数值越低越利多）
python3 update_economic_data.py update "失业率" "4.0%" --datetime "2026-03-14 21:30"

快速分析（不保存）

对经济数据进行影响分析，但不写入数据库。

python3 update_economic_data.py analyze "数据名称" "实际值" "预期值" "前值"

示例：

python3 update_economic_data.py analyze "CPI" "2.1%" "2.3%" "2.4%"

查看已更新的数据

列出所有已填入实际值的经济数据。

python3 update_economic_data.py list

多空影响分析

利多指标（数值越高越利多）🟢

• 非农就业数据（NFP）
• GDP
• 零售销售（Retail Sales）
• ADP 就业数据（ADP Employment）
• 制造业 PMI（Manufacturing PMI）
• 服务业 PMI（Services PMI）

判定规则： 实际值 > 预期值（偏差 ≥ +2%）→ 利多

利空转利多指标（数值越低越利多）🟢

• CPI（通胀）
• PPI（生产者价格指数）
• 失业率（Unemployment Rate）
• 利率（FOMC）

判定规则： 实际值 < 预期值（偏差 ≤ −2%）→ 利多（缓解市场压力）

定时报告

每日经济报告

• 时间： 每日 08:00
• 内容： 未来 7 天经济数据发布日程预测
• 格式： 仅展示高重要性事件，含预期值/前值及倒计时

综合监控

• 时间： 每 30 分钟一次
• 内容： 加密货币价格 + 经济数据发布提醒
• 功能： 波动率告警、市场情绪分析、EMA 技术指标

默认工作区结构

crypto/                    # 您的 crypto workspace
├── economic/            # 经济数据相关脚本
├── scripts/             # 监控类脚本
├── data/                # 数据存储目录（actual_data.json）
└── logs/                # 日志文件

数据类型

高重要性数据

• 非农就业数据（NFP）——每月第一个周五，21:30
• CPI —— 每月月中，21:30
• FOMC 利率决议 —— 每季度一次，02:00
• GDP —— 每季度末，21:30
• 失业率 —— 每月第一个周五，21:30

中重要性数据

• ADP 就业数据 —— 每月第一个周三，21:15
• 零售销售 —— 每月月中，21:30
• 制造业 PMI —— 每月首日，22:00
• 服务业 PMI —— 每月首日，22:00
• PPI —— 每月月中，21:30

各指标详细说明请参阅 data-types.md。

脚本说明

核心模块（位于 economic/ 目录下）：

• economic_calendar.py —— 经济日历管理
• economic_analyzer.py —— 多空影响分析引擎
• update_economic_data.py —— 实际值管理工具

监控脚本（位于 scripts/ 目录下）：

• crypto_monitor_telegram.py —— 价格监控 + 经济数据集成

参考文档：

• quick-reference.md —— 命令速查表
• data-types.md —— 各经济指标详解
• usage-examples.md —— 真实场景使用示例

自定义配置

更换工作区路径

可直接修改脚本中的路径，或创建配置文件。具体方法详见 INSTALL.md。

修改告警阈值

编辑 scripts/crypto_monitor_telegram.py 文件：

ALERT_THRESHOLD = 5.0  # 修改为您偏好的阈值

添加/移除代币

编辑 scripts/crypto_monitor_telegram.py 中的 TOKENS 字典。

重要说明

1. 时区： 所有时间均采用 Asia/Shanghai（北京时间）
2. 数据存储： 实际值将保存至 data/actual_data.json
3. 影响分析： 基于实际值与预期值的偏差，自动判定多空影响方向
4. 告警阈值： 价格波动告警触发条件为 ±5% 变动

如需详细了解安装流程、自定义方法及典型使用场景，请查阅 INSTALL.md 和 usage-examples.md。