用途:通过命令行追踪加密货币价格、搜索币种并设置提醒,数据来自 CoinGecko 免费 API,无需 API 密钥。
主要能力:查询单个或多个币种价格,加 --detailed 可显示市值与成交量;按名称或符号搜索币种 ID;设置价格阈值提醒(above/below)和 24 小时涨跌幅提醒(change/drop/rise);列出与删除用户提醒;批量检查已触发提醒。常见符号会自动解析,如 btc→bitcoin、eth→ethereum、sol→solana、doge→dogecoin 等。
使用方式:脚本位于 {baseDir}/scripts/crypto.py,用 uv run 执行。例如查询价格:uv run {baseDir}/scripts/crypto.py price bitcoin;搜索:uv run {baseDir}/scripts/crypto.py search doge;设置提醒:uv run {baseDir}/scripts/crypto.py alert <user_id> bitcoin above 100000;查看提醒:uv run {baseDir}/scripts/crypto.py alerts <user_id>;删除:uv run {baseDir}/scripts/crypto.py alert-rm <alert_id>;检查全部提醒:uv run {baseDir}/scripts/crypto.py check-alerts。可配合 cron 定期执行 check-alerts,加 --json-output 获得机器可读输出。
适用场景:个人或机器人定时监控行情、按用户设置价格与涨跌幅通知。
限制:CoinGecko 免费层约每分钟 10-30 次请求,支持 15000+ 币种;提醒存于 {baseDir}/data/alerts.json,含按用户跟踪、重复通知冷却(默认 1 小时)和最后触发时间。其他细节暂未提供。