mcpField
M
moexalgo-futoi

moexalgo-futoi

github.com/moexalgoデータ・データベース441 回インストール19 週間前に更新
リポジトリ

moexalgo-futoi について

moexalgo Python パッケージで FUTOI を取得し、DataFrame として分析するスキルです。集計された先物スナップショットを pandas で扱うワークフローに適し、アクセス上の注意点や直接 REST エンドポイントとの違いも説明します。

主な機能

  1. 01全先物の FUTOI 取得
  2. 02個別先物銘柄の照会
  3. 03FIZ と YUR による分類
  4. 04pandas による分析と描画
  5. 05ライブラリメソッドの制限を説明
  6. 06集計データの解釈範囲を提示

活用シーン

  1. 01Python で先物ポジションデータを取得
  2. 02pandas でデータを集計またはピボット
  3. 03銘柄ごとの FUTOI 期間を分析
  4. 04集計スナップショットと個別記録を区別

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/moexalgo/algopack-skills --skill moexalgo-futoi

インストール後、Claude Code で/moexalgo-futoiを入力して読み込まれたか確認します。

同梱ファイルreferences/futoi.md

詳細

MOEXAlgo FUTOI

概要

ユーザーが moexalgo Python パッケージと DataFrame 分析を使って FUTOI を利用したい場合に、このスキルを使用します。

アクセスに関する注意:Стартовый / Starter の無料トークンでは FUTOI のデータが T - 15 days 遅延します。Promo では、現在の利用権限に応じて、より充実したオンラインアクセスが可能です。

クイックスタート

python -m pip install "moexalgo[dataframe]" python-dotenv
import os
from dotenv import load_dotenv
from moexalgo import session, Market, Ticker

load_dotenv()
session.TOKEN = os.environ["APIKEY"]

fo = Market("FO")
all_futoi = fo.futoi(date="2025-01-10")

si = Ticker("SiH5")
si_futoi = si.futoi(start="2025-01-10", end="2025-01-10")

基本的なワークフロー

  1. すべての先物 FUTOI 行を取得するには、Market("FO").futoi(date=...) を使用します。
  2. 1つの先物銘柄を取得するには、Ticker(...).futoi(start=..., end=...) を使用します。
  3. clgroup で分類します。通常は FIZ と YUR です。
  4. ユーザーが分析を求めた場合にのみ、pandas のグループ化、ピボット、グラフを使用します。
  5. FUTOI ライブラリのメソッドでは latest や offset を指定できないことに注意してください。ユーザーがこれらの生エンドポイント制御を必要とする場合は、REST を直接使用します。
  6. 行は先物の集計スナップショットであり、個々のトレーダーの記録でも、単一契約における FIZ/YUR の正確なポジション状況でもないことを説明します。

リファレンス

シグネチャ、フィールド、集計に関する注意点、DataFrame の例については、references/futoi.md を参照してください。

適用範囲

ブラウザー URL、curl、生の JSON/CSV、または Python を使わない出力には、代わりに FUTOI 専用スキルを使用します。

コメント