cryptowatch

# ₿ CryptoWatch - 加密货币监控

**Never Miss a Pump** - 实时追踪币价，猎杀每个波动！

## Overview

CryptoWatch 实时监控主流加密货币价格（BTC、ETH、SOL 等），支持价格预警、涨跌幅追踪、市值排行等功能。数据来自 CoinGecko API（免费、无需 API Key）。

## Features

- 📊 **实时价格** - 秒级更新，支持 100+ 加密货币
- 🚨 **价格预警** - 突破设定价位自动提醒
- 📈 **涨跌幅** - 24h/7d/30d 涨跌追踪
- 💰 **市值排行** - 按市值/音量排序
- 🔔 **多币种** - BTC、ETH、SOL、BNB、XRP 等主流币
- 🌐 **多法币** - USD、CNY、EUR、JPY 支持

## Installation

```bash
npx @gztanht/cryptowatch
```

## Usage

### 查看实时价格

```bash
# 查询单个币种
node scripts/watch.mjs btc

# 查询多个币种
node scripts/watch.mjs btc,eth,sol

# 查看所有主流币
node scripts/watch.mjs --top 20
```

### 设置价格预警

```bash
# BTC 突破 $100,000 提醒
node scripts/alert.mjs btc --above 100000

# ETH 跌破 $3,000 提醒
node scripts/alert.mjs eth --below 3000

# 查看已设置的预警
node scripts/alert.mjs --list
```

### 查看涨跌幅排行

```bash
# 24 小时涨幅榜
node scripts/rank.mjs --period 24h

# 7 日跌幅榜
node scripts/rank.mjs --period 7d --order asc
```

## Configuration

编辑 `config/coins.json` 添加自定义币种：

```json
{
  "watchlist": [
    {"id": "bitcoin", "symbol": "BTC", "name": "Bitcoin"},
    {"id": "ethereum", "symbol": "ETH", "name": "Ethereum"},
    {"id": "solana", "symbol": "SOL", "name": "Solana"}
  ]
}
```

## API Reference

- **CoinGecko API** - https://www.coingecko.com/en/api
- 免费 tier：10-50 calls/min，无需 API Key
- 数据延迟：< 30 秒

## Support

- 📧 Email: support@cryptowatch.shark
- 💬 Telegram: @CryptoWatchBot
- 🦈 赞助：USDT (ERC20): `0x33f943e71c7b7c4e88802a68e62cca91dab65ad9`

## License

MIT © 2026 gztanht

# ₿ CryptoWatch

**Real-Time Cryptocurrency Price Monitor** - Track BTC, ETH, SOL and 25+ coins instantly!

[![Version](https://img.shields.io/github/v/release/gztanht/cryptowatch)](https://github.com/gztanht/cryptowatch/releases)
[![License](https://img.shields.io/github/license/gztanht/cryptowatch)](LICENSE)
[![ClawHub](https://img.shields.io/badge/ClawHub-cryptowatch-blue)](https://clawhub.com/skills/cryptowatch)

> **Never Miss a Pump** - Real-time price tracking with instant alerts! ₿

---

## 🌟 Features

- **Live Price Tracking** - 25+ cryptocurrencies via CoinGecko API
- **Price Alerts** - Get notified when price hits your target
- **24h Change** - Track gains/losses with color indicators
- **Market Cap Ranking** - Top 20/50/100 by market cap
- **Multi-Currency** - USD, CNY, EUR support
- **Volume Data** - 24h trading volume
- **Lightning Fast** - < 30 second data delay

---

## 🚀 Quick Start

```bash
# Install
npx @gztanht/cryptowatch

# Check BTC, ETH, SOL prices
node scripts/watch.mjs btc,eth,sol

# View top 20 by market cap
node scripts/watch.mjs --top 20

# Set price alert
node scripts/alert.mjs btc --above 100000
node scripts/alert.mjs eth --below 3000

# List all alerts
node scripts/alert.mjs --list
```

---

## 📊 Example Output

```bash
$ node scripts/watch.mjs btc,eth,sol

₿ CryptoWatch - Live Prices

Coin    Price        24h Change    Market Cap    24h Volume
────────────────────────────────────────────────────────────────
BTC     $71,177.00   🔴 -2.44%     $1.42T        $64.10B
ETH     $2,077.72    🔴 -3.08%     $250.37B      $26.37B
SOL     $88.51       🔴 -3.45%     $50.39B       $5.51B

💡 Tip: node scripts/watch.mjs --top 20 for market ranking
```

---

## 💰 Pricing - Free First!

| Plan | Price | Limit |
|------|-------|-------|
| **Free** | $0 | **5 queries/day** |
| **Sponsor Unlock** | 0.5 USDT or 0.5 USDC | Unlimited |

### Sponsorship Addresses

- **USDT (ERC20)**: `0x33f943e71c7b7c4e88802a68e62cca91dab65ad9`
- **USDC (ERC20)**: `0xcb...