> ## Documentation Index
> Fetch the complete documentation index at: https://worldmonitor-spike-bun-package-manager.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 粮食库存与库存消费比

> WorldMonitor 如何按商品与国家提供 USDA PSD 谷物期末库存、产量、消费量与库存消费比，以及为何销售年度不可跨国比较。

## 从这里开始

**库存消费比回答的是"粮仓问题"。** 如果一个国家一整年不再获得任何新粮食，它能靠已经存在仓里的东西撑过这一年的多少？

库存消费比为 `0.20`，意味着约相当于一年消费量的 20%——大约两个半月的量——已经存放在仓库中。它是谷物平衡表的标准缓冲指标，而比率下降是某种商品余量耗尽的最早的广泛公布信号。

### 如何解读

WorldMonitor 不公布任何"安全线"，因为多少算宽裕，会因商品、因国家、也因当时还有谁愿意出售而不同。请把这个比率当作**方向，以及与该国该商品自身近期历史的对比**来读，而不是去对照一条普世的红线。

真正具有普遍性的是机制：缓冲吸收冲击，而薄的缓冲传导冲击。远在任何东西真正短缺之前，价格就会先变得敏感。

有两个习惯比数字本身更重要：

**看清是比率的哪一侧在动。** 每一行都会把期末库存、产量与总消费量与派生出的比率一并给出，因为"因消费上升而下降的比率"和"因歉收而下降的比率"是完全不同的故事。仅凭比率无法区分二者。

**永远不要把各国的行加总成世界总量。** 请改用 `countryCode=WORLD`。也不要因为两国的年度标签相同就拿来比较——参见[销售年度不是日历年度](#销售年度不是日历年度)，这是本数据集最常见的误读方式。

<Info>
  **访问方式。** 由 `GET /api/resilience/v1/get-food-stocks?countryCode=<ISO2|WORLD>` 与 MCP `get_food_stocks` 提供。两者均需 Pro 订阅。
</Info>

## 数据源

USDA 生产、供应与分配数据库（PSD）是平衡表与库存的数据源。公有领域，月度发布周期，按商品与国家提供全球覆盖。

FAOSTAT 在 PSD 之后作为仅产量的缺口填补，覆盖 PSD 未覆盖的商品-国家组合。这些行的 `source` 为 `"faostat"`；其上的库存字段均为占位符，不是 USDA/PSD 实测值，也不携带库存消费比。

## 商品

`wheat`、`corn`、`rice`、`soybeans`、`barley`、`palmOil`。传入 `commodity` 以缩小范围；省略则返回该国报告的所有商品。

`countryCode=WORLD` 返回 PSD 发布的全球平衡表——不是在此基于国家行计算的合计。

## 比率

```text theme={null}
库存消费比 = 期末库存 / 总消费量
```

每一行同时提供 `endingStocksTmt`、`productionTmt`、`totalUseTmt` 与派生的 `stocksToUse`，因此调用方可以看出比率的哪一侧发生了变化。因消费量上升而下降的比率，与因产量歉收而下降的比率是不同的情形，而仅凭比率无法区分二者。

## 销售年度不是日历年度

这是要紧的陷阱，也是每一行都注明自身 `marketingYear` 的原因。

销售年度自收获起算，因此因商品和国家而异。标注为"2025/26"的巴西大豆与美国玉米覆盖不同月份。标注同一年度的南北半球小麦几乎不重叠。

由此产生的后果：

* **切勿因年份标签相同就比较两国数据。** 标签不是时期。
* **切勿通过累加国家行构建全球总量。** 请使用 `countryCode=WORLD`。
* **一国的年度可能已推进而其邻国尚未。** 那是日历使然，不是陈旧数据。

## 可用性

数据行使用明确的存在性标志，而不是只靠数值字段。`hasEndingStocks` 与 `hasStocksToUse` 表示 `endingStocksTmt` 与 `stocksToUse` 是否为测量值。FAOSTAT 的仅产量填补行可以携带 `endingStocksTmt`、`totalUseTmt` 与 `stocksToUse` 的占位零值，同时这些库存标志为 false。某国未报告的商品在响应中缺席。零库存与无覆盖是相反的解读，调用方不能由一方推断另一方。

## 更新频率

月度，跟随 PSD 发布。种子程序写入 `resilience:food-stocks:v1` 及配套的 `seed-meta:resilience:food-stocks` 新鲜度键。

## 相关

* [Pro 情报套件](/zh/pro-intelligence-suite)
* [五因子记分卡](/zh/methodology/five-factor-scorecard)——将库存消费比作为其粮食支柱
* [数据源](/zh/data-sources)