仮想通貨価格追跡

目次

概要 | 前提条件 | 手順 | 出力 | エラーハンドリング | 例 | リソース

概要

10,000以上のコインに対応した、リアルタイムおよび過去の仮想通貨価格データを提供する基盤スキル。これはクリプト プラグイン エコシステムのデータレイヤーで、他の10以上のスキルが価格情報をこのスキルに依存しています。

前提条件

1. 依存関係をインストール: pip install requests pandas yfinance
2. オプション: API キー管理用に pip install python-dotenv をインストール
3. オプション: https://www.coingecko.com/en/api からフリーの API キーを取得してレート制限を引き上げる
4. API キーを ${CLAUDE_SKILL_DIR}/config/settings.yaml に追加するか、COINGECKO_API_KEY 環境変数を設定

手順

1. 1つ以上のシンボルの現在価格を確認:

   python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC
   python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbols BTC,ETH,SOL
   

2. ウォッチリストを使用して定義済みグループをスキャン (利用可能: top10, defi, layer2, stablecoins, memecoins):

   python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist top10     # 時価総額トップ10
   python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist defi      # DeFiトークン
   python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist layer2    # レイヤー2トークン
   

3. 期間またはカスタム日付範囲で過去データを取得:

   python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC --period 30d
   python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC --period 90d --output csv
   python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol ETH --start 2024-01-01 --end 2024-12-31  # 2024年通年
   

4. ${CLAUDE_SKILL_DIR}/config/settings.yaml を編集して設定を変更し、キャッシュ TTL、デフォルト通貨、カスタム ウォッチリストをカスタマイズします。完全な設定リファレンスは references/implementation.md を参照してください。

出力

• テーブル (デフォルト): シンボル、価格、24時間変動率、出来高、時価総額をフォーマット済み列で表示
• JSON (--format json): 価格配列とメタデータを含む機械可読形式
• CSV (--output csv): OHLCV過去データを ${CLAUDE_SKILL_DIR}/data/ にエクスポート

詳細な出力形式の例は ${CLAUDE_SKILL_DIR}/references/implementation.md を参照してください。

エラーハンドリング

エラー	原因	解決方法
Unknown symbol: XYZ	無効なティッカー	スペルを確認、--list で検索
Rate limit exceeded	API呼び出しが多すぎる	60秒待機、または API キーを追加してレート制限を引き上げ
Network error	インターネット接続なし	接続を確認; キャッシュされたデータが自動的に使用されます
Cache stale	データが TTL より古い	警告とともに表示; 次の呼び出しで更新

スキルは自動的にレート制限を管理します: キャッシュ優先、指数バックオフ、yfinance フォールバック、最終手段としてスタートしたキャッシュを使用します。

例

クイック価格確認:

python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC
# Output: BTC (Bitcoin) $97,234.56 USD +2.34% (24h) | Vol: $28.5B | MCap: $1.92T

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

python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist top10

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

python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol ETH --period 90d --output csv
# Creates: ${CLAUDE_SKILL_DIR}/data/ETH_90d_[date].csv

リソース

• ${CLAUDE_SKILL_DIR}/references/implementation.md - 出力形式、完全な設定、統合ガイド、ファイルマップ
• CoinGecko API - プライマリデータソース
• yfinance - 過去データ用フォールバック