仮想通貨ポートフォリオの追跡
概要
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日間の変化、銘柄ごとのアロケーション、および閾値を超えるポジションの集中警告を示すサマリー:
==============================================================================
CRYPTO PORTFOLIO TRACKER 更新日: 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- 設定オプション