Dtcc Swaps

@pipeworx/dtcc-swaps

DTCC 的公开实时掉期价格披露信息流（pddata.dtcc.com）—— 逐笔掉期交易及其定价条款，依据《商品期货交易委员会》（CFTC）第 43 部分实时披露，涵盖受 CFTC 监管的掉期（商品、信用、股权、外汇、利率）、受 SEC 监管的基于证券的掉期（信用、股权、利率）和受加拿大监管机构监管的掉期（信用、股权、利率），以及基础日内／日终批量披露文件的索引。

属于 Pipeworx 项目——一个将 AI Agent 连接到 1878+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联、未经其认可，也非由其发布。

工具

• dtcc_swaps_recent(regulator, asset_class, limit?) — 返回某监管机构／资产类别组合最近披露的掉期交易（例如 CFTC/IR），按最新优先排序，数据来自信息流滚动的约 100 条记录窗口。每条记录包含名义金额、固定／浮动利率条款、执行／生效／到期日期、产品标识符和 actionType。
• dtcc_swaps_dissemination_files(regulator, asset_class, granularity?, limit?) — 返回 DTCC 公开批量披露文件的索引（5 分钟的“slice”文件，或每天一个的“cumulative”／EOD 文件），按监管机构／资产类别筛选，并列出每个文件的行数和公开下载 URL。这里只列出文件链接，不会下载或解压这些文件。

身份验证

无需密钥。在可访问的界面中未发现任何账号、密钥或点击确认条款（详见下方的调研报告）——该信息流是公开 S3 存储桶上的公开、无需身份验证的 JSON API，并已启用目录列表功能。

数据源

• https://pddata.dtcc.com/ppd/api/general/regionname / .../bucketname — 解析实时公开 S3 存储桶名称（截至 2026-09-23 为 kgc0418-tdw-data-0；此软件包直接调用该存储桶，使用的两个值与控制面板 SPA 加载时读取的值相同）。
• https://kgc0418-tdw-data-0.s3.amazonaws.com/dashboard/Ticker.json — 为 dtcc_swaps_recent 提供数据。这是一个扁平映射，键为 {REGULATOR}_{ASSETCLASS}（实时键包括 CA_CR、CA_EQ、CA_IR、CFTC_CO、CFTC_CR、CFTC_EQ、CFTC_FX、CFTC_IR、SEC_CR、SEC_EQ、SEC_IR），值为对应存储桶中最近披露的约 100 条交易记录。数据持续更新；此软件包每次都会重新获取数据，不会缓存或镜像。
• https://kgc0418-tdw-data-0.s3.amazonaws.com/dashboard/Slice.json（日内）和 .../Cumulative.json（日终）— 为 dtcc_swaps_dissemination_files 提供数据。键采用相同的 {REGULATOR}_{ASSETCLASS} 格式，每个条目都指向可下载的 .zip 文件，其中包含对应时间段／日期的 CSV 交易数据及其行数。

给下一位使用者的注意事项

• 通过 grep 主机名，无法从 DTCC 网站自身的 HTML/JS 源码中发现这些端点——pddata.dtcc.com/ppd/ 上的 Angular SPA 会在运行时通过自身的 /ppd/api/general/* 调用解析存储桶名称， 并使用根据该响应构建的相对路径读取 JSON 文件。 存储桶名称（kgc0418-tdw-data-0）并未直接出现在任何已发布的 JS bundle 中。它是通过真实浏览器加载页面并查看网络请求找到的， 而不是通过 grep bundle 找到的。如果 DTCC 更换存储桶， 应重新检查 regionname/bucketname 这两个调用。
• regulator/asset_class 组合不是固定枚举——CA 和 SEC 从不包含 FX 或 CO，只有 CFTC 包含。两个工具都会抛出清晰的错误， 并列出该次调用响应中实际存在的实时键，而不是依赖 硬编码列表，因为 DTCC 可能随时新增或停用组合。
• 更正和取消不是原地修改。 对先前已披露交易的更正、 取消、修改或终止，会作为一条新的记录出现在 Ticker.json 中， 其 actionType 会设为 CORR / EROR / MODI / TERM，而不是 NEWT。应将数据流视为只追加的事件日志。若调用方只想获取“新交易”， 应在客户端按 actionType === "NEWT" 进行筛选；此工具包返回原始事件流， 不会暗中内置这种行为。
• Ticker.json 是滚动窗口（每个存储桶约 100 行），并非历史记录。 如需获取更多数据，dtcc_swaps_dissemination_files 会指向底层 zip 文件 （5 分钟切片或 EOD 累计文件），但下载和解压这些文件有意不纳入此工具包的范围—— 它会返回文件索引（名称、URL、行数、窗口），方便调用方按需获取文件。
• 未找到许可/条款页面。 www.dtcc.com/legal.php（一般企业网站） 每次获取时都会返回 403（Akamai 机器人防护），这与 pddata.dtcc.com 数据流无关；该数据流全程无需身份验证。 代理此数据的依据是，DTCC 作为在 CFTC/SEC 注册的掉期数据存储库运营， 且 CFTC 第 43 部分法规要求实时公开报告掉期交易和定价数据—— 已通过 www.cftc.gov/IndustryOversight/DataRepositories/index.htm 进行实时确认。完整探测记录：docs/api-wave-2026-09-23-spike.md（来源 #3）。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/dtcc-swaps/mcp 上的 tools/list 会返回上表中的工具， 以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，以及 整个网关共用的其他工具。因此，你看到的工具数量会多于此表：单个工具包端点目前 会同时列出约 30 个共享工具和该工具包自身的工具。连接的 initialize 响应会说明其确切范围， 并且是当天范围的权威信息。

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

也可以连接完整的 Pipeworx 网关，直接列出每个工具包的所有工具， 而不只是此工具包的工具：

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

两个 URL 都连接到同一个网关和相同的 1878+ 个数据源。唯一的区别是直接列出的工具 来自哪个工具包；无论连接哪个端点，ask_pipeworx 都能访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/dtcc_swaps_recent \
  -H 'Content-Type: application/json' \
  -d '{"regulator":"CFTC","asset_class":"IR","limit":3}'

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

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

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

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

或者直接运行，确认其能够启动：

npx -y @pipeworx/mcp-dtcc-swaps

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，但仅支持此软件包的工具，不包含上述网关连接额外提供的任何共享元工具。相同的源代码，相同的工具，无需 ask_pipeworx 路由。

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Dtcc Swaps data" })

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

更多

• 文档和指南
• pipeworx.io

许可证

MIT