> ## Documentation Index
> Fetch the complete documentation index at: https://www.worldmonitor.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 资本流动

> WorldMonitor 如何根据 IMF 国际收支、IMF 证券投资与直接投资头寸以及 BIS 跨境银行统计,衡量约 230 个经济体以及任意两个经济体之间资金的流入与流出。

*本方法论由 World Monitor 创始人 [Elie Habib](https://www.worldmonitor.app/blog/authors/elie-habib/) 维护。已发布的修订记录在[更正日志](/docs/zh/corrections)中。*

## 从这里开始

资本流动数据集为任一经济体以及任意一对经济体回答两个问题:

* **资金是在流入还是流出,是否异常?** 来自 IMF 国际收支的总流入和总流出,并对最新季度做推导分类。
* **资金去向何处,经由哪个渠道?** 两个指定国家之间双向的银行存款与贷款、证券持有和直接投资。

所有数据均为 IMF 和 BIS 发布的官方统计。唯一的推导值是阶段标签和 z 分数,它们出现的地方都标注为推导值。

<Info>
  一个人迁往另一个国家不是国际收支交易。根据 IMF 的 BPM6 规则,其资产随居民身份一同变更,记为重新分类而非流量。因此,无论规模多大,财富迁移都不会出现在本数据集中。
</Info>

## 国家视图

每个国家最多有四个视图。来源未就该国发布任何数据时,相应视图不出现。

| 视图 | 来源 | 指标 | 频率 | 典型滞后 |
| - | - | - | - | - |
| `bop` | IMF 国际收支(`IMF.STA/BOP`) | 总流入与总流出:直接投资、证券投资和其他投资,不含储备 | 有季度数据时为季度,否则为年度 | 1–2 个季度 |
| `bank` | BIS 本地银行统计(`WS_LBS_D_PUB`) | 该国非银行居民的跨境贷款与存款(工具 G,不含债务证券) | 季度 | 约 2 个季度 |
| `portfolio` | IMF 按对手经济体划分的证券投资头寸(`IMF.STA/PIP`,原 CPIS) | 各报告经济体持有该国证券的情况 | 年度 | 9–12 个月 |
| `fdi` | IMF 按对手经济体划分的直接投资头寸(`IMF.STA/DIP`,原 CDIS) | 按直接对手方划分的对内和对外直接投资头寸,以该国自身报告为准 | 年度 | 约 2 年 |

银行头寸以最新 BIS 季度为准;更早停止的序列记为缺失。所有金额均为美元,单位十亿。占 GDP 的比例使用世界银行最新的现价美元 GDP。

### 总额而非净额

流入是非居民对该国的净新增债权(BPM6 *负债净产生*)。流出是居民对境外的净新增债权(*金融资产净获得*)。两者均为直接投资、证券投资和其他投资之和,只有三项都有报告的季度才计入。部分加总会看起来像骤降。

净额掩盖了大部分重要信息。一个金融中心每季度的流入和流出可能各达数千亿美元并相互抵消,因此净额与总额并列报告,而不是取代总额。

### 阶段状态

季度序列按 Forbes 与 Warnock(2012)方法分类:

1. 取总流量的四季度合计,以及它相对上一年同期合计的变化。
2. 将该变化与过去 20 个季度(至少 16 个)的均值和标准差比较。
3. 当变化偏离均值超过一个标准差时开始一个阶段;阶段期间必须至少一次达到两个标准差,回到一个标准差以内时结束,且必须持续一个季度以上。

| 方向 | 上升 | 下降 |
| - | - | - |
| 流入(非居民) | `surge` | `stop` |
| 流出(居民) | `flight` | `retrenchment` |

最新季度的状态在两侧都有数据的季度上评估,因此状态、z 分数和序列始终描述同一个季度。仅有年度数据的序列没有状态和阶段。

**效果如何。** 分类器在首次运行前列出的 16 个有记录的危机阶段上做了回测(`node scripts/backtest-capital-flow-episodes.mjs`)。在有数据的 15 个中识别出 9 个,每种类型约占国家-季度的 9–11%。它能可靠地捕捉大范围的融资危机;但会把以偿还外债形式出现的资本外逃标记为 `stop`,也无法识别经官方类别未记录渠道发生的外逃。请把这些状态当作筛选异常季度的工具,而不是定论。

## 国家对

同时指定国家和对手国,即可得到两者之间的双向数据。响应中 `a` 为国家,`b` 为对手国。

| 分项 | 衡量内容 | 报告方 | 数值 |
| - | - | - | - |
| `aDepositsInB`、`bDepositsInA` | 一方非银行居民在另一方银行的存款 | 吸收存款的银行体系 | 存量、最近四个调整后季度流量之和、八个季度历史 |
| `aBorrowingFromB`、`bBorrowingFromA` | 一方银行对另一方非银行的跨境贷款 | 放贷的银行体系 | 同存款 |
| `aHoldingsOfB`、`bHoldingsOfA` | 一方持有另一方证券 | 持有方 | 存量及上一年同一持仓 |
| `aFdiInB`、`bFdiInA` | 一方对另一方的直接投资 | 双方 | 投资方的数字,以及东道方对同一头寸的数字 |

银行分项使用 BIS 的*贷款与存款*工具,因此银行发行或持有的债务证券不计入存款或贷款。少数报告体系只按*全部工具*发布双边明细;其分项使用该口径并标注 `instrument: all_instruments`,其余银行分项均标注 `instrument: loans_deposits`。银行流量是 BIS 的*经汇率和断点调整*的变化。它剔除了汇率变动和报告断点,因此反映的是资金移动而非估值。证券投资和直接投资数字是头寸;两年之间的变化混合了新增资金与价格、汇率变动。

### 分项状态

每个分项都带有 `status`,它与数字同样重要。

| 状态 | 含义 |
| - | - |
| `reported` | 报告方公布了与该对手方的数字。 |
| `not_itemized` | 报告方发布双边数据,但没有该对手方的当期数字:未单列(可能为零、很小或因保密而未公布),或其序列在最新期别之前已停止。它是未知,而不是零。银行分项仍可能在 `history` 中保留已报告的季度。 |
| `not_published` | 报告方不发布任何双边明细,因此在公开数据中看不到这一方向。 |

约 30 个银行体系向 BIS 发布按对手方划分的明细,约 80 个经济体报告证券持有,约 100 个经济体按对手方报告直接投资。存放在前一组以外银行体系中的存款,从任何一方都看不到。

### 为什么直接投资有两个数字

一对国家的双方都会报告同一笔直接投资头寸:投资方作为对外投资,东道方作为对内投资。两者很少一致,原因包括覆盖范围、估值、时间以及对过渡实体的归属方式不同。数据集以 `stockUsdBn` 报告投资方的数字并标注 `basis: investor`,同时以 `counterpartReportUsdBn` 保留东道方的数字。只有东道方报告时,使用东道方数字并标注 `basis: host`。

直接投资头寸按*直接*对手方划分。通道型经济体经由特殊目的实体承载大量头寸,因此直接对手方往往不是最终所有者。

## 使用方法

**REST。** `GET /api/economic/v1/get-capital-flows`

| 参数 | 作用 |
| - | - |
| `country` | ISO 3166-1 alpha-2。省略则返回所有国家。 |
| `counterpart` | ISO 3166-1 alpha-2。与 `country` 一起使用时,增加 `pair` 以及对手国自身的视图。 |
| `include_series` | 为每个国家增加 12 个季度或 6 年的国际收支流量。 |

```bash theme={null}
curl -s "https://api.worldmonitor.app/api/economic/v1/get-capital-flows?country=DE&counterpart=JP" \
  -H "X-WorldMonitor-Key: $WM_KEY"
```

**MCP。** `get_capital_flows` 最多返回 10 个国家的完整视图;加上 `counterpart` 后,每个国家增加一对数据。不指定国家时,对具备所选 `sort` 指标的经济体排名(默认 `outflow_z` 不含仅有年度数据、没有 z 分数的序列):最新的流出或流入 z 分数、流量占 GDP 的比例、净流量、境外存款的四季度变化,或外国证券持有的变化。参见 [MCP 工具参考](/docs/zh/mcp-tools-reference#get_capital_flows)。

## 新鲜度

数据集每周由宏观数据批次重建。`/api/health` 在 10 天未重建,或最新 IMF 国际收支季度已超过 12 个月(即上游数据停止更新)时将其标记为过期。响应在 `latest` 中给出每个来源的最新期别。

## 局限

* **人口迁移不是流量。** 居民身份变更记为重新分类,不记为流量(见页首说明)。
* **未发布的银行体系是盲区。** `not_published` 分项表示该方向在公开数据中不可见。
* **头寸混合了价格与资金。** 只有银行分项是经估值调整的流量。
* **阶段是推导值。** 它是一个有实测命中率的统计筛选,而非官方分类。
* **直接对手方。** 直接投资和证券投资数字标明的是第一个对手方,而非最终所有者。

## 来源

* IMF,*国际收支与国际投资头寸统计*、*按对手经济体划分的证券投资头寸*、*按对手经济体划分的直接投资头寸*,经 IMF SDMX 3.0 API 获取。
* 国际清算银行,*本地银行统计*,经 BIS SDMX API 获取。
* 世界银行,*世界发展指标*,现价美元 GDP。
* Forbes, K. J. and Warnock, F. E. (2012), "Capital flow waves: Surges, stops, flight, and retrenchment", *Journal of International Economics* 88(2), 235–251.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.