追蹤加密貨幣投資組合
概述
使用即時的 CoinGecko 估值,追蹤加密貨幣持倉,提供資產配置分析、損益(P&L)追蹤以及集中度風險警示。
先決條件
- 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 - 當前年份時間戳
==============================================================================
投資組合摘要:My Portfolio
------------------------------------------------------------------------------
總值: $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- 設定選項