文档
API 参考网站
浏览全部文档

经济数据 API 参考

最新发布和历史观测，覆盖范围按国家和指标列出。

九条路由返回最近一次接受的官方发布数据。九个对应的 /observations 路由返回当前已接受的时间序列。REST 和 MCP 使用相同的数据结构，并共用月度配额。

基础 URL 和参数

REST 基础路径
https://api.narwhalapi.com/v1/economics/{country}
  • country 是受支持的大写 ISO alpha-3 代码。
  • period 为可选项。对于最新发布版本请省略；否则传入该操作要求的月、季度或年份格式。
  • /v1/economics/{country}/cpi 等核心经济数据端点及其 MCP 工具可能返回主要指标首次发布的暂定估计值，响应不会注明其为暂定值；来源发布最终数值后，Narwhal API 会替换这些值。
  • 每个请求都必须携带文档所述的 Bearer 请求头： 身份验证。
请求一个已知期间
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

国家

36 国家

AUS, AUT, BEL, CAN, CHL, COL, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, HRV, IRL, ITA, JPN, LTU, LUX, LVA, MEX, MYS, NLD, NOR, NZL, PAK, PHL, POL, PRT, QAT, SAU, SGP, SVN, SWE, USA

覆盖范围因操作和国家而异。每个操作都会列出支持的国家。

最新发布版本

打开某个操作页面，查看确切参数、接受的期间格式、响应字段、示例、错误、数据时效性和当前限制。

操作REST 路径期间
消费者价格指数/v1/economics/{country}/cpiYYYY-MM
通胀/v1/economics/{country}/inflationYYYY-MM
失业率/v1/economics/{country}/unemploymentYYYY, YYYY-MM, or YYYY-QN
劳动力参与率/v1/economics/{country}/labour-force-participationYYYY, YYYY-MM, or YYYY-QN
国内生产总值/v1/economics/{country}/gdpYYYY-QN
GDP 增长率/v1/economics/{country}/gdp-growthYYYY-QN
货物贸易/v1/economics/{country}/tradeYYYY or YYYY-MM
货物出口/v1/economics/{country}/trade/exportsYYYY or YYYY-MM
货物进口/v1/economics/{country}/trade/importsYYYY or YYYY-MM

历史观测数据

历史路由接受 start, end, limit，以及 cursor。结果按时间从旧到新排列，表示当前已接受的数据序列，而不是过去每次发布的版本。

操作REST 路径期间
居民消费价格指数历史数据/v1/economics/{country}/cpi/observationsYYYY-MM
通胀历史数据/v1/economics/{country}/inflation/observationsYYYY-MM
失业率历史数据/v1/economics/{country}/unemployment/observationsYYYY, YYYY-MM, or YYYY-QN
劳动力参与率历史数据/v1/economics/{country}/labour-force-participation/observationsYYYY, YYYY-MM, or YYYY-QN
国内生产总值历史数据/v1/economics/{country}/gdp/observationsYYYY-QN
GDP 增长率历史数据/v1/economics/{country}/gdp-growth/observationsYYYY-QN
货物贸易历史数据/v1/economics/{country}/trade/observationsYYYY-MM
货物出口历史数据/v1/economics/{country}/trade/exports/observationsYYYY-MM
货物进口历史数据/v1/economics/{country}/trade/imports/observationsYYYY-MM

字段约定

字段或规则含义
country请求的ISO alpha-3国家代码。
period响应所代表的确切官方月份、季度或年份。
released_on官方发布日期，而不是 Narwhal 的检索时间。
十进制字符串经济数值使用字符串，以保留精确的十进制表示。
单位和基准在适用时，会明确给出比率、货币、价格基准、年化方式、覆盖范围和指数基准。
缺失的发布版本Narwhal 会以请求失败的方式处理缺失值，不会编造、前向填充或将其转换为零。

OpenAPI 与发现功能

当前公开测试限制

公共发现仅限于上面的国家路由。印度尼西亚和区域路由不属于公共经济学测试版。

查看 错误与配额 用于说明序列缺失和服务不可用时的行为。