追踪加密货币投资组合
概述
使用实时的 CoinGecko 估值、配置分析、盈亏跟踪和集中度风险警报来追踪您的加密货币持有量。
前提条件
- 已安装 Python 3.8+
- 依赖项:
pip install requests - 互联网连接,以便访问 CoinGecko API
- 一个包含您持有量的投资组合 JSON 文件(格式参见
references/implementation.md)
使用说明
-
评估用户意图 - 确定需要哪种投资组合视图:
- 快速查看:总价值与主要持有量
- 持有量列表:所有头寸的完整细分
- 详细分析:配置、盈亏、风险标记
- 导出:用于外部工具的 JSON 或 CSV 格式
-
使用适当的选项运行投资组合追踪器:
# 快速投资组合摘要 python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json # 完整持有量细分 python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings # 包含盈亏与配置的详细分析 python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed -
导出结果,用于分析工具或税务报告:
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format json --output portfolio_export.json python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format csv --output portfolio.csv -
向用户展示结果:
- 突出显示总投资组合价值
- 强调 24 小时和 7 天的变化
- 解释配置百分比
- 标记任何集中度风险(默认情况下,持仓超过 25% 时发出警报)
输出
显示总价值、24h/7d 变化、每种资产的配置以及超过阈值的集中度警告的摘要:
================================================================================
加密货币投资组合追踪器 更新于:2026-01-14 15:30 # 2026 - 当前年份时间戳
================================================================================
投资组合摘要:我的投资组合
--------------------------------------------------------------------------------
总价值: $125,450.00 USD
24小时变化: +$2,540.50 (+2.07%)
7天变化: +$8,125.00 (+6.92%)
持有资产: 8 种
主要持有量
--------------------------------------------------------------------------------
币种 数量 价格 价值 配置 24h
BTC 0.500 $95,000.00 $47,500.00 37.9% +2.5%
ETH 10.000 $3,200.00 $32,000.00 25.5% +1.8%
SOL 100.000 $180.00 $18,000.00 14.4% +4.2%
警告:BTC (37.9%) 超过 25% 阈值
================================================================================
错误处理
| 错误 | 原因 | 解决方案 |
|---|---|---|
| 投资组合文件未找到 | 路径无效 | 检查文件路径是否存在 |
| JSON 无效 | 文件格式错误 | 验证 JSON 语法 |
| 币种未找到 | 未知符号 | 检查符号拼写,使用标准符号 |
| API 速率受限 | 请求过多 | 等待并重试,使用缓存 |
请参阅 ${CLAUDE_SKILL_DIR}/references/errors.md 了解全面的错误处理。
示例
从快速检查到详细分析和导出的投资组合追踪工作流程:
# 基本投资组合检查
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio ~/crypto/holdings.json
# 按配置排序的所有持有量
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings --sort allocation
# 使用自定义 15% 阈值的详细分析
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed --threshold 15
# 导出用于税务软件
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format csv --output tax_export.csv
资源
${CLAUDE_SKILL_DIR}/references/implementation.md- 投资组合文件格式、CLI 选项、配置阈值、JSON 格式${CLAUDE_SKILL_DIR}/references/errors.md- 全面的错误处理${CLAUDE_SKILL_DIR}/references/examples.md- 详细的使用示例- CoinGecko API:https://www.coingecko.com/en/api
${CLAUDE_SKILL_DIR}/config/settings.yaml- 配置选项