关于 algopack-futoi
用于直接访问 MOEX FUTOI 接口的技能,面向分析期货参与者群体的聚合持仓快照。它指导数据获取、解析和输出,并明确说明数据延迟与聚合数据的解读限制。
主要功能
- 01查询全部期货或指定标的
- 02解析 FUTOI 数据块
- 03按 FIZ 和 YUR 分组
- 04规范化 ISS 列与数据数组
- 05输出表格或图表
- 06说明数据聚合限制
适用场景
- 01获取指定日期的期货持仓快照
- 02整理个人与法人群体数据
- 03将结果导出为 CSV 或 JSON
- 04绘制浏览器或笔记本图表
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ moexalgo/ algopack-skills --skill algopack-futoi安装后在 Claude Code 中输入/algopack-futoi确认已加载。
附带文件references/futoi.md
详细介绍
ALGOPACK FUTOI
概述
需要直接访问 FUTOI 端点时使用此技能。FUTOI 是按参与者群体拆分并以聚合快照形式发布的期货未平仓量数据;不适用于股票、外汇、期权、个别交易者数据,或精确的单合约 FIZ/YUR 持仓数据。
访问说明:Стартовый / Starter 免费令牌访问的 FUTOI 数据延迟至 T - 15 days;Promo 可获得更完整或在线的数据访问权限,具体取决于当前权益。
快速入门
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=... 获取单个工具或标的的数据。
核心工作流
- 仅使用
FO代码或标的。 - 获取指定日期或范围的行,并解析
futoi区块。 - 按
clgroup拆分:FIZ代表个人,YUR代表法人实体。 - 在筛选、编写表格或绘图之前,将 ISS 的
columns和data数组规范化为行。 - 根据请求选择输出形式:交接时使用 CSV/JSON 表格,浏览器输出使用简单的 HTML 图表,笔记本或脚本输出使用 Matplotlib 或 pandas 绘图,在应用内使用该应用现有的绘图技术栈。
- 根据特定合约或参与者得出结论之前,先说明聚合数据的注意事项。
参考资料
阅读 references/futoi.md,了解端点、字段、聚合规则、访问注意事项、分页和输出模式。
范围限制
请勿根据聚合的 FUTOI 行推断个别交易者的行为、股票/外汇/期权持仓,或精确的单合约 FIZ/YUR 持仓。
评论
支持 Markdown