tracking-crypto-portfolio

仮想通貨ポートフォリオの追跡

概要

リアルタイムの CoinGecko 評価額、配分分析、損益の追跡、集中リスクの警告を利用して、仮想通貨の保有状況を追跡します。

前提条件

1. Python 3.8+ がインストールされていること
2. 依存関係：pip install requests
3. CoinGecko API にアクセスできるインターネット接続
4. 保有資産を記載したポートフォリオ JSON ファイル（形式については references/implementation.md を参照）

手順

1. ユーザーの意図を確認する - 必要なポートフォリオ表示を判断します：

   • 簡易確認：合計評価額と上位保有資産
   • 保有資産一覧：すべてのポジションの詳細
   • 詳細分析：配分、損益、リスクフラグ
   • エクスポート：外部ツール向けの JSON または CSV

2. 適切なオプションを指定してポートフォリオトラッカーを実行する：

   # Quick portfolio summary
   python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json
   
   # Full holdings breakdown
   python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings
   
   # Detailed analysis with P&L and allocations
   python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed
   

3. 分析ツールや税務申告向けに結果をエクスポートする：

   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
   

4. 結果をユーザーに提示する：

   • ポートフォリオの合計評価額を目立つように表示します
   • 24 時間および 7 日間の変動を強調します
   • 配分率を説明します
   • 集中リスク（デフォルトでは配分が 25% を超えるポジション）にフラグを立てます

出力

合計評価額、24 時間／7 日間の変動、資産ごとの配分、しきい値を超えるポジションの集中リスク警告を示す概要：

==============================================================================
  CRYPTO PORTFOLIO TRACKER                          Updated: 2026-01-14 15:30  # 2026 - current year timestamp
==============================================================================

  PORTFOLIO SUMMARY: My Portfolio
------------------------------------------------------------------------------
  Total Value:    $125,450.00 USD
  24h Change:     +$2,540.50 (+2.07%)
  7d Change:      +$8,125.00 (+6.92%)
  Holdings:       8 assets

  TOP HOLDINGS
------------------------------------------------------------------------------
  Coin     Quantity      Price         Value      Alloc   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%

  WARNING: BTC (37.9%) exceeds 25% threshold

==============================================================================

エラー処理

エラー	原因	解決策
ポートフォリオファイルが見つかりません	パスが無効です	ファイルパスが存在することを確認してください
無効な JSON	ファイルの形式が正しくありません	JSON 構文を検証してください
コインが見つかりません	不明なシンボルです	シンボルのスペルを確認し、標準的なシンボルを使用してください
API のレート制限に達しました	リクエストが多すぎます	待ってから再試行するか、キャッシュを使用してください

包括的なエラー処理については ${CLAUDE_SKILL_DIR}/references/errors.md を参照してください。

例

簡易確認から詳細分析、エクスポートまでのポートフォリオ追跡ワークフロー：

# Basic portfolio check
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio ~/crypto/holdings.json

# All holdings sorted by allocation
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings --sort allocation

# Detailed analysis with custom 15% threshold
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed --threshold 15

# Export for tax software
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 - 設定オプション