文件
Narwhal 如何驗證官方經濟數據
每個公開的經濟數據 API 回應背後的來源、驗證、儲存與修訂規則。
Narwhal 將國家統計發布資料轉換為一致、可預期的介面規格，保留來源期間、單位、發布日期和解讀所需欄位，避免將性質不同的指標簡化成含義不明的數字。
僅採用官方來源
每個已上線資料流都始於政府統計機構或其他官方國家發布機構。Narwhal 不會把商業估算混入官方 CPI、勞動力、GDP 或商品貿易序列。
目前發布機構包括 ABS、Statistics Canada、Destatis、INSEE、ONS、日本國家統計機構、DOSM、CBS Netherlands、SingStat、BLS、BEA、US Census Bureau、Statistics Estonia、愛爾蘭的 Central Statistics Office、拉脫維亞的 Central Statistical Bureau、斯洛維尼亞的 Statistical Office、Croatian Bureau of Statistics、Czech Statistical Office、State Data Agency of Lithuania，以及 Statistics Portugal (INE)。 涵蓋範圍矩陣 顯示各個已公開資料的國家所對應的發布機構與發布頻率。
葡萄牙的 INE 來源記錄 發布時所依據的授權為 CC BY 4.0 授權；Narwhal 在 API 介面規格中標示來源為 INE，並註明標準化與衍生的數值。
Narwhal 將這些機構的資料標準化後，輸出內容仍須遵守已公布的條件：
- 愛沙尼亞統計局 Statistics Estonia 的來源條款和 CC BY-SA 4.0 授權要求標示 Statistics Estonia、提供授權連結，並以相同授權分享改作內容。 Statistics Estonia 的來源條款CC BY-SA 4.0 授權
- 愛爾蘭 CSO 愛爾蘭 CSO 著作權政策和 CC BY 4.0 授權允許在標示來源的情況下再利用。 愛爾蘭 CSO 著作權政策CC BY 4.0 授權
- 拉脫維亞 CSB 拉脫維亞 CSB 發布政策允許在標示來源的情況下進行商業與非商業再利用。 拉脫維亞 CSB 發布政策
- 斯洛維尼亞 SURS SURS 再利用政策允許在標示來源並清楚識別變更的情況下，進行商業重製、散布、修改及納入產品。 SURS 再利用政策
- 克羅埃西亞統計局（CBS） CBS Croatia 的開放授權要求署名、提供授權連結及標記變更。 CBS 克羅埃西亞開放授權
- 捷克 ČSÚ ČSÚ 的再利用條款規範捷克資料的再利用。 ČSÚ 再利用條款
- 立陶宛國家資料局 立陶宛發布政策要求標示原始提供者。 立陶宛發布政策
Narwhal 在 API 介面規格中註明標準化處理與衍生的比率。
挪威統計局（SSB） 的表 09190、14710/14700、13760 和 08792 依 CC BY 4.0 再利用；請保留來源、表、授權和更新資訊，註明 Narwhal 的標準化處理及衍生變更，且不得暗示 SSB 為其背書。
芬蘭統計局（StatFin） 的表 132h、15b5/122p 和 135y 依 CC BY 4.0 再利用；請保留芬蘭統計局署名、資料集、授權和更新資訊，並註明 Narwhal 的標準化處理。
芬蘭海關 的 Uljas 資料立方體 ULJAS_KAUPPATASE（最終）和 ULJAS_ENNAKKO（初步）依 CC BY 4.0 再利用；請保留芬蘭海關、資料立方體和更新資訊的來源標示，保留最終或初步狀態，並註明 Narwhal 的篩選和標準化處理。
瑞典統計局（SCB） 的表 TAB3102/TAB3100、TAB6596、TAB6387 和 TAB5391 依 CC0 再利用；請註明資料集和 Narwhal 的獨立處理，不得將輸出呈現為 SCB 官方出版物，也不得暗示官方合作。
丹麥統計局 的 StatBank 表 PRIS01、AKU111K、SITC2R4M 和 SITC2R4 依 CC BY 4.0 再利用；請保留丹麥統計局和表的來源標示，並註明 Narwhal 的標準化處理。
歐盟統計局（Eurostat） 的再利用條款適用於丹麥的 namq_10_gdp 以及盧森堡的 namq_10_gdp、une_rt_q、lfsq_argan 和 ext_st_27_2020msbec 所選資料；請保留 Eurostat、資料集和存取日期的來源標示，註明 Narwhal 的變更，並聲明 Eurostat 不對這些變更負責。
STATEC 的全國 CPI 資料集 DSD_ECOICOP_PRIX@DF_E5405 依 CC0 再利用；請保留 STATEC 標示和連結所指的資料集紀錄。
加拿大統計局 的資料依 Open Government Licence - Canada 再利用；請保留來源標示和第三方聲明，註明 Narwhal 的標準化處理及衍生變更，且不得暗示加拿大統計局為其背書。
荷蘭統計局（CBS） 的 StatLine 表 86141ENG、80590ENG、85879ENG、85880ENG 和 85427ENG 依 CC BY 4.0 再利用；請保留 CBS 署名，註明 Narwhal 的變更，排除另有限制的第三方材料，且不得暗示 CBS 為其背書。
英國國家統計局（ONS） 的資料依 Open Government Licence v3.0 再利用；請保留 ONS 和授權標示以及第三方聲明，註明 Narwhal 的標準化處理及衍生變更，且不得暗示 ONS 為其背書。
澳大利亞統計局（ABS） 的資料依 CC BY 4.0 再利用；請保留 ABS 署名，註明 Narwhal 的標準化處理及衍生變更，排除未經授權的第三方材料，且不得暗示 ABS 為其背書。
日本統計儀表板 / e-Stat 的資料依 Government of Japan Standard Terms of Use 2.0 / CC BY 4.0 相容條款再利用；請保留來源標示和個別註明的第三方權利。
INSEE 的資料依 Open Licence 2.0 再利用；請保留來源及最近更新資訊的標示和第三方聲明，註明 Narwhal 的標準化處理及衍生變更，且不得暗示 INSEE 為其背書。
法國海關（DGDDI/DSECE） 的資料依連結所指的再利用聲明再利用；請保留準確的來源和參考日期，並維護資料完整性。
Destatis 的資料依 Data licence Germany - attribution - Version 2.0 再利用；請保留來源、授權和更新背景資訊。
西班牙國家統計局（INE） 的表 76125、67821、67822、65081 和 65219 依 CC BY 4.0 再利用；請保留來源和更新資訊的標示，註明 Narwhal 的變更，且不得暗示 INE 為其背書。
西班牙稅務局（AEAT） 的商品貿易總額資料依據連結所指的再利用條件，採用 2024 年起的新方法；請保留來源、日期和中繼資料，註明 Narwhal 的變更，不得扭曲資料或暗示 AEAT 為其背書。
菲律賓統計局（PSA） 的 OpenSTAT 表 0012M4ACP22.px、0021B3FKEI2.px、0012L4DFTS0.px、0012B5BEXQ1.px、0022B5BEXQ2.px 和 022B5BEXS2.px 依 CC BY 資料集條款再利用；請保留 PSA 署名、條款連結和技術說明，註明 Narwhal 的變更，且不得暗示 PSA 為其背書。
Narwhal 依據連結中的條款，再利用以下發布機構的發布日曆條目（日期、時間、標題和參考期間）。
美國聯邦準備制度理事會 的發布日曆條目屬於公眾領域，再利用時註明美國聯邦準備制度理事會為來源。Narwhal 不使用標誌或印章，也不暗示獲得理事會的認可。
美國勞工部就業與培訓署 的發布日曆條目屬於公眾領域，再利用時註明美國勞工部（DOL）為來源，且不暗示獲得其認可。
美國能源資訊署 的發布日曆條目屬於公眾領域，再利用時標示來源「Source: U.S. Energy Information Administration」。每個發布條目的 observed_at 表示 Narwhal 讀取 EIA 日程的日期，並以此日期填入「Source: U.S. Energy Information Administration (<date>)」格式的來源聲明。
財政服務局 的《每月財政報告》發布日曆條目（發布日期、時間、標題和參考期間）由 FiscalData 提供，可用於商業用途，並由 Narwhal 再利用。Narwhal 註明美國財政部財政服務局為來源，並對條目進行標準化處理，且不暗示獲得該局或美國財政部的認可。
歐盟統計局（Eurostat） 的歐元區發布日曆條目在再利用時標示「Source: Eurostat」。Narwhal 對條目進行標準化處理，且不暗示獲得 Eurostat 的認可。
歐盟執委會經濟與金融事務總署（DG ECFIN） 的企業和消費者調查發布日曆條目在再利用時標示「© European Union」，並遵循 CC BY 4.0 授權。Narwhal 透過標準化條目對內容進行了修改。
日本財務省 的發布日曆條目依據 Public Data License 1.0 再利用，並註明日本財務省為來源。Narwhal 對內容進行了編輯，且不將編輯後的版本呈現為日本政府編寫的內容。
e-Stat（日本官方統計入口網站） 的發布日曆條目在再利用時標示「Source: Portal Site of Official Statistics of Japan website (https://www.e-stat.go.jp/)」。Narwhal 對內容進行了編輯，且不將編輯後的版本呈現為日本政府編寫的內容。
日本內閣府經濟社會綜合研究所（ESRI） 的發布日曆條目依據 日本政府標準使用條款2.0 再利用，並標示「Created by Narwhal based on the GDP release schedule (Economic and Social Research Institute, Cabinet Office) (https://www.esri.cao.go.jp/en/sna/kouhyou/kouhyou_top.html)」。Narwhal 對條目進行了編輯（標準化），且不將編輯後的版本呈現為日本政府編寫的內容。
日本海關（日本財務省） 的發布日曆條目依據 公共數據許可 1.0 再利用，並標示「Created by Narwhal based on the Calendar of Release Dates (Japan Customs, Ministry of Finance) (https://www.customs.go.jp/toukei/calendar/calend_e.htm)」。Narwhal 對條目進行了編輯（標準化），且不將編輯後的版本呈現為日本政府編寫的內容。
日本財務省，按產業劃分的法人企業財務報表統計 的發布日曆條目依據 公共數據許可 1.0 再利用，並標示「Created by Narwhal based on the Financial Statements Statistics of Corporations by Industry release schedule (Ministry of Finance, Japan) (https://www.mof.go.jp/pri/reference/ssc/results/release_info.htm)」。Narwhal 對條目進行了編輯（標準化），且不將編輯後的版本呈現為日本政府編寫的內容。
日本統計局（總務省） 的月度摘要提供日本消費者物價指數、東京地區消費者物價指數（初步）、勞動力調查和家庭收支調查（家庭支出）發布日曆條目中顯示的實際值和前值，Narwhal 按發布原樣讀取這些值，並依據 公共數據許可 1.0 再利用，並標示「Created by Narwhal based on the Consumer Price Index, Tokyo area Consumer Price Index (preliminary), Labour Force Survey, and Family Income and Expenditure Survey (household spending) monthly summaries (Statistics Bureau of Japan) (https://www.stat.go.jp/english/)」。Narwhal 對內容進行了編輯（標準化），且不將編輯後的版本呈現為日本政府編寫的內容。
日本厚生勞動省（MHLW） 的新聞稿提供每月勞動統計調查發布日曆條目中顯示的實際值（現金薪資總額和實質薪資的年增率），Narwhal 按發布原樣讀取這些值，並依據 公共數據許可 1.0 再利用，並標示「Created by Narwhal based on the Monthly Labour Survey (Ministry of Health, Labour and Welfare) (https://www.mhlw.go.jp/toukei/itiran/roudou/monthly/)」。Narwhal 對內容進行了編輯（標準化），且不將編輯後的版本呈現為日本政府編寫的內容。
日本內閣府經濟社會綜合研究所（ESRI） 的機械訂單統計提供機械訂單發布日曆條目中顯示的實際值和前值（核心機械訂單，即不含船舶和電力的民間部門訂單的月增率和年增率），Narwhal 按發布原樣讀取這些值，並依據 日本政府標準使用條款2.0 再利用，並標示「Created by Narwhal based on the Machinery Orders statistics (Economic and Social Research Institute, Cabinet Office) (https://www.esri.cao.go.jp/jp/stat/juchu/menu_juchu.html)」。Narwhal 對內容進行了編輯（標準化），且不將編輯後的版本呈現為日本政府編寫的內容。
加拿大抵押貸款與住房公司 的發布日曆條目在再利用時附有聲明「Source: Canada Mortgage and Housing Corporation (CMHC), housing data release schedule, reference period as shown on each release.」。接收者依據 CMHC 的授權條款使用這些條目。
澳洲儲備銀行 的發布日曆條目在再利用時標示來源「Source: Reserve Bank of Australia 2026」，並遵循 CC BY 4.0 授權。Narwhal 透過標準化條目對內容進行了修改。此使用不暗示獲得 RBA 的認可。
Banco Central do Brasil 的發布日曆條目在再利用時註明 Banco Central do Brasil（BCB）為來源。資訊保持完整，日期、時間和標題均與發布時一致。
Banco de México 的發布日曆條目在再利用時註明 Banco de México 為來源，並列出其網址 https://www.banxico.org.mx/。
土耳其統計局（TurkStat） 的發布日曆條目在再利用時註明 TurkStat 為來源。
印度統計與計畫執行部（MoSPI） 的發布日曆條目在再利用時註明 MoSPI 為來源。
發布版本須以完整內容通過驗證
排程中的來源檢查會取得候選發布版本，並驗證其識別資訊、期間、必要欄位、單位和完整性。觀測值及其來源證據會一併儲存。只有通過必要檢查的完整發布版本，才會提供給客戶的請求使用。
如果候選發布版本不完整或未通過驗證，Narwhal 會繼續提供最近一次已接受的發布版本。它絕不會將缺失值替換為零，也不會將未通過驗證的發布內容與舊版本混合。
統一介面規格，保留資料含義
各國的最新與歷史資料操作都有穩定的 REST 路徑與 MCP 工具，並明確保留各指標的特定背景資訊。CPI 保留基期與基期值；愛爾蘭 CPI 使用 2023 年 12 月基期，拉脫維亞來源的 WorkAndSes 調整旗標則原樣保留，不套用未經驗證的 Narwhal 調整。GDP 保留價格基礎、季節調整與年化方式。貿易資料保留貨幣與商品涵蓋範圍；愛爾蘭來源中以千歐元表示的數值，會在介面規格中換算為歐元。
十進位數值以字串形式回傳，以免用戶端在不知情的情況下損失精度。缺失值仍保持缺失。 經濟數據 API 參考 說明每項操作的欄位和可接受期間格式。
資料時效性與修訂
客戶請求會讀取 Narwhal 已儲存且已接受的資料，無須等待政府網站。 period 用來識別觀測值，而 released_on 記錄官方發布日期。
官方機構可能修訂先前的數值。修訂後的發布版本通過相同檢查後，可以替換該期間先前儲存的數值。Narwhal 目前不公開資料匯入時間戳記，也不承諾公開測試期間從來源發布到 API 發布之間有固定延遲。請查看詳細的 時效介面規格。
當前限制
- 公開的涵蓋範圍頁面列出國家與指標的涵蓋範圍。可用期間依來源而異。
- 發布頻率遵循官方來源，不會人為提高頻率。
- 商品貿易不包括服務貿易；篩選後的夥伴國和產品總額可能仍然不可用。
- 經濟數據可能被發布機構延遲、校正或修訂。
- Basic 和 Pro 方案包含 99.5% 可用性 SLA，詳見服務條款。Narwhal 資料不構成金融、投資、法律或稅務建議。