Narwhal 如何验证官方经济数据
每个公开Economics API响应背后的来源、验证、存储和修订规则。
Narwhal将国家统计发布转换为可预测的统一契约。它保留来源期间、单位、发布日期和解释字段，不会把不同指标压扁成含义不明的数字。
官方 来源 仅
每个已上线数据流都始于政府统计机构或其他官方国家发布机构。Narwhal 不会把商业估算混入官方 CPI、劳动力、GDP 或商品贸易序列。
当前发布机构包括 ABS、加拿大统计局、Destatis、INSEE、ONS、日本国家统计机构、DOSM、荷兰 CBS、SingStat、BLS、BEA 和美国人口普查局。 覆盖范围矩阵 显示适用于每个国家的发布机构和发布频率。
发布版本作为完整发布通过验证
计划中的源检查会获取候选发布版本，并验证其身份、期间、必需字段、单位和完整性。观测值及其来源证据会一并存储。只有通过必需检查的完整发布版本才会提供给客户请求。
如果候选发布不完整或未通过验证，Narwhal会保留最近一次已接受发布供使用。它绝不会把缺失值替换为零，也不会把失败发布的一部分与旧发布混合。
一份不抹去含义的契约
最新和历史国家操作共享稳定的 REST 路径和 MCP 工具，但指标专属上下文仍明确保留。CPI 保留基期和基期数值；GDP 保留价格基础、季节调整和年化信息；贸易保留货币和商品覆盖范围。
十进制值以字符串形式返回，以免客户端静默丢失精度。缺失值仍保持缺失。 Economics API 参考 说明每项操作的字段和可接受期间格式。
数据时效性与修订
客户请求读取 Narwhal 已存储的已接受数据；它们不会等待政府网站。 period 标识观测值，而 released_on 记录官方发布日期。
官方机构可以修订早期数值。修订后的发布通过相同检查后，可以替换该期间之前存储的数值。Narwhal目前不公开摄取时间戳，也不承诺公开测试版期间从来源发布到API发布的固定延迟。请查看精确的 新鲜度契约.
当前限制
- 覆盖范围仅限于公开覆盖范围页面列出的十个国家和 18 项操作。
- 发布频率遵循官方来源，不会人为提高频率。
- 货物贸易不包括服务贸易；筛选后的伙伴国和产品总额可能仍然不可用。
- 经济数据可能被发布机构延迟、校正或修订。
- 公开测试版不提供服务级别保证，也不是金融、投资、法律或税务建议。