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

## 目的

库存消费比是谷物平衡表的标准缓冲指标：一个销售年度的消费量中有多少已存放在仓库中。比率下降是某种商品余量耗尽的最早的广泛公布信号。

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

## 数据源

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