Narwhal API
简体中文
所有 API

经济数据 API

一个来源，提供官方统计机构发布的 CPI、通胀、劳动力、GDP 和贸易数据。

首次请求

快速入门 →

获取一个国家某个月份的总体居民消费价格指数。

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
响应示例 示例响应 · 并非实时请求
{
  "country": "USA",
  "period": "2026-07",
  "value": "333.918",
  "base_period": "1982-84",
  "base_value": "100",
  "released_on": "2026-08-12"
}

端点

GET消费者价格指数/v1/economics/{country}/cpi

获取一个国家某个月份的总体居民消费价格指数。

country
支持的一个大写国家代码：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此参数可获取最新已接受的完整发布，或传入一个精确期间。

MCP · economics_get_cpi

API 参考 →历史 →
GET通胀/v1/economics/{country}/inflation

获取某一个月的同比、环比和年初至今通胀率。

country
支持的一个大写国家代码：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此参数可获取最新已接受的完整发布，或传入一个精确期间。

MCP · economics_get_inflation

API 参考 →历史 →
GET失业率/v1/economics/{country}/unemployment

获取 该 官方 失业率 汇率 用于 一个 观测值 期间.

country
支持的一个大写国家代码：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此参数可获取最新已接受的完整发布，或传入一个精确期间。

MCP · economics_get_unemployment

API 参考 →历史 →
GET劳动力参与率/v1/economics/{country}/labour-force-participation

获取 该 官方 劳动力参与率 汇率 用于 一个 观测值 期间.

country
支持的一个大写国家代码：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此参数可获取最新已接受的完整发布，或传入一个精确期间。

MCP · economics_get_labour_force_participation

API 参考 →历史 →
GET国内生产总值/v1/economics/{country}/gdp

获取一个季度的现价国家 GDP。

country
支持的一个大写国家代码：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此参数可获取最新已接受的完整发布，或传入一个精确期间。

MCP · economics_get_gdp

API 参考 →历史 →
GETGDP 增长率/v1/economics/{country}/gdp-growth

获取一个季度的官方实际 GDP 增长指标。

country
支持的一个大写国家代码：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此参数可获取最新已接受的完整发布，或传入一个精确期间。

MCP · economics_get_gdp_growth

API 参考 →历史 →
GET商品贸易/v1/economics/{country}/trade

获取一个期间的出口、进口和确切商品贸易余额。

country
支持的一个大写国家代码：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此参数可获取最新已接受的完整发布，或传入一个精确期间。

MCP · economics_get_trade

API 参考 →历史 →
GET商品出口/v1/economics/{country}/trade/exports

获取一个国家某个期间的商品出口总额。

country
支持的一个大写国家代码：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此参数可获取最新已接受的完整发布，或传入一个精确期间。
partner
根据合约已接受，但当前测试版不会发布筛选后的合作伙伴总数。
product
HS 商品代码。请将其与分类一并提供。
classification
《协调制度》的版本。请与product一同提供。

MCP · economics_get_trade_exports

API 参考 →历史 →
GET商品进口/v1/economics/{country}/trade/imports

获取一个国家某个期间的商品进口总额。

country
支持的一个大写国家代码：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此参数可获取最新已接受的完整发布，或传入一个精确期间。
partner
根据合约已接受，但当前测试版不会发布筛选后的合作伙伴总数。
product
HS 商品代码。请将其与分类一并提供。
classification
《协调制度》的版本。请与product一同提供。

MCP · economics_get_trade_imports

API 参考 →历史 →

来源与方法论

明确的期间

每个响应都包含观测期间和官方发布日期。

REST 和 MCP

REST 与 MCP 共享18个操作、架构和配额。

覆盖范围

查看覆盖范围 →

查看来自十个国家官方发布机构的当前和历史经济数据。

AUS CAN DEU FRA GBR JPN MYS NLD SGP USA

常见问题

支持哪些国家？

澳大利亚、加拿大、德国、法国、英国、日本、马来西亚、荷兰、新加坡和美国。

API 是否包含历史经济数据？

是。九个最新发布操作中的每一个，都有一个对应的observations路由，用于当前已接受的历史序列。

经济数据来自哪里？

每个已上线数据流都来自覆盖矩阵中列出的政府统计机构或其他官方国家发布机构。

新发布数据多久可以获取？

Narwhal 会在发布通过验证后发布。公开测试版不承诺固定的来源到发布延迟。

发起你的第一个请求

获取免费 API 密钥 →