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 項操作。
- 發布頻率遵循官方來源，不會人為提高頻率。
- 貨物貿易不包括服務貿易；篩選後的夥伴國和產品總額可能仍然不可用。
- 經濟數據可能被發布機構延遲、校正或修訂。
- 公開測試版不提供服務級別保證，也不是金融、投資、法律或稅務建議。