Crypto Market Monitor

Complete cryptocurrency market monitoring system with price tracking, economic data releases, and impact analysis.

Installation

Quick install:

clawhub install crypto-market

For manual installation, see INSTALL.md.

Quick Start

Price Monitoring

Monitor 13 major cryptocurrencies (BTC, ETH, XRP, BNB, SOL, ADA, AVAX, DOGE, TRX, LINK, SUI, WLFI, XAUT) with real-time prices, volatility alerts (±5%), market sentiment analysis, and EMA technical indicators.

From your crypto workspace:

cd scripts
python3 crypto_monitor_telegram.py

Economic Data Reports

View upcoming economic data releases (7-day forecast) with importance levels (high/medium) and countdown timers.

From your crypto workspace:

cd economic
python3 daily_economic_report_v2.py

Economic Data Analysis

Update Actual Values

When economic data is released, update actual values to trigger automatic bullish/bearish analysis.

From your crypto workspace:

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

Examples:

# CPI data (lower is bullish)
python3 update_economic_data.py update "CPI 消费者价格指数" "2.1%" --datetime "2026-03-13 21:30"

# NFP data (higher is bullish)
python3 update_economic_data.py update "非农就业数据" "+280K" --datetime "2026-03-14 21:30"

# GDP data (higher is bullish)
python3 update_economic_data.py update "GDP 季度报告" "1.8%" --datetime "2026-03-20 21:30"

# Unemployment rate (lower is bullish)
python3 update_economic_data.py update "失业率" "4.0%" --datetime "2026-03-14 21:30"

Quick Analysis (No Save)

Analyze data impact without saving to database.

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

Example:

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

View Updated Data

Check all economic data with actual values.

python3 update_economic_data.py list

Bullish/Bearish Analysis

Bullish Indicators (Higher is Bullish) 🟢

• Non-Farm Payrolls (NFP)
• GDP
• Retail Sales
• ADP Employment
• Manufacturing PMI
• Services PMI

Rule: Actual > Expected (+2%+) = Bullish

Bearish Indicators (Lower is Bullish) 🟢

• CPI (Inflation)
• PPI (Prices)
• Unemployment Rate
• Interest Rates (FOMC)

Rule: Actual < Expected (-2%+) = Bullish (pressure relief)

Scheduled Reports

Daily Economic Report

• Time: 08:00 AM daily
• Content: 7-day economic data forecast
• Format: High importance events with expected/previous values and countdown

Comprehensive Monitoring

• Time: Every 30 minutes
• Content: Crypto prices + economic data reminders
• Features: Volatility alerts, market sentiment, EMA indicators

Default Workspace Structure

crypto/                    # Your crypto workspace
├── economic/            # Economic data scripts
├── scripts/             # Monitoring scripts
├── data/                # Data storage (actual_data.json)
└── logs/                # Log files

Data Types

High Importance

• Non-Farm Payrolls (NFP) - First Friday monthly, 21:30
• CPI - Mid-month, 21:30
• FOMC Interest Rate - Quarterly, 02:00
• GDP - Quarterly end, 21:30
• Unemployment Rate - First Friday monthly, 21:30

Medium Importance

• ADP Employment - First Wednesday monthly, 21:15
• Retail Sales - Mid-month, 21:30
• Manufacturing PMI - First day monthly, 22:00
• Services PMI - First day monthly, 22:00
• PPI - Mid-month, 21:30

See data-types.md for detailed information on each indicator.

Scripts

Core modules (in economic/):

• economic_calendar.py - Economic calendar management
• economic_analyzer.py - Bullish/bearish analysis engine
• update_economic_data.py - Actual value management

Monitoring (in scripts/):

• crypto_monitor_telegram.py - Price monitoring + economic data

References:

• quick-reference.md - Command cheat sheet
• data-types.md - Economic indicator details
• usage-examples.md - Real-world scenarios

Customization

Change Workspace

Edit paths in scripts or create a config file. See INSTALL.md for details.

Modify Alert Threshold

Edit scripts/crypto_monitor_telegram.py:

ALERT_THRESHOLD = 5.0  # Change to your preferred threshold

Add/Remove Tokens

Edit scripts/crypto_monitor_telegram.py TOKENS dictionary.

Important Notes

1. Timezone: All times are Asia/Shanghai (Beijing Time)
2. Data Storage: Actual values saved to data/actual_data.json
3. Impact Analysis: Automatic bullish/bearish determination based on actual vs expected deviation
4. Alert Thresholds: Price volatility alerts trigger at ±5% change

For detailed installation, customization, and usage scenarios, see INSTALL.md and usage-examples.md.