文档
Narwhal 如何验证官方经济数据
每个公开的经济数据 API 响应背后的来源、验证、存储和修订规则。
Narwhal 将各国统计发布数据整合为统一、行为可预期的接口规范。它保留来源的期间、单位、发布日期和解释字段，避免将不同指标简化为含义不明的数值。
仅使用官方来源
每个已上线数据流都始于政府统计机构或其他官方国家发布机构。Narwhal 不会把商业估算混入官方 CPI、劳动力、GDP 或货物贸易序列。
当前来源机构包括 ABS、Statistics Canada、Destatis、INSEE、ONS、日本国家统计机构、DOSM、CBS Netherlands、SingStat、BLS、BEA、US Census Bureau、Statistics Estonia、Ireland's Central Statistics Office、Latvia's Central Statistical Bureau、Slovenia's Statistical Office、Croatian Bureau of Statistics、Czech Statistical Office、State Data Agency of Lithuania 以及 Statistics Portugal (INE)。以下 覆盖范围矩阵 列出每个已公开提供数据的国家所对应的发布机构和发布频率。
葡萄牙的 INE 来源记录 所依据的发布许可为 CC BY 4.0 许可；Narwhal 标注 INE 为来源，并在 API 接口规范中标识标准化值和派生值。
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数据不构成金融、投资、法律或税务建议。