关于 moexalgo-futoi
通过 moexalgo Python 包获取 FUTOI 数据并进行 DataFrame 分析的技能，适合使用 pandas 处理期货聚合持仓快照的工作流。它说明查询方式、访问限制以及与直接 REST 接口的能力差异。
主要功能
- 01查询全部期货 FUTOI 数据
- 02查询单个期货标的
- 03按 FIZ 和 YUR 分组
- 04使用 pandas 分析与绘图
- 05说明库方法的参数限制
- 06提示聚合数据的解读边界
适用场景
- 01通过 Python 获取期货持仓数据
- 02使用 pandas 汇总或透视数据
- 03分析指定标的的 FUTOI 时间范围
- 04区分聚合快照与个体交易记录
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/moexalgo-futoi确认已加载。
附带文件references/futoi.md
详细介绍
MOEXAlgo FUTOI
概述
当用户希望通过 moexalgo Python 包使用 FUTOI 并分析 DataFrame 时，使用此技能。
访问说明：Стартовый / 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")
核心工作流
- 使用
Market("FO").futoi(date=...)获取所有期货 FUTOI 行。 - 使用
Ticker(...).futoi(start=..., end=...)获取单个期货工具的数据。 - 按
clgroup拆分，通常为FIZ和YUR。 - 仅在用户要求进行此类分析时，使用 pandas 分组、透视或绘图。
- 请注意，FUTOI 库方法不提供
latest或offset；如果用户需要这些原始端点控制项，请使用直接 REST。 - 说明这些行是期货汇总快照，并非单个交易者的记录，也不是 FIZ/YUR 精确的单份合约持仓。
参考资料
阅读 references/futoi.md，了解签名、字段、汇总注意事项和 DataFrame 示例。
适用范围
对于浏览器 URL、curl、原始 JSON/CSV 或非 Python 输出，请改用直接 FUTOI 技能。
评论
支持 Markdown