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