暗号資産価格トラッキング

概要

リアルタイムおよび過去の暗号資産価格データを提供するファンデーションスキルです。このスキルは暗号資産プラグインエコシステムのデータレイヤーであり、10以上の他のスキルが価格情報を依存しています。

主な機能:

• 10,000以上の暗号資産のリアルタイム価格
• 過去のOHLCVデータ（1日から全期間）
• マルチ通貨対応（USD、EUR、GBP、30以上の通貨）
• APIコールを最小化するインテリジェントキャッシング
• 定義済みおよびカスタムウォッチリスト
• 分析用のCSV/JSONエクスポート

依存スキル: このスキルは以下のスキルに価格データを提供します: market-movers-scanner、crypto-portfolio-tracker、crypto-tax-calculator、defi-yield-optimizer、liquidity-pool-analyzer、staking-rewards-optimizer、crypto-derivatives-tracker、dex-aggregator-router、options-flow-analyzer、arbitrage-opportunity-finder。

前提条件

必要な依存関係をインストールします:

pip install requests pandas yfinance

高度な機能用（オプション）:

pip install python-dotenv  # APIキー管理用

APIセットアップ（オプション、より高いレート制限用）:

1. https://www.coingecko.com/en/api から無料APIキーを取得
2. {baseDir}/config/settings.yaml に追加するか、環境変数 COINGECKO_API_KEY を設定

手順

ステップ1: クイック価格確認

任意の暗号資産の現在価格を取得:

python {baseDir}/scripts/price_tracker.py --symbol BTC

複数の資産を確認:

python {baseDir}/scripts/price_tracker.py --symbols BTC,ETH,SOL

ステップ2: ウォッチリストを使用

定義済みウォッチリストをスキャン:

# 時価総額トップ10
python {baseDir}/scripts/price_tracker.py --watchlist top10

# DeFiトークン
python {baseDir}/scripts/price_tracker.py --watchlist defi

# レイヤー2トークン
python {baseDir}/scripts/price_tracker.py --watchlist layer2

利用可能なウォッチリスト: top10、defi、layer2、stablecoins、memecoins

ステップ3: 過去データの取得

OHLCV（始値、高値、安値、終値、出来高）の履歴を取得:

# 過去30日
python {baseDir}/scripts/price_tracker.py --symbol BTC --period 30d

# 過去90日（CSVエクスポート付き）
python {baseDir}/scripts/price_tracker.py --symbol BTC --period 90d --output csv

# カスタム日付範囲
python {baseDir}/scripts/price_tracker.py --symbol ETH --start 2024-01-01 --end 2024-12-31

ステップ4: 設定をカスタマイズ

{baseDir}/config/settings.yaml を編集してカスタマイズ:

cache:
  spot_ttl: 30          # スポット価格のキャッシュ秒数
  historical_ttl: 3600  # 過去データのキャッシュ秒数

currency:
  default: usd          # デフォルト法定通貨

watchlists:
  custom:               # 自分のウォッチリストを追加
    - BTC
    - ETH
    - SOL

出力

価格テーブル（デフォルト）

================================================================================
  CRYPTO PRICES                                           Updated: [timestamp]
================================================================================

  Symbol     Price (USD)      24h Change     Volume (24h)      Market Cap
--------------------------------------------------------------------------------
  BTC       $97,234.56          +2.34%      $28.5B            $1.92T
  ETH        $3,456.78          +1.87%      $12.3B            $415.2B
  SOL          $142.34          +5.12%       $2.1B             $61.4B
--------------------------------------------------------------------------------

  Total 24h Change: +2.44% (weighted)

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

JSONで出力（--format json）

{
  "prices": [
    {
      "symbol": "BTC",
      "name": "Bitcoin",
      "price": 97234.56,
      "currency": "USD",
      "change_24h": 2.34,
      "volume_24h": 28500000000,
      "market_cap": 1920000000000,
      "timestamp": "[timestamp]",
      "source": "coingecko"
    }
  ],
  "meta": {
    "count": 1,
    "currency": "USD",
    "cached": false
  }
}

過去データCSVエクスポート

date,open,high,low,close,volume
[date],95000.00,96500.00,94200.00,96100.00,25000000000
[date],96100.00,97800.00,95800.00,97500.00,27000000000

設定

{baseDir}/config/settings.yaml を編集:

# API設定
api:
  coingecko:
    api_key: ${COINGECKO_API_KEY}  # オプション、環境変数から
    use_pro: false
  yfinance:
    enabled: true                   # フォールバックソース

# キャッシュ設定
cache:
  enabled: true
  spot_ttl: 30                      # スポット価格TTL（秒）
  historical_ttl: 3600              # 過去データTTL（秒）
  directory: ./data

# 表示設定
currency:
  default: usd
  supported:
    - usd
    - eur
    - gbp
    - jpy
    - cad
    - aud

# 定義済みウォッチリスト
watchlists:
  top10:
    - bitcoin
    - ethereum
    - tether
    - binancecoin
    - solana
    - ripple
    - cardano
    - avalanche-2
    - dogecoin
    - polkadot

  defi:
    - uniswap
    - aave
    - chainlink
    - maker
    - compound-governance-token
    - curve-dao-token
    - sushi

  layer2:
    - matic-network
    - arbitrum
    - optimism
    - immutable-x

エラーハンドリング

包括的なエラーハンドリングについては {baseDir}/references/errors.md を参照してください。

一般的なエラー

エラー	原因	解決策
Unknown symbol: XYZ	無効な暗号資産ティッカー	スペルを確認、--list で検索
Rate limit exceeded	APIコールが多すぎる	60秒待つか、APIキーでより高い制限を取得
Network error	インターネット接続がない	接続を確認、キャッシュデータが使用されます
Cache stale	キャッシュデータがTTLより古い	警告付きでデータが表示されます、更新予定

レート制限ハンドリング

このスキルは自動的に:

1. 利用可能な場合はキャッシュデータを使用
2. レート制限時に指数バックオフを適用
3. CoinGeckoが失敗した場合はyfinanceにフォールバック
4. 最後の手段として警告付きで古いキャッシュデータを表示

例

詳細な例については {baseDir}/references/examples.md を参照してください。以下を含みます:

• マルチタイムフレーム分析
• ポートフォリオ価値計算
• 価格アラート設定
• 他のスキルとの統合

例1: クイック価格確認

python {baseDir}/scripts/price_tracker.py --symbol BTC

出力:

BTC (Bitcoin)
$97,234.56 USD
+2.34% (24h) | Vol: $28.5B | MCap: $1.92T

例2: ウォッチリストスキャン

python {baseDir}/scripts/price_tracker.py --watchlist top10

例3: 過去データのエクスポート

python {baseDir}/scripts/price_tracker.py --symbol ETH --period 90d --output csv

作成されるファイル: {baseDir}/data/ETH_90d_[date].csv

他のスキルとの統合

このスキルは他の暗号資産スキル用の価格データファンデーションを提供します。

直接インポート（Pythonスキル推奨）:

from price_tracker import get_current_prices, get_historical_prices

# ポートフォリオ評価用に価格を取得
prices = get_current_prices(["BTC", "ETH", "SOL"])

CLIサブプロセス（非Pythonまたは独立用）:

PRICES=$(python {baseDir}/scripts/price_tracker.py --symbols BTC,ETH --format json)

共有キャッシュ（バッチ処理に効率的）: 複数のスキルが {baseDir}/data/cache.json から読み込んで、冗長なAPIコールを回避できます。

ファイル

ファイル	目的
scripts/price_tracker.py	メインCLIエントリーポイント
scripts/api_client.py	CoinGecko/yfinance抽象化
scripts/cache_manager.py	キャッシュ読み込み/書き込み/無効化
scripts/formatters.py	出力フォーマット
config/settings.yaml	ユーザー設定
data/cache.json	価格キャッシュ（自動生成）

リソース

• CoinGecko API - プライマリデータソース
• yfinance - 過去データ用フォールバック
• PRD.md - 製品要件
• ARD.md - アーキテクチャドキュメンテーション