所有 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
一个受支持的大写国家代码；请参阅此操作的覆盖列表。
period
省略此参数可获取已采纳的最新完整发布数据，也可传入一个具体期间。

MCP · economics_get_cpi

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

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

country
一个受支持的大写国家代码；请参阅此操作的覆盖列表。
period
省略此参数可获取已采纳的最新完整发布数据，也可传入一个具体期间。

MCP · economics_get_inflation

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

获取一个观测期的官方失业率。

country
一个受支持的大写国家代码；请参阅此操作的覆盖列表。
period
省略此参数可获取已采纳的最新完整发布数据，也可传入一个具体期间。

MCP · economics_get_unemployment

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

获取一个观测期的官方劳动力参与率。

country
一个受支持的大写国家代码；请参阅此操作的覆盖列表。
period
省略此参数可获取已采纳的最新完整发布数据，也可传入一个具体期间。

MCP · economics_get_labour_force_participation

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

获取某个季度以现价计量的全国 GDP。

country
一个受支持的大写国家代码；请参阅此操作的覆盖列表。
period
省略此参数可获取已采纳的最新完整发布数据，也可传入一个具体期间。

MCP · economics_get_gdp

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

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

country
一个受支持的大写国家代码；请参阅此操作的覆盖列表。
period
省略此参数可获取已采纳的最新完整发布数据，也可传入一个具体期间。

MCP · economics_get_gdp_growth

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

获取某个期间的出口额、进口额以及准确的货物贸易差额。

country
一个受支持的大写国家代码；请参阅此操作的覆盖列表。
period
省略此参数可获取已采纳的最新完整发布数据，也可传入一个具体期间。

MCP · economics_get_trade

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

获取一个国家某个期间的货物出口总额。

country
一个受支持的大写国家代码；请参阅此操作的覆盖列表。
period
省略此参数可获取已采纳的最新完整发布数据，也可传入一个具体期间。
partner
接口约定允许使用此参数，但当前测试版尚未发布按贸易伙伴筛选的总额。
product
HS 商品代码。请与 classification 一并提供。
classification
Harmonized System 的版本。请与 product 一并提供。

MCP · economics_get_trade_exports

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

获取一个国家某个期间的货物进口总额。

country
一个受支持的大写国家代码；请参阅此操作的覆盖列表。
period
省略此参数可获取已采纳的最新完整发布数据，也可传入一个具体期间。
partner
接口约定允许使用此参数，但当前测试版尚未发布按贸易伙伴筛选的总额。
product
HS 商品代码。请与 classification 一并提供。
classification
Harmonized System 的版本。请与 product 一并提供。

MCP · economics_get_trade_imports

API 参考 →历史 →

来源与方法论

明确的观测期

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

REST 和 MCP

REST 和 MCP 在所有可用操作中共享数据结构和配额。

覆盖范围

查看覆盖范围 →

探索各国官方发布机构提供的当前及历史经济数据。覆盖范围因操作和国家而异。

指标

物价

CPI (英语)通胀 (英语)

劳动力

失业率 (英语)劳动力参与率 (英语)

产出

GDP (英语)GDP 增长率 (英语)

贸易

贸易差额 (英语)出口 (英语)进口 (英语)

利率

收益率曲线 (英语)

国家

澳大利亚 (英语)奥地利 (英语)比利时 (英语)加拿大 (英语)智利 (英语)哥伦比亚 (英语)捷克 (英语)德国 (英语)丹麦 (英语)西班牙 (英语)爱沙尼亚 (英语)芬兰 (英语)法国 (英语)英国 (英语)克罗地亚 (英语)爱尔兰 (英语)意大利 (英语)日本 (英语)立陶宛 (英语)卢森堡 (英语)拉脱维亚 (英语)墨西哥 (英语)马来西亚 (英语)荷兰 (英语)挪威 (英语)新西兰 (英语)巴基斯坦 (英语)菲律宾 (英语)波兰 (英语)葡萄牙 (英语)卡塔尔 (英语)沙特阿拉伯 (英语)新加坡 (英语)斯洛文尼亚 (英语)瑞典 (英语)美国 (英语)

探索相关页面

英国和美国收益率曲线 API

英国采用英格兰银行名义零息收益率，美国采用美国财政部名义平价收益率。可通过 REST 和 MCP 获取单个来源日期或分页历史数据。

探索 API → (英语)

常见问题

支持哪些国家？

请查看覆盖范围表，了解已发布数据所涵盖的国家。可用指标和历史数据涵盖的期间因国家而异。

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

有。九个获取最新发布数据的操作均有对应的 observations 路由，用于查询当前已采纳的历史序列。

经济数据来自哪里？

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

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

Narwhal 会在数据通过验证后发布。公开测试版不承诺从来源机构发布到 Narwhal 公布之间的固定延迟。

发起你的第一个请求

获取免费 API 密钥 →