用途：当用户希望通过 moexalgo Python 包获取 FUTOI（期货持仓量）数据并进行 DataFrame 分析时使用本技能。
主要能力：使用 Market("FO").futoi(date=...) 获取全部期货的 FUTOI 行；使用 Ticker(...).futoi(start=..., end=...) 获取单一期货合约的数据；可按 clgroup 分组，通常为 FIZ 和 YUR；在用户要求时可用 pandas 进行 groupby、透视或绘图。
使用方式：先安装依赖：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")
适用场景：期货持仓量数据的批量或单合约查询，以及基于 pandas 的后续分析。
限制：Starter 免费令牌的 FUTOI 数据延迟 T-15 天，Promo 权限更完整，具体以当前授权为准；FUTOI 库方法不提供 latest 或 offset，如需这些原始端点控制请直接使用 REST；数据行是期货聚合快照，并非单个交易者记录，也不是精确的单合约 FIZ/YUR 持仓。若需浏览器 URL、curl、原始 JSON/CSV 或无 Python 输出，应改用直接的 FUTOI 技能。