tracking-crypto-prices

用途

Tracking Crypto Prices 是一个基础型技能，为加密插件生态提供实时与历史加密货币价格数据，覆盖 10,000 多种币种。它是该生态的数据层，有 10 多个其他技能依赖它获取价格信息。

主要能力

查询一个或多个币种的当前价格，例如 BTC 或 BTC,ETH,SOL。
使用观察列表扫描预设分组，可用分组包括：top10（按市值前 10）、defi、layer2、stablecoins、memecoins。
获取历史数据：可按周期（如 30d、90d）或自定义起止日期范围查询。
输出格式：默认表格（包含币种符号、价格、24 小时涨跌、成交量、市值）；JSON（--format json，机器可读，含 prices 数组与元数据）；CSV（--output csv，导出 OHLCV 历史数据到数据目录）。
可通过配置文件自定义缓存 TTL、默认货币和自定义观察列表。

使用方式

前置依赖安装：

pip install requests pandas yfinance

可选：

pip install python-dotenv

用于 API 密钥管理。可选：从 https://www.coingecko.com/en/api 获取免费 API 密钥以获得更高速率限制，并将密钥添加到 ${CLAUDE_SKILL_DIR}/config/settings.yaml 或设置 COINGECKO_API_KEY 环境变量。

查询当前价格：

python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbols BTC,ETH,SOL

使用观察列表：

python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist top10
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist defi
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist layer2

获取历史数据：

python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC --period 30d
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC --period 90d --output csv
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol ETH --start 2024-01-01 --end 2024-12-31

配置：编辑 ${CLAUDE_SKILL_DIR}/config/settings.yaml 可自定义缓存 TTL、默认货币和自定义观察列表。完整配置参考见 references/implementation.md。

适用场景

快速查看单个或多个币种价格。
按主题分组批量扫描行情（如 DeFi、Layer 2、稳定币、模因币）。
导出历史 OHLCV 数据用于分析。
作为其他依赖价格数据的技能（如投资组合类技能）的数据来源。

限制与错误处理

未知符号：无效代码，需检查拼写，可用 --list 搜索。
速率限制超出：API 调用过多，等待 60 秒，或添加 API 密钥以获得更高限制。
网络错误：无网络连接，检查连接；会自动使用缓存数据。
缓存过期：数据超过 TTL，会显示警告，并在下次调用时刷新。

该技能自动管理速率限制：优先使用缓存、指数退避、yfinance 回退，最后以过期缓存兜底。

资源

${CLAUDE_SKILL_DIR}/references/implementation.md：输出格式、完整配置、集成指南、文件映射。
CoinGecko API：主要数据源。
yfinance：历史数据的回退来源。

技能介绍

用途

主要能力

使用方式

适用场景

限制与错误处理

资源