algopack-futoi について
参加者グループ別の先物建玉集計スナップショットを分析するため、MOEX FUTOI エンドポイントへ直接アクセスするスキルです。取得、解析、出力の手順と、アクセス遅延や集計データの解釈上の制約を示します。
主な機能
- 01全先物または指定銘柄の照会
- 02FUTOI データブロックの解析
- 03FIZ と YUR による分類
- 04ISS の列とデータ配列の正規化
- 05テーブルやチャートへの出力
- 06集計データの制約の説明
活用シーン
- 01指定日の先物スナップショット取得
- 02個人と法人のグループデータ整理
- 03CSV または JSON での結果出力
- 04ブラウザーやノートブックでの描画
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ moexalgo/ algopack-skills --skill algopack-futoiインストール後、Claude Code で/algopack-futoiを入力して読み込まれたか確認します。
同梱ファイルreferences/futoi.md
詳細
ALGOPACK FUTOI
概要
FUTOI エンドポイントに直接アクセスする場合は、このスキルを使用します。FUTOI は参加者グループ別に分割された先物の建玉で、集計スナップショットとして公開されます。株式、FX、オプション、個々のトレーダーのデータ、または単一契約の正確な FIZ/YUR ポジションを対象とするものではありません。
アクセスに関する注意:Стартовый / Starter の無料トークンアクセスでは、FUTOI に T - 15 days の遅延があります。Promo では、現在の利用権限に応じて、より広範なデータまたはオンラインアクセスを利用できます。
クイックスタート
curl -L "https://apim.moex.com/iss/analyticalproducts/futoi/securities/Si.json?from=2025-01-10&till=2025-01-10" \
-H "Authorization: Bearer ${APIKEY}"
すべての銘柄には /securities.json?date=YYYY-MM-DD を、1つの銘柄または原資産には /securities/{ticker}.json?from=...&till=... を使用します。
コアワークフロー
FOティッカーまたは原資産のみを使用します。- 日付または期間の行を取得し、
futoiブロックを解析します。 clgroupで分割します。個人の場合はFIZ、法人の場合はYURを使用します。- フィルタリング、テーブルの作成、またはグラフ化の前に、ISS の
columnsとdataの配列を行形式に正規化します。 - 出力形式をリクエストに合わせます。引き渡しには CSV/JSON テーブル、ブラウザー出力にはシンプルな HTML グラフ、ノートブックやスクリプトの出力には Matplotlib または pandas によるプロット、アプリ内では既存のチャート機能を使用します。
- 特定の契約や参加者について結論を出す前に、集計上の注意点を説明します。
リファレンス
エンドポイント、フィールド、集計ルール、アクセス上の注意、ページネーション、出力パターンについては、references/futoi.md をお読みください。
対象範囲
集計された FUTOI の行から、個々のトレーダーの行動、株式/FX/オプションのポジション、または単一契約の正確な FIZ/YUR ポジションを推測しないでください。