moexalgo-futoi について
moexalgo Python パッケージで FUTOI を取得し、DataFrame として分析するスキルです。集計された先物スナップショットを pandas で扱うワークフローに適し、アクセス上の注意点や直接 REST エンドポイントとの違いも説明します。
主な機能
- 01全先物の FUTOI 取得
- 02個別先物銘柄の照会
- 03FIZ と YUR による分類
- 04pandas による分析と描画
- 05ライブラリメソッドの制限を説明
- 06集計データの解釈範囲を提示
活用シーン
- 01Python で先物ポジションデータを取得
- 02pandas でデータを集計またはピボット
- 03銘柄ごとの FUTOI 期間を分析
- 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")
基本的なワークフロー
- すべての先物 FUTOI 行を取得するには、
Market("FO").futoi(date=...)を使用します。 - 1つの先物銘柄を取得するには、
Ticker(...).futoi(start=..., end=...)を使用します。 clgroupで分類します。通常はFIZとYURです。- ユーザーが分析を求めた場合にのみ、pandas のグループ化、ピボット、グラフを使用します。
- FUTOI ライブラリのメソッドでは
latestやoffsetを指定できないことに注意してください。ユーザーがこれらの生エンドポイント制御を必要とする場合は、REST を直接使用します。 - 行は先物の集計スナップショットであり、個々のトレーダーの記録でも、単一契約における FIZ/YUR の正確なポジション状況でもないことを説明します。
リファレンス
シグネチャ、フィールド、集計に関する注意点、DataFrame の例については、references/futoi.md を参照してください。
適用範囲
ブラウザー URL、curl、生の JSON/CSV、または Python を使わない出力には、代わりに FUTOI 専用スキルを使用します。
コメント
Markdown 対応