Financial Data Fetcher

金融データ取得スキル

AI トレーディングエージェント向けに、包括的な市場データへのアクセスを提供します。

概要

このスキルでは、次のデータを取得できます。

• リアルタイムおよび過去の OHLCV 価格データ
• 複数のソースからの金融ニュース
• ファンダメンタルデータ（P/E レシオ、収益、市場時価総額）
• 市場のスナップショットと相場情報

ツール

1. get_price_data

銘柄の過去またはリアルタイムの価格データを取得します。

パラメーター：

• symbols（必須）：ティッカーシンボルのリスト（例：["AAPL", "MSFT"]）
• timeframe（任意）："1Min"、"5Min"、"1Hour"、"1Day"（デフォルト："1Day"）
• start_date（任意）：YYYY-MM-DD 形式の開始日
• end_date（任意）：YYYY-MM-DD 形式の終了日
• limit（任意）：取得するバーの数（デフォルト：100）

戻り値：

{
  "success": true,
  "data": {
    "AAPL": [
      {
        "timestamp": "2025-10-30T09:30:00Z",
        "open": 150.25,
        "high": 151.50,
        "low": 149.80,
        "close": 151.00,
        "volume": 5000000
      }
    ]
  }
}

使用例：

python scripts/fetch_data.py get_price_data --symbols AAPL MSFT --timeframe 1Day --limit 30

2. get_latest_news

銘柄の最近の金融ニュースを取得します。

パラメーター：

• symbols（必須）：ティッカーシンボルのリスト
• limit（任意）：ニュース項目の数（デフォルト：10）
• sources（任意）：照会するニュースソース（デフォルト：すべて）

戻り値：

{
  "success": true,
  "data": [
    {
      "symbol": "AAPL",
      "headline": "Apple announces new product line",
      "summary": "...",
      "source": "Bloomberg",
      "url": "https://...",
      "published_at": "2025-10-30T08:00:00Z",
      "sentiment": "positive"
    }
  ]
}

3. get_fundamentals

銘柄のファンダメンタルデータを取得します。

パラメーター：

• symbols（必須）：ティッカーシンボルのリスト
• metrics（任意）：取得する特定の指標（デフォルト：すべて）

戻り値：

{
  "success": true,
  "data": {
    "AAPL": {
      "market_cap": 3000000000000,
      "pe_ratio": 28.5,
      "eps": 6.42,
      "dividend_yield": 0.52,
      "beta": 1.2,
      "52_week_high": 200.00,
      "52_week_low": 120.00
    }
  }
}

4. get_market_snapshot

リアルタイムの相場情報を含む、現在の市場スナップショットを取得します。

パラメーター：

• symbols（必須）：ティッカーシンボルのリスト

戻り値：

{
  "success": true,
  "data": {
    "AAPL": {
      "price": 151.00,
      "bid": 150.98,
      "ask": 151.02,
      "bid_size": 100,
      "ask_size": 200,
      "last_trade_time": "2025-10-30T15:59:59Z",
      "volume": 50000000,
      "vwap": 150.75
    }
  }
}

実装

Alpaca API と yfinance を使用した完全な実装については、scripts/fetch_data.py を参照してください。

レート制限

• Alpaca API：200 リクエスト／分
• News API：25 リクエスト／日（無料プラン）
• キャッシュ：リアルタイムデータを 5 分間キャッシュ

エラー処理

すべてのツールは、一貫したエラー形式を返します。

{
  "success": false,
  "error": "Error message",
  "error_code": "INVALID_SYMBOL"
}

統合例

from claude_skills import load_skill

skill = load_skill("financial_data_fetcher")

# Get price data
result = skill.get_price_data(
    symbols=["AAPL", "MSFT"],
    timeframe="1Day",
    limit=30
)

if result["success"]:
    prices = result["data"]
    # Use in trading strategy