追踪加密货币投资组合
概述
使用 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% 会触发警告)
输出
摘要显示总投资价值、24 小时/7 天变化、每项资产的配置情况以及超出阈值的集中度警告:
==============================================================================
加密货币投资组合追踪器 更新于:2026-01-14 15:30 # 2026 - 当前年份时间戳
==============================================================================
投资组合摘要:我的投资组合
------------------------------------------------------------------------------
总投资价值: $125,450.00 USD
24 小时变化: +$2,540.50 (+2.07%)
7 天变化: +$8,125.00 (+6.92%)
持仓数量: 8 项资产
主要持仓
------------------------------------------------------------------------------
币种 数量 价格 价值 配置 24 小时
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- 配置选项