Ffiec Call Reports

FFIEC Call Reports — 美国银行项目明细

美国所有银行的季度资产负债表、损益表、监管资本、贷款、存款和信贷质量明细，均按 FFIEC Call Report（综合状况与收益报告，表格 031/041/051）申报——4,336 家申报机构，细化至项目级别。

Pipeworx 的一部分：https://pipeworx.io — 一个将 AI Agent 连接到 1879+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联、未获其认可，也并非由其发布。

为什么它不属于 fdic，也不是一回事

有三个数据包涉及美国银行，但用途各不相同：

数据包	提供内容	使用的标识
fdic	汇总财务数据、机构记录、银行倒闭信息——161 个源自 FDIC 的字段	FDIC 证书编号
本数据包	项目明细——每家银行每季度有数千个 MDRM 编码字段，反映实际申报内容	Federal Reserve IDRSSD
ncua	为信用合作社提供相同形式的数据；它们不会出现在上述任一数据包中	NCUA 章程编号

这种划分是基于标识空间的决定，而非偏好。银行同时拥有 FDIC 证书编号和 Federal Reserve IDRSSD；对于同一家机构，这两个编号并不相同——JPMorgan Chase Bank 的证书编号为 628，rssd 为 852218。CDR 使用 IDRSSD 作为键；fdic 使用证书编号作为键。将它们混在一个数据包中，调用方就可能把某个工具返回的标识传给另一个工具，却在无声无息中得到另一家银行的数据。

因此：这里接受这两种标识，也会同时返回它们，并且每个响应都会说明实际用于解析的标识。

工具

工具	可回答的问题
ffiec_search_banks	俄亥俄州有哪些银行？——支持模糊匹配名称、城市和州
ffiec_call_report	给我看看 JPMorgan 的 Call Report——单个申报机构、单个季度，并附有标签
ffiec_line_item	查询某个项目随时间的变化——资产、存款、净收入或任意 MDRM 代码
ffiec_compare_banks	对整个行业进行排名，或比较指定的一组银行
ffiec_coverage	已加载哪些季度、申报延迟，以及代码的含义

身份验证

无需密钥。

单位——银行与信用合作社比较时容易踩的坑

**Call Report 以千美元为单位申报。NCUA 则以整美元为单位申报。**直接比较两者的原始数字是错误的，结果会对信用合作社有利 1000 倍。

这里的每个金额都已统一为整美元，同时保留原始申报数值：

{ "mdrm": "RCFD2170", "label": "TOTAL ASSETS",
  "value_usd": 4016571000000, "as_filed": 4016571000,
  "unit": "USD (normalised from the thousands banks file in)" }

资本比率以带有字面字符 % 的百分比形式提供，并按 unit: "percent" 原样传递——绝不乘以任何倍数。

镜像的数据

七个核心附表——RC（资产负债表）、RI（损益表）、RC-R I（监管资本）、RC-N（逾期和非应计项目）、RC-C I（按类别划分的贷款）、RC-E（存款）、RC-K（季度平均值）。测算结果：每季度 149 万个值，占全部 46 个附表共 523 万个值。

完整的 3,843 个代码 MDRM 字典无论如何都会加载，因此即使没有保存对应的值，任何代码也都可以查明含义——ffiec_coverage({code}) 会对这类代码返回 mirrored_values: false。

非数值单元格（每季度 17,100 个）会存入专用表，而不会被丢弃。CONF 很重要：它表示银行已申报但将该值列为机密，这与“未报告”不同。

数据源

• https://cdr.ffiec.gov/public/PWS/DownloadBulkData.aspx — FFIEC Central Data Repository 批量下载。

下一位使用者否则可能需要重新发现的事项

• 没有 API。 CDR 下载使用 ASP.NET WebForms：选择某个系列并通过 AJAX 回发后，期间下拉列表才会填充，因此下载一个季度需要三次请求（GET 获取 __VIEWSTATE，POST 填充期间列表，再 POST 下载）。无需登录。脚本客户端访问 www.ffiec.gov/npw/* 会返回 403，因此不能作为替代方案。
• RCFD 与 RCON 表示合并口径，不是两种不同的指标：RCFD 包含境外分支机构，RCON 仅限境内。银行针对某一项目只会提交其中一种，因此查询时必须同时尝试两者，否则对于已正常提交数据的银行也会返回“未报告”。
• 每个报表文件的第 2 行都是人工可读的标签，不是数据。从第 2 行开始解析会导致每个值都错位一行。
• 数值单位是千（见上文）。
• CONF 是一个值。 不要将其强制转换为 null。
• 申报延迟约为 106 天，且已有测量数据——03/31/2026 的存档文件在 ZIP 中标注的日期是 07/15/2026。并非约 60 天，尽管本文件早期草稿曾如此写道。这会影响数据新鲜度 SLA：每季度 91 天的更新周期，加上 106 天的延迟，在下一次发布前，我们能合理持有的最新数据可能已有约 197 天，因此低于 200 天的阈值会在每个周期都触发误报。

快速开始

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

{
  "mcpServers": {
    "ffiec-call-reports": {
      "url": "https://gateway.pipeworx.io/ffiec-call-reports/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/ffiec-call-reports/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 都连接到同一个网关和相同的 1879+ 个数据源。唯一的区别是直接列出哪些工具包的工具；无论使用哪个 URL，ask_pipeworx 都能访问所有工具。

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

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

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/ffiec_search_banks。查找工具包：POST https://gateway.pipeworx.io/v1/tools/search_packs，请求体为 {"query":"..."}。

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

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

{
  "mcpServers": {
    "ffiec-call-reports": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-ffiec-call-reports"]
    }
  }
}

或者直接运行以确认它能启动：

npx -y @pipeworx/mcp-ffiec-call-reports

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

使用 ask_pipeworx

你可以不用直接调用工具，而是用自然语言提问——此方式既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Ffiec Call Reports data" })

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

更多信息

• 文档与指南
• pipeworx.io

许可证

MIT