tracking-crypto-portfolio

暗号資産ポートフォリオの追跡

概要

このスキルでは、以下の機能を使って暗号資産ポートフォリオを包括的に追跡できます。

• リアルタイム評価額：CoinGecko の現在価格
• 保有資産の内訳：資産ごとの数量、評価額、配分
• 損益の追跡：取得原価に基づく未実現利益・損失
• 配分分析：カテゴリー別の内訳と集中リスクの警告
• 複数のエクスポート形式：テーブル、JSON、CSV

主な機能：

• 複数の資産にわたる保有状況を追跡
• ポートフォリオの合計額を米ドルで算出
• 過剰な比率を占めるポジションを特定（集中リスク）
• 分析ツールや税務申告向けにエクスポート

前提条件

このスキルを使用する前に、以下を確認してください。

1. Python 3.8+ がインストールされていること
2. requests ライブラリを利用できること：pip install requests
3. CoinGecko API にアクセスできるインターネット接続があること
4. 保有資産を記載したポートフォリオ JSON ファイルがあること

ポートフォリオファイルの形式

ポートフォリオファイル（例：holdings.json）を作成します。

{
  "name": "My Portfolio",
  "holdings": [
    {"coin": "BTC", "quantity": 0.5, "cost_basis": 25000},
    {"coin": "ETH", "quantity": 10, "cost_basis": 2000},
    {"coin": "SOL", "quantity": 100}
  ]
}

フィールド：

• coin：シンボル（BTC、ETH など）— 必須
• quantity：保有数量 — 必須
• cost_basis：コインあたりの平均購入価格（任意、損益計算用）
• acquired：取得日（任意、記録用）

手順

ステップ 1：ユーザーの意図を確認する

ユーザーが必要としているポートフォリオ情報を判断します。

• 簡易確認：合計額と主な保有資産
• 保有資産一覧：すべてのポジションの完全な内訳
• 詳細分析：配分、損益、リスク警告
• エクスポート：外部ツール向けの JSON または CSV

ステップ 2：ポートフォリオ追跡を実行する

適切なオプションを指定してトラッカーを実行します。

# Quick portfolio summary
python {baseDir}/scripts/portfolio_tracker.py --portfolio holdings.json

# Full holdings breakdown
python {baseDir}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings

# Detailed analysis with P&L and allocations
python {baseDir}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed

# Export to JSON
python {baseDir}/scripts/portfolio_tracker.py --portfolio holdings.json --format json --output portfolio_export.json

# Export to CSV
python {baseDir}/scripts/portfolio_tracker.py --portfolio holdings.json --format csv --output portfolio.csv

ステップ 3：結果を提示する

ポートフォリオデータを整形して説明します。

• ポートフォリオの合計額を目立つように表示する
• 24 時間および 7 日間の変動を強調する
• 配分率を説明する
• 集中リスクがあれば警告する
• 詳細モードでは、損益の計算方法を説明する

コマンドラインオプション

オプション	説明	デフォルト
--portfolio	ポートフォリオ JSON ファイルのパス	必須
--holdings	すべての保有資産の内訳を表示	false
--detailed	損益を含む詳細分析	false
--sort	並べ替え基準：value、allocation、name、change	value
--format	出力形式（table、json、csv）	table
--output	出力ファイルのパス	stdout
--threshold	配分の警告しきい値	25%
--verbose	詳細出力を有効にする	false

配分のしきい値

デフォルトでは、配分率が 25% を超えるポジションに警告が表示されます。

配分率	リスクレベル	対応
< 10%	低	通常のポジション
10-25%	中	注意して監視
25-50%	高	リバランスを検討
> 50%	非常に高い	重大な集中リスク

出力

テーブル形式（デフォルト）

==============================================================================
  CRYPTO PORTFOLIO TRACKER                          Updated: 2026-01-14 15:30
==============================================================================

  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%

  ⚠ CONCENTRATION WARNING: BTC (37.9%) exceeds 25% threshold

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

JSON 形式

{
  "portfolio_name": "My Portfolio",
  "total_value_usd": 125450.00,
  "change_24h": {"amount": 2540.50, "percent": 2.07},
  "holdings": [
    {
      "coin": "BTC",
      "quantity": 0.5,
      "price_usd": 95000,
      "value_usd": 47500,
      "allocation_pct": 37.9,
      "change_24h_pct": 2.5
    }
  ],
  "meta": {
    "timestamp": "2026-01-14T15:30:00Z",
    "holdings_count": 8
  }
}

エラー処理

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

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

例

詳しい例については、{baseDir}/references/examples.md を参照してください。

簡単な例

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

# Show all holdings sorted by allocation
python {baseDir}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings --sort allocation

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

# Export for tax software
python {baseDir}/scripts/portfolio_tracker.py --portfolio holdings.json --format csv --output tax_export.csv

# JSON export for trading bot
python {baseDir}/scripts/portfolio_tracker.py --portfolio holdings.json --format json --output portfolio_data.json

リソース

• CoinGecko API：https://www.coingecko.com/en/api - 無料の暗号資産市場データ
• ポートフォリオスキーマ：ポートフォリオファイル形式の全項目については PRD.md を参照してください
• 設定：オプションについては {baseDir}/config/settings.yaml を参照してください
• 統合例については {baseDir}/references/examples.md を参照してください