data912-market-data

Data912 市場データ

Data912 の公開市場 API を照会し、アルゼンチンおよび米国市場のスナップショット、過去のバー、EOD デリバティブ分析データを取得します。

API の概要

• ベース URL: https://data912.com
• 認証: 不要（公開 API）
• 形式: JSON レスポンス
• データソースに関する注記: Data912 は、この API のデータを教育・趣味向けと説明しており、リアルタイムではないことを明示しています。
• キャッシュに関する注記: サーバーのメタデータによると、Cloudflare によって約 2 時間キャッシュされます。

エンドポイントのグループ

1. ライブ市場パネル

• /live/mep（USD MEP）
• /live/ccl（USD CCL）
• /live/arg_stocks
• /live/arg_options
• /live/arg_cedears
• /live/arg_notes
• /live/arg_corp
• /live/arg_bonds
• /live/usa_adrs
• /live/usa_stocks

例：

curl -s "https://data912.com/live/arg_stocks" | jq '.[0:5]'

2. 過去の OHLC

• /historical/stocks/{ticker}
• /historical/cedears/{ticker}
• /historical/bonds/{ticker}

例：

curl -s "https://data912.com/historical/stocks/GGAL" | jq '.[0:10]'

3. EOD デリバティブ分析

• /eod/volatilities/{ticker}
• /eod/option_chain/{ticker}

例：

curl -s "https://data912.com/eod/volatilities/AAPL" | jq '.'
curl -s "https://data912.com/eod/option_chain/AAPL" | jq '.[0:10]'

このスキルの対象外

• このスキルでは /contact を使用しないでください。このスキルは市場データの取得と解釈に特化させてください。

主なフィールド

パネルのフィールド（/live/*）

• symbol：金融商品のティッカー／シンボル
• px_bid、q_bid：買い気配値と買い気配数量
• px_ask、q_ask：売り気配値と売り気配数量
• c：最終値／終値に相当する取引値
• pct_change：変動率
• v：出来高
• q_op：取引回数（提供される場合）

過去データのフィールド（/historical/*/{ticker}）

• date：日付文字列
• o、h、l、c：OHLC 値
• v：出来高
• dr：日次リターン
• sa：データソースが提供する追加の数値指標

ボラティリティ指標（/eod/volatilities/{ticker}）

• IV の期間構造：iv_s_term、iv_m_term、iv_l_term
• IV パーセンタイル：iv_*_percentile
• HV の期間構造：hv_s_term、hv_m_term、hv_l_term
• HV パーセンタイル：hv_*_percentile
• 相対価値比率：iv_hv_*_ratio、iv_fair_iv_ratio
• フェアバリューの参照値：fair_iv、fair_iv_percentile

オプションチェーンのフィールド（/eod/option_chain/{ticker}）

• 契約の情報：opex、s_symbol、type、k
• 市場データ：bid、ask、c、oi
• グリークス：delta、gamma、theta、vega、rho
• 評価額／確率：fair_value、fair_iv、itm_prob、intrinsic、otm
• 期間の情報：r_days、r_tdays、hv_2m、hv_1yr

ワークフロー

1. 目的を特定し、エンドポイントのグループを選択します。
   • FX／パネルのスナップショット → /live/*
   • 時系列／推移 → /historical/*/{ticker}
   • オプション／リスク分析 → /eod/*/{ticker}
2. 必須入力を確認します。
   • 過去データ／EOD エンドポイントでは、ティッカーシンボルが必要です。
   • ティッカーが指定されていない場合は、照会する前に確認してください。
3. curl -s でデータを取得し、jq で解析します。
4. 空の配列を処理します。
   • レスポンスが [] の場合は、「このエンドポイント／ティッカーでは現在データを利用できません。」と報告します。
5. 実用的な要約を提示します。
   • まず簡潔なスナップショットを示します。
   • 次に、ユーザーが求めた関連する詳細フィールドを含めます。
6. コンテキストを明確に保ちます。
   • このデータは教育目的であり、リアルタイムではないことをユーザーに伝えます。
   • 出力を投資助言にしないでください。

エラー処理

• 429 Too Many Requests：
  • ほとんどの市場エンドポイントの公開レート制限は 120 req/min です。
  • 少し待ってから再試行し、短時間に繰り返しリクエストするループは避けてください。
• 422 Validation Error：
  • 通常はティッカーの形式など、パス入力が無効または不足している場合に発生します。
  • 再試行する前に、シンボルとエンドポイントを確認してください。
• ネットワーク／タイムアウトエラー：
  • 少ない回数で再試行します（例：間隔を置いて 2 回再試行）。
  • それでも失敗する場合は、試行したエンドポイントを含め、失敗したことを明確に伝えてください。

結果の提示

結果をユーザーに返す際は、次の点に従ってください。

• 変化した内容、場所、規模を簡潔にまとめて、最初に提示してください。
• パネルのリクエストでは、bid／ask／last と % change を比較してください。
• 履歴のリクエストでは、トレンドの期間と注目すべき急変をまとめてください。
• ボラティリティ／オプションのリクエストでは、パーセンタイルと IV／HV の関係を強調してください。
• データは教育目的であり、リアルタイムではないことを明示してください。
• 金融上の推奨は行わないでください。

OpenAPI 仕様

スキーマとエンドポイント定義の全容については、references/openapi-spec.json を参照してください。