加密貨幣投資組合追蹤
概述
即時追蹤加密貨幣持倉,透過 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
==============================================================================
投資組合摘要:我的投資組合
------------------------------------------------------------------------------
總值: $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- 設定選項