mcpField
A
algopack-futoi

algopack-futoi

github.com/moexalgo数据与数据库441 次安装20 周前更新
代码仓库

关于 algopack-futoi

用于直接访问 MOEX FUTOI 接口的技能,面向分析期货参与者群体的聚合持仓快照。它指导数据获取、解析和输出,并明确说明数据延迟与聚合数据的解读限制。

主要功能

  1. 01查询全部期货或指定标的
  2. 02解析 FUTOI 数据块
  3. 03按 FIZ 和 YUR 分组
  4. 04规范化 ISS 列与数据数组
  5. 05输出表格或图表
  6. 06说明数据聚合限制

适用场景

  1. 01获取指定日期的期货持仓快照
  2. 02整理个人与法人群体数据
  3. 03将结果导出为 CSV 或 JSON
  4. 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=... 获取单个工具或标的的数据。

核心工作流

  1. 仅使用 FO 代码或标的。
  2. 获取指定日期或范围的行,并解析 futoi 区块。
  3. 按 clgroup 拆分:FIZ 代表个人,YUR 代表法人实体。
  4. 在筛选、编写表格或绘图之前,将 ISS 的 columns 和 data 数组规范化为行。
  5. 根据请求选择输出形式:交接时使用 CSV/JSON 表格,浏览器输出使用简单的 HTML 图表,笔记本或脚本输出使用 Matplotlib 或 pandas 绘图,在应用内使用该应用现有的绘图技术栈。
  6. 根据特定合约或参与者得出结论之前,先说明聚合数据的注意事项。

参考资料

阅读 references/futoi.md,了解端点、字段、聚合规则、访问注意事项、分页和输出模式。

范围限制

请勿根据聚合的 FUTOI 行推断个别交易者的行为、股票/外汇/期权持仓,或精确的单合约 FIZ/YUR 持仓。

评论

支持 Markdown