用途：本技能用于直接调用 FUTOI 端点。FUTOI 是按参与者组拆分并以聚合快照形式发布的期货持仓量数据，不适用于股票、外汇、期权、个人交易者数据，也不用于精确的单合约 FIZ/YUR 持仓。
主要能力：支持按单个标的或全部工具获取数据。核心流程为：仅使用期货（FO）代码或标的；拉取某日期或日期区间的数据行并解析 futoi 块；按 clgroup 拆分为 FIZ（个人）与 YUR（法人）；在过滤、写入表格或绘图前，将 ISS 列与 data 数组规范化为行；按输出场景匹配形式，交接用 CSV/JSON 表格，浏览器输出用简单 HTML 图表，笔记本或脚本用 Matplotlib 或 pandas 绘图，应用内则沿用其现有图表栈。
使用方式：命令行示例为 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，获取单个工具或标的用 /securities/{ticker}.json?from=...&till=...。
访问限制：Starter 免费令牌的 FUTOI 延迟为 T-15 天；Promo 拥有更完整或在线访问权限，具体以当前授权为准。
边界与注意：不要在聚合 FUTOI 数据基础上推断个人交易者行为、股票或外汇或期权持仓，或精确的单合约 FIZ/YUR 持仓。在就具体合约或参与者下结论前，需说明聚合口径的相关限制。更多端点、字段、聚合规则、访问注意事项、分页和输出模式见 references/futoi.md。