market-data

market-data

目的

Alpha Vantage や Yahoo Finance などの API からリアルタイムの金融市場データを取得して処理し、分析や取引の意思決定に役立てるスキルです。株式、通貨、指数のデータ取り込み、正規化、基本的な計算を処理します。

使用する場面

取引ボット、金融ダッシュボード、データ駆動型アプリでリアルタイムの市場を監視するときに、このスキルを使用します。ライブの株価、過去のデータ、移動平均などの指標が必要な場合、特に高頻度取引のシナリオやポートフォリオ分析で活用します。

主な機能

• API を通じて、株式、ETF、外国為替のリアルタイムまたは過去のデータを取得します。
• 組み込み関数でデータを処理します。たとえば、単純移動平均やボラティリティを計算します。
• JSON 設定ファイルで設定可能な、複数のデータソースに対応します。
• ページネーションとキャッシュを使用して、大規模なデータセットを効率的に処理します。
• 他の金融ツールと連携し、自動化されたワークフローを実現します。

使用パターン

環境変数を使った認証で、必ずスキルを初期化してください。パイプラインでは、まずデータを取得し、次に処理し、最後に出力または連携します。スクリプトではモジュールとしてインポートし、関数を直接呼び出してください。CLI モードでは、コマンドを連結して順番に実行します。データベースへの直接書き込みは避け、一時的なデータ処理に使用してください。

主なコマンド／API

手軽にアクセスするには claw CLI を使用します。API エンドポイントはプログラムから利用します。コマンドを実行する前に、認証用の $MARKET_API_KEY を設定してください。

• CLI コマンド：株価を取得
  claw market-data fetch --symbol AAPL --interval 1min
  AAPL の最新の1分足 OHLC データを取得します。

• API エンドポイント：株式データを取得
  エンドポイント：GET /api/v1/stocks/{symbol}。?interval=1min のようなクエリパラメーターを指定します。
  例：コードでの使用方法：

  import requests
  response = requests.get('http://api.openclaw.ai/api/v1/stocks/AAPL', headers={'Authorization': f'Bearer {os.environ["MARKET_API_KEY"]}'})
  data = response.json()
  

• CLI コマンド：データを処理（例：SMA の計算）
  claw market-data process --input data.json --function sma --period 20
  JSON ファイルを読み込み、20期間の SMA を計算します。

• API エンドポイント：データを処理
  エンドポイント：POST /api/v1/process。JSON ボディに {"function": "sma", "data": [...], "period": 20} を指定します。
  例：

  fetch('http://api.openclaw.ai/api/v1/process', {
    method: 'POST',
    headers: { 'Authorization': `Bearer ${process.env.MARKET_API_KEY}` },
    body: JSON.stringify({function: 'sma', data: [/* array */], period: 20})
  }).then(res => res.json());
  

• 設定形式：設定には JSON ファイルを使用
  設定例 config.json：

  {
    "api_endpoint": "http://api.openclaw.ai",
    "default_interval": "1min",
    "cache_ttl": 300
  }
  

  claw market-data config load path/to/config.json で読み込みます。

連携時の注意

アプリのコードでスキルの関数をラップして連携し、環境に $MARKET_API_KEY が設定されていることを確認してください。ウェブアプリでは、処理がブロックされないように非同期呼び出しを使用します。他のスキルと組み合わせる場合は、たとえば claw market-data fetch --symbol AAPL | claw trading-execution analyze のように、標準入力／標準出力を介して出力をパイプで渡します。遅延を追加するか、組み込みの再試行機能を --retry-count 3 で使用して、レート制限に対処してください。まずサンドボックス環境で連携をテストしてください。

エラー処理

レスポンスコードを解析して API エラーを確認してください。よくあるエラーには、$MARKET_API_KEY が未設定または無効な場合の 401（認証されていない）などがあります。コード例では try-catch を使用してください。

try:
    response = requests.get(...)  # as above
    response.raise_for_status()
except requests.exceptions.HTTPError as err:
    print(f"Error: {err} - Check API key or endpoint")

CLI では --verbose を追加してエラーをログに記録します。例：claw market-data fetch --symbol AAPL --verbose。一時的なエラーは指数バックオフで再試行してください。config.json で {"retry_policy": {"max_retries": 5, "backoff": 2}} のように設定します。不正なリクエストを防ぐため、必ず入力を検証してください。

具体的な使用例

1. Python スクリプトで株価を取得して分析する：
   $MARKET_API_KEY=your_key を設定します。次に：

   import os
   import requests
   symbol = 'AAPL'
   response = requests.get(f'http://api.openclaw.ai/api/v1/stocks/{symbol}', headers={'Authorization': f'Bearer {os.environ["MARKET_API_KEY"]}'})
   price = response.json()['price']
   print(f"Current price of {symbol}: {price}")
   

   これにより、取引アルゴリズムですぐに使用できるライブ価格が出力されます。

2. 取引シグナル用に、CLI で過去のデータを処理する：
   まず、データを取得します：claw market-data fetch --symbol TSLA --interval daily --output history.json。
   次に、処理します：claw market-data process --input history.json --function rsi --period 14。
   出力：RSI 値を含む JSON が生成されます。このデータを売買シグナルの意思決定スクリプトに渡すことができます。

グラフの関係

• 関連：trading-execution（注文の発注用データを取得）、financial-analysis（レポート用に処理済みデータを提供）。
• 依存：authentication-service（API キーの検証に使用）。
• 利用元：portfolio-management（資産配分のために市場データを統合）。