crypto-price
# Crypto Price
查询主流虚拟币实时价格、历史数据,生成趋势图和周报。
## 功能特性
- ✅ 实时价格查询(支持 10+ 主流币种)
- ✅ 历史数据查询(1-365 天)
- ✅ 单币种趋势图生成
- ✅ 多币种对比图生成
- ✅ 7 天周报自动生成
- ✅ 邮件定时推送
## 使用方法
### 1. 查询当前价格
```bash
python3 skills/crypto-price/scripts/crypto_price.py <币种代码>
```
**示例:**
```bash
python3 skills/crypto-price/scripts/crypto_price.py BTC
python3 skills/crypto-price/scripts/crypto_price.py ETH
```
### 2. 查询历史价格
```bash
python3 skills/crypto-price/scripts/crypto_price.py <币种代码> --history <天数>
```
**示例:**
```bash
python3 skills/crypto-price/scripts/crypto_price.py BTC --history 3
python3 skills/crypto-price/scripts/crypto_price.py ETH --history 7
```
### 3. 生成单币种趋势图
```bash
python3 skills/crypto-price/scripts/crypto_price.py <币种代码> --chart <天数>
```
**示例:**
```bash
python3 skills/crypto-price/scripts/crypto_price.py BTC --chart 3
python3 skills/crypto-price/scripts/crypto_price.py ETH --chart 7
```
### 4. 生成多币种对比图
```bash
python3 skills/crypto-price/scripts/crypto_price.py BTC --compare <币种 1,币种 2,...> <天数>
```
**示例:**
```bash
python3 skills/crypto-price/scripts/crypto_price.py BTC --compare BTC,ETH,SOL 3
python3 skills/crypto-price/scripts/crypto_price.py BTC --compare BTC,ETH,BNB,SOL,DOGE 7
```
### 5. 生成周报并发送邮件
```bash
# 配置环境变量(首次使用)
export EMAIL_SENDER="your_email@126.com"
export EMAIL_SENDER_NAME="Your Name"
export EMAIL_PASSWORD="your_smtp_password"
export EMAIL_RECIPIENT="recipient@example.com"
# 生成并发送周报
python3 skills/crypto-price/scripts/crypto_weekly_report.py
```
**永久配置(添加到 ~/.zshrc):**
```bash
echo 'export EMAIL_SENDER="your_email@126.com"' >> ~/.zshrc
echo 'export EMAIL_SENDER_NAME="Your Name"' >> ~/.zshrc
echo 'export EMAIL_PASSWORD="your_smtp_password"' >> ~/.zshrc
echo 'export EMAIL_RECIPIENT="recipient@example.com"' >> ~/.zshrc
source ~/.zshrc
```
**⚠️ 安全提示:**
- 不要将邮箱密码提交到 Git
- 使用 `.env` 文件或环境变量存储敏感信息
- 定期更换 SMTP 授权码
## 支持的币种
| 代码 | 币种 | 代码 | 币种 |
|------|------|------|------|
| BTC | 比特币 | SOL | Solana |
| ETH | 以太坊 | XRP | 瑞波币 |
| USDT | 泰达币 | ADA | 艾达币 |
| BNB | 币安币 | DOGE | 狗狗币 |
| DOT | 波卡币 | MATIC | Polygon |
## 输出示例
### 当前价格
```
📊 BTC 价格信息
========================================
💵 美元价格: $73,246.00
💴 人民币价格: ¥505,100.00
📈 24h 涨跌: +1.97%
🏦 市值: $1.46T
========================================
```
### 历史价格
```
📈 BTC 3 天历史价格
========================================
03-14: $70,965.28
03-15: $71,217.10
03-16: $72,681.91
========================================
```
## 定时任务配置
### 每天上午 10 点发送周报
```bash
# 添加到 crontab
0 10 * * * cd /Users/admin/.openclaw/workspace && python3 skills/crypto-price/scripts/crypto_weekly_report.py
```
或使用 OpenClaw cron:
```bash
openclaw cron add --schedule "0 10 * * *" --command "python3 skills/crypto-price/scripts/crypto_weekly_report.py"
```
## 注意事项
1. **API 限制**: CoinGecko 免费 API 有速率限制(10-50 次/分钟)
2. **数据延迟**: 价格数据延迟约 1-5 分钟
3. **matplotlib**: 生成图表需要安装 matplotlib
4. **邮箱配置**: 邮件发送需要配置 126 邮箱 SMTP
## 依赖安装
```bash
# 安装 matplotlib(图表生成)
pip3 install matplotlib --break-system-packages --user
# 或
brew install python-matplotlib
```
## 文件结构
```
crypto-price/
├── SKILL.md
└── scripts/
├── crypto_price.py # 主脚本(价格查询、图表生成)
└── crypto_weekly_report.py # 周报生成和邮件发送
```
## 数据来源
- **价格数据**: CoinGecko API (https://www.coingecko.com/)
- **免费无需 API Key**: 是
- **更新频率**: 实时(延迟 1-5 分钟)
标签
skill
ai