从这里开始
库存消费比回答的是”粮仓问题”。 如果一个国家一整年不再获得任何新粮食，它能靠已经存在仓里的东西撑过这一年的多少？ 库存消费比为0.20，意味着约相当于一年消费量的 20%——大约两个半月的量——已经存放在仓库中。它是谷物平衡表的标准缓冲指标，而比率下降是某种商品余量耗尽的最早的广泛公布信号。
如何解读
WorldMonitor 不公布任何”安全线”，因为多少算宽裕，会因商品、因国家、也因当时还有谁愿意出售而不同。请把这个比率当作方向，以及与该国该商品自身近期历史的对比来读，而不是去对照一条普世的红线。 真正具有普遍性的是机制：缓冲吸收冲击，而薄的缓冲传导冲击。远在任何东西真正短缺之前，价格就会先变得敏感。 有两个习惯比数字本身更重要： 看清是比率的哪一侧在动。 每一行都会把期末库存、产量与总消费量与派生出的比率一并给出，因为”因消费上升而下降的比率”和”因歉收而下降的比率”是完全不同的故事。仅凭比率无法区分二者。 永远不要把各国的行加总成世界总量。 请改用countryCode=WORLD。也不要因为两国的年度标签相同就拿来比较——参见销售年度不是日历年度，这是本数据集最常见的误读方式。
访问方式。 由
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 发布的全球平衡表——不是在此基于国家行计算的合计。
比率
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 新鲜度键。