加密货币价格提醒

监控加密货币价格，并在达到设定目标时接收提醒。无需 API 密钥 —— 使用 CoinGecko 的免费 API。

功能说明

• 查询 BTC、ETH、SOL 及 100+ 种代币的当前价格
• 与您配置的阈值进行比对
• 当价格上穿/下破目标值时触发提醒
• 支持百分比变动检测（例如：“若 BTC 在 1 小时内下跌 5%，则发出提醒”）
• 可单次运行，也可按计划（cron）定时执行

快速开始

查询单个价格

# 直接调用 API（无需认证）
curl "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum,solana&vs_currencies=usd&include_24hr_change=true"

获取更详细信息

curl "https://api.coingecko.com/api/v3/coins/bitcoin?localization=false&tickers=false&community_data=false&developer_data=false&sparkline=false"

提醒配置

创建一个 crypto-alerts.json 文件：

{
  "alerts": [
    {
      "coin": "bitcoin",
      "symbol": "btc",
      "condition": "below",
      "price": 85000,
      "message": "BTC 跌破 $85K！"
    },
    {
      "coin": "bitcoin",
      "symbol": "btc",
      "condition": "above",
      "price": 100000,
      "message": "BTC 上穿 $100K！🚀"
    },
    {
      "coin": "ethereum",
      "symbol": "eth",
      "condition": "below",
      "price": 3000,
      "message": "ETH 跌至 $3K 以下"
    },
    {
      "coin": "solana",
      "symbol": "sol",
      "condition": "above",
      "price": 200,
      "message": "SOL 突破 $200！"
    }
  ],
  "telegram_bot_token": "YOUR_BOT_TOKEN",
  "telegram_chat_id": "YOUR_CHAT_ID"
}

Python 提醒脚本

保存为 crypto_alert.py：

#!/usr/bin/env python3
import requests
import json
import sys
import os
from datetime import datetime

COINGECKO_API = "https://api.coingecko.com/api/v3"

def get_price(coin_id):
    url = f"{COINGECKO_API}/simple/price"
    params = {
        "ids": coin_id,
        "vs_currencies": "usd",
        "include_24hr_change": "true",
        "include_last_updated_at": "true"
    }
    r = requests.get(url, params=params, timeout=10)
    r.raise_for_status()
    data = r.json()
    return data[coin_id]["usd"], data[coin_id].get("usd_24h_change", 0)

def check_alerts(alerts_config):
    triggered = []
    for alert in alerts_config.get("alerts", []):
        coin = alert["coin"]
        condition = alert["condition"]
        target = alert["price"]
        message = alert["message"]
        
        try:
            price, change_24h = get_price(coin)
        except Exception as e:
            print(f"Error fetching {coin}: {e}")
            continue
        
        should_fire = False
        if condition == "above" and price >= target:
            should_fire = True
        elif condition == "below" and price <= target:
            should_fire = True
        
        if should_fire:
            triggered.append({
                "coin": coin,
                "price": price,
                "target": target,
                "condition": condition,
                "message": message,
                "change_24h": change_24h,
                "time": datetime.now().isoformat()
            })
            print(f"🚨 ALERT: {message} (Current: ${price:,.2f})")
        else:
            print(f"  {coin.upper()}: ${price:,.2f} (24h: {change_24h:+.2f}%) — {condition} ${target:,.2f}: {'✓' if should_fire else 'not triggered'}")
    
    return triggered

def send_telegram(message, bot_token, chat_id):
    if not bot_token or not chat_id:
        return
    url = f"https://api.telegram.org/bot{bot_token}/sendMessage"
    payload = {"chat_id": chat_id, "text": message, "parse_mode": "HTML"}
    requests.post(url, json=payload, timeout=10)

if __name__ == "__main__":
    config_path = os.path.join(os.path.dirname(__file__), "crypto-alerts.json")
    
    if len(sys.argv) > 1:
        config_path = sys.argv[1]
    
    if os.path.exists(config_path):
        with open(config_path) as f:
            config = json.load(f)
    else:
        print("No crypto-alerts.json found. Using default BTC/ETH/SOL check.")
        config = {
            "alerts": [
                {"coin": "bitcoin", "symbol": "btc", "condition": "above", "price": 0},
                {"coin": "ethereum", "symbol": "eth", "condition": "above", "price": 0},
                {"coin": "solana", "symbol": "sol", "condition": "above", "price": 0}
            ]
        }
    
    triggered = check_alerts(config)
    
    if triggered:
        summary = "🚨 Crypto Alert Triggered\n\n"
        for t in triggered:
            summary += f"{t['message']}\n"
            summary += f"Price: ${t['price']:,.2f} | 24h: {t['change_24h']:+.2f}%\n\n"
        
        bot_token = config.get("telegram_bot_token")
        chat_id = config.get("telegram_chat_id")
        if bot_token and chat_id:
            send_telegram(summary, bot_token, chat_id)
        
        with open("/tmp/crypto_alerts_triggered.json", "a") as f:
            f.write(json.dumps({"triggered": triggered, "time": datetime.now().isoformat()}) + "\n")

使用示例

单次运行

python3 crypto_alert.py

定时运行（Cron）

# 每 15 分钟执行一次
*/15 * * * * cd /path/to/skill && python3 crypto_alert.py >> /tmp/crypto_alerts.log 2>&1

# 每小时第 0 分钟执行一次
0 * * * * cd /path/to/skill && python3 crypto_alert.py >> /tmp/crypto_alerts.log 2>&1

查询特定代币

# Bitcoin
curl "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd&include_24hr_change=true"

# 多个代币
curl "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum,solana,cardano,polkadot,avalanche-2,chainlink&vs_currencies=usd&include_24hr_change=true"

支持的代币（常用 ID）

完整列表请访问：curl https://api.coingecko.com/api/v3/coins/list?per_page=250

提醒条件

• above — 当价格 >= 目标值时触发
• below — 当价格 <= 目标值时触发
• percent_up — 当 24 小时涨跌幅 > X% 时触发（需添加 percent_threshold 字段）
• percent_down — 当 24 小时涨跌幅 < -X% 时触发（需添加 percent_threshold 字段）

速率限制

CoinGecko 免费 API 限制：

• 约 10–30 次请求/分钟
• 每月 10,000–50,000 次请求
• 如需高频检查，请启用缓存
• 为确保安全，可在请求之间添加 sleep(1.2)

依赖要求

• requests Python 库（pip install requests）
• CoinGecko API（免费，无需密钥）
• 可选：Telegram Bot 用于推送通知
• 可选：cron 实现定时监控

使用建议

1. 避免频繁轮询 —— 对大多数场景而言，15 分钟间隔已足够
2. 缓存价格数据 —— 保存上次检查结果，避免重复调用 API
3. 支持多重条件 —— 同一代币可同时配置多个提醒（例如“上穿”和“下破”）
4. 记录日志 —— 务必写入日志文件，便于后续回溯触发事件

基于真实加密货币监控实践构建。CoinGecko API 免费开放，但请合理、尊重地使用。