shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 数据与分析需要 API Key

繁微 Fiona 外盘数据

使用内外盘品种映射与已同步的外盘行情数据，查询内盘品种对应的外盘交易所、代码和产品，整理指定区间的价格数据、涨跌幅与数据更新时间，并计算价差、价比和统计指标。

person作者: u_f43476d8hubenterprise
download下载资源包

繁微 Fiona 外盘数据

前置条件与 API Key

本 Skill 的核心数据依赖 foreign（/mcp/foreign），盘前对齐还依赖 futures_market_data（/mcp/futures_market_data）。首次调用前检查 get_foreign_domestic_mapping、get_foreign_market_analysis 及所需市场数据工具是否已就绪；工具缺失时，先按对应配置添加缺少的 MCP。

  • foreign 需要 API Key。实际鉴权使用 Bearer Token，在客户端凭证管理区将服务方提供的 API Key 配置为 Authorization: Bearer <API Key>。
  • futures_market_data 是当前公开免鉴权端点，不需要 API Key，不要为它配置 Authorization 请求头。
  • 可选的 news 和 economic_calendar MCP 需要 API Key；只在用户选择启用该增强时配置。

API Key 申请：目前暂不支持在线自助申请，请联系繁微对口销售或项目联系人获取。

不要把真实 API Key 粘贴到对话、Skill 文件或版本库中。401/403 时检查需鉴权端点的 API Key；超时或 transport error 时检查 URL、网络和 MCP 连接。

盘前预警的默认时间窗口、推荐查询时段、同步延迟、Web Search 兜底和实际覆盖时间展示见 盘前预警取数规则，执行盘前预警时必须遵守该文档。

本 Skill 侧重于“内盘品种与对应外盘产品的映射关系”和“外盘区间行情/统计分析”。它不做交易策略、交易指令或委托细节。Skill 的主要定位是用于盘前预警：在国内日盘或夜盘开盘前，基于已同步的外盘价格变动与历史映射误差，为内盘开盘方向（上/下/中性）提供统计化的预判与不确定性说明。

能力定位

  • 发现某个内盘品种对应的外盘产品、交易所、代码、品种名称和映射关系。
  • 查询指定内盘品种对应外盘的行情统计、走势摘要、同期变化和可选分钟序列数据。
  • 说明外盘数据的更新频率和可用性边界，避免将其当成实时分钟行情。

工作流程

  1. 目标识别：确认用户意图为“盘前预警”“内外盘映射”或一般的外盘行情查询；本 Skill 的主场景为盘前预警。盘前预警先按 盘前预警取数规则 判断用户指定时间、提问时段和默认窗口。

  2. 首要工具：优先调用 get_foreign_domestic_mapping（映射）和 get_foreign_market_analysis（外盘区间/序列）。这两个工具位于 foreign MCP（/mcp/foreign）。更多可选端点与实现细节见 references/optional-mcp.md。

    注：若用户未指定品种且请求“今天哪些品种值得关注”或“昨晚谁波动最大”，执行简易全市场扫描：

    • 调用 get_foreign_domestic_mapping 读取映射表并保留至少有一个外盘映射的内盘；
    • 对候选映射并行调用 get_foreign_market_analysis 获取区间价格字段（open/high/low/last）与区间涨跌幅；
    • 跳过无有效行情的数据项，按绝对 pct_change（或 last-open）降序取前 N（默认 5），返回 domestic_code, domestic_name, top_foreign(exchange,symbol), open, high, low, last, pct_change, last_ts。
    • 不使用不存在的“振幅”字段或复杂加权，遇到数据缺失在结果中标注并跳过。

  3. 最低输入：映射查询至少需 domestic_code 或 domestic_name 中的一项。行情分析需明确时间区间（日级或历史区间）；分钟序列受 include_series 与 500 点上限限制，若查询超过限制，可分多次查询。

  4. 数据对齐与换算：盘前预警必须通过 /mcp/futures_market_data 拉取内盘历史序列（get_futures_timeseries_quotes / get_futures_dominant_quotes），按相同口径对齐（分钟线用 close）；接口返回后必须读取并校验每条记录的实际时间戳，只保留目标 start_datetime—end_datetime 范围内的数据；若需汇率换算，按 references/exchange-rate.md 报告汇率来源与时间。涨跌幅使用过滤后实际返回数据的第一条和最后一条，不用理论窗口端点或越界记录代替。

  5. 预判逻辑（简述）：优先使用 get_foreign_market_analysis 的区间涨跌幅（pct_change 或 last - open）作为盘前判断依据；若用户要求更深入的历史统计、分位或置信区间，基于返回的区间/序列数据自行编写代码计算，并在输出中说明计算口径与样本区间。Skill 只输出开盘方向（上/下/中性）与不确定性说明，不提供交易建议。

  6. 数据不可得或异常：若 MCP 返回空、未配置或连接失败，先在输出中明确标注数据缺失并提示用户检查或配置 MCP 连接并提供必要的授权信息；不要在未取得用户许可的情况下以公开网页检索替代 MCP 数据。公开网页检索仅能作为补充手段（在用户同意时使用），并且在结果中必须明确标注检索来源、URL 与检索时间戳。遇到部分字段缺失时，应在结果中说明哪些字段为外部检索补充。

可选 MCP（Optional MCP）

本 Skill 可选使用更多 MCP 以增强盘前判断与跨市场比较能力，详见参考文档：Optional MCP 指南。常见组合包括：

  • /mcp/futures_market_data：拉取内盘主力/分钟序列、交易日历和截面快照，用于与外盘走势对比；
  • /mcp/news：检索同时间窗的新闻事件，列出候选事件辅助判断但不直接断定因果关系；
  • /mcp/economic_calendar：识别重要宏观事件与市场假期，解释潜在的跳空或流动性缺口；

使用要点：对齐价格口径（例如分钟收盘价 vs 外盘分钟序列）、明确字段含义，并在输出中说明所有假设与数据缺口。

业务原则

  • 内外盘映射应优先返回“内盘品种→外盘产品列表”及其较关键的对应关系，不要只给单一可能结果。
  • 外盘行情分析应包含：外盘标的、时间区间、主要价格指标、涨跌幅、趋势描述、统计摘要、以及数据覆盖范围。
  • 如果外盘品种存在多个对应映射，说明各个映射之间的差异和使用场景，不随意替换成最熟悉的一个。
  • 不把“外盘更新频率”误读为“实时数据”。当用户要求盘中参考时，应说明：外盘数据通常每日同步两次，实际查询结果可能滞后于当前盘中行情。
  • 不输出没有数据支撑的价差结论或跨市场推论。所有结论都要基于 MCP 返回的字段或明确说明数据不足。

输出要求

  • 先给核心结论：例如“该内盘品种对应到哪些外盘标的、当前分析区间是否上涨、主要统计特征是什么”。
  • 明确说明数据口径：内盘品种、外盘品种、交易所、时间区间、是否包含分钟序列，以及数据同步的时点说明。
  • 对映射型问题，给出“内盘品种→外盘品种”的映射表，并说明映射规则、品种对应关系、是否存在多个匹配或不确定项。
  • 对行情分析问题，给出“外盘行情走势摘要 + 统计指标 + 关键观察点”。如果包含分钟序列，说明该序列最多返回 500 条点并非实时分时。
  • 如果问题涉及“盘前参考”，要补充“外盘数据非实时，仅供参考，实际交易时仍应对照当日最新市场情况”。
  • 盘前预警必须说明请求窗口与两个市场实际返回数据的首末时间；数据同步导致的空档（尤其约 08:10—09:00、20:10—21:00）必须单独标注。
  • 推荐日盘盘前预警在 08:30—09:00 查询，推荐夜盘盘前预警在 20:30—21:00 查询。若用户在推荐时段前坚持查询，先建议稍后再查；用户明确仍要查询时，才可用 Web Search 补充尚未同步的外盘数据，并标注来源、URL、数据时间和检索时间。
  • 交易日期必须按“前一个交易日”处理并通过交易日历确认，不能直接使用自然日减一；周一或节假日后的首个交易日要回溯到实际前一个交易日晚间。
  • 对于仅能提供映射但无法获得行情时，仍应交代映射结果并说明行情数据不可得。

合规与边界（摘要）

  • 不在 Skill 中要求或传入未经授权的凭证或密钥；部署者在接入私有 MCP 时负责凭证管理。

适用场景

  • 询问某个内盘品种对应哪些外盘合约或交易所。
  • 询问某个内盘品种对应外盘的历史区间行情、统计摘要或趋势判断。
  • 询问内外盘品种的映射关系、外盘市场名称、代码，以及是否有多个候选映射。
  • 盘前查外盘数据时，需要说明外盘数据的更新时间与可用性边界。

不适用场景

  • 需要实时盘中价格、瞬时成交、深度行情或报价委托簿信息。
  • 需要具体交易策略、买卖点、仓位建议或投研结论。
  • 需要非期货衍生品、贵金属现货、外汇或宏观新闻资料的深度解读。
  • 需要全面的市场资讯、政策解读、公司基本面或行业链研究；这些内容应由其他 Skill 补充。

风险提示与免责声明

完成实质性回答后，根据本次输出内容附加一项固定提示，不得省略或改写：

  • 仅查询、整理、计算或复述数据时，使用普通提示。
  • 涉及方向、趋势、强弱、结构含义、影响、情景、风险、原因推断或交易决策时，使用加强提示；不得承诺收益或替用户决策。
  • 配置、报错和澄清问题无需提示。

普通提示：

风险提示：本内容由 AI 根据可用数据和材料生成，少量数据处理流程及研究框架来自于东证衍生品研究院；AI 生成内容不代表东证衍生品研究院及其研究人员的观点，也未经其审核或背书。数据可能存在延迟、缺失或处理误差，请核对原始来源。本内容仅供信息参考和研究辅助，不构成投资建议。

加强提示：

风险提示：本内容由 AI 根据可用数据、材料和研究辅助流程生成，少量数据处理流程及研究框架来自于东证衍生品研究院；AI 生成内容不代表东证衍生品研究院及其研究人员的观点，也未经其审核或背书。数据、计算和表述可能存在延迟、缺失、口径差异、处理误差或不确定性，涉及的方向、情景、风险及影响不构成预测或保证。请核对原始资料和计算口径。本内容仅供信息参考和研究辅助，不构成投资研究报告、投资建议、投资咨询意见、交易依据或收益承诺。期货及衍生品交易风险较高，请独立、审慎决策。

提示置于回答及可展示产出物末尾，不替代正文中的数据来源、时点、口径和局限说明；结构化产出使用 risk_level 和 risk_disclaimer 字段携带同一提示。