Nyfed Markets

@pipeworx/nyfed-markets

纽约联储 Markets Data API——回购／逆回购（ON RRP）操作结果、证券借贷操作、SOMA 投资组合持仓、交易台参考利率（SOFR、EFFR、OBFR、TGCR、BGCR）以及一级交易商调查统计数据。这些是 FRED 每日利率汇总背后的操作级和证券级数据，并非重复提供这些汇总数据。

属于 Pipeworx——一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。

工具

• nyfed_repo_operations(operation_type, start_date, end_date, term, limit) — 回购／逆回购（ON RRP）操作结果：总额、交易对手数量、获配利率以及按证券类型划分的明细。
• nyfed_seclending_operations(operation, start_date, end_date, cusips, limit) — 证券借贷操作结果（每日计划 + 延长期限）。
• nyfed_soma_holdings(view, holding_type, as_of_date, cusip, limit) — SOMA 投资组合：按资产类别汇总的历史数据、按日期查看完整的 CUSIP 级别国债／机构证券快照，或查看某个 CUSIP 的完整持仓历史。
• nyfed_reference_rates(rate_type, number) — SOFR/SOFRAI/TGCR/BGCR（有担保）和 EFFR/OBFR（无担保）的最新数据或近期历史数据，包括百分位区间和交易量。
• nyfed_primary_dealer_stats(mode, keyid_filter, seriesbreak, limit) — FR 2004 一级交易商每周持仓／交易调查；mode=list_series 用于浏览 keyid 目录，mode=latest 返回当前值。

认证

无需密钥。无需注册，无需 API 密钥，未发现速率限制标头。

数据源

• https://markets.newyorkfed.org/api/rp/... — 回购／逆回购操作。
• https://markets.newyorkfed.org/api/seclending/... — 证券借贷操作。
• https://markets.newyorkfed.org/api/soma/... — SOMA 持仓（汇总、国债、机构证券）。
• https://markets.newyorkfed.org/api/rates/... — 参考利率。
• https://markets.newyorkfed.org/api/pd/... — 一级交易商统计数据。
• Swagger 规范：https://markets.newyorkfed.org/static/docs/markets-api.yml（.html 文档页面是一个用于渲染此文件的 JS SPA——请直接获取 .yml，.html 页面无法用于抓取）。

注意事项

• /api/rp/results/search.json 的 operationTypes 查询参数已确认是静默无效的。 使用 operationTypes=Reverse Repo 查询时，返回结果仍会混入 Repo 行（经实时验证：对于一个 9 天的时间窗口，返回了 21 行，而该窗口本应只有约 7 行仅含 RRP 的结果）。此端点上的 method 和 term 尚未验证，也不可信。本程序包始终在获取数据后于客户端筛选 operationType/term。基于路径的筛选在 latest 端点（/api/rp/{reverserepo|repo|all}/all/results/latest.json）上确实有效，同日查询会改用此端点。
• SOMA 持仓数据的发布时间约滞后 1 周。 在 2026-09-23 探测时，/api/soma/asofdates/latest.json 返回了 2026-09-16——这是正常情况，并非错误。as_of_date 默认使用最新发布的日期。
• 机构证券持仓类型的路径段 agency debts 中包含一个字面空格（/api/soma/agency/get/agency debts/asof/{date}.json）。工具接受易用写法 agency_debts，并会自动对空格进行 URL 编码。
• 在国债／机构证券 SOMA 端点上使用 holding_type=all 会返回该日期的每一个 CUSIP——多达数百行。本程序包会截断至 limit（默认值为 20），并始终报告 total_holdings，确保截断情况清晰可见，而非悄无声息地发生。
• 一级交易商 keyid 是不透明代码（例如 PDPOSMBS-TOT），按「系列分段」窗口分组，窗口定义可能随时间变化（/api/pd/list/seriesbreaks.json 是权威来源）。本程序包通过将 enddate 为 9999-12-31 的窗口视为「当前」窗口，而非硬编码窗口 ID，因此无需更改代码即可应对下一个系列分段。
• 给定 effectiveDate 的参考利率会在下一个工作日发布——尚未观察到 EFFR/OBFR/TGCR/BGCR 的「当日」数据；只有 SOFR/SOFRAI 有时会显示当日数据。这不是发布延迟错误。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "nyfed-markets": {
      "url": "https://gateway.pipeworx.io/nyfed-markets/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/nyfed-markets/mcp 上的 tools/list 会返回上表中的工具，以及共享的 Pipeworx 元工具——ask_pipeworx、discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于此表所列：目前，单个工具包端点除了该工具包自有工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明确切范围，是了解当天实际范围的权威依据。

这是有意设计的，并非意外的多路复用。元工具让范围受限的连接能够回答此工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录进行路由——无需再添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构占用的上下文多于路由带来的收益，请连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不仅是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都指向同一个网关和相同的 1683+ 个数据源。直接列出哪些工具包的工具是唯一的区别；无论连接哪个端点，ask_pipeworx 都可以访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/nyfed_repo_operations \
  -H 'Content-Type: application/json' \
  -d '{"operation_type":"reverserepo"}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/nyfed_repo_operations。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经过网关：

{
  "mcpServers": {
    "nyfed-markets": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-nyfed-markets"]
    }
  }
}

或者直接运行它，确认服务能够启动：

npx -y @pipeworx/mcp-nyfed-markets

它通过 stdin/stdout 使用 MCP，并为仅此工具包的工具响应 initialize/tools/list/tools/call——不包含上方网关连接额外提供的任何共享元工具。来源相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗的英语提问，而不是直接调用工具——此功能既适用于上方的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Nyfed Markets data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT