GDP 增长率 API

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

economics_get_gdp_growth 可通过 REST 和 economics_get_gdp_growth MCP 工具访问。两者返回相同的数据结构，并共用月度配额。

端点与请求

REST 端点

GET /v1/economics/{country}/gdp-growth

请求示例

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/gdp-growth?period=2026-Q2" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCP 使用工具 economics_get_gdp_growth ，并传入下方对应的参数。

参数

此操作接受的期间格式是 YYYY-QN。

名称	必填	类型	含义
`country`	是	路径·ISO alpha-3	一个受支持的大写国家代码；请参阅此操作的覆盖列表。
`period`	否	查询·YYYY-QN	省略此参数可获取已采纳的最新完整发布数据，也可传入一个具体期间。

响应

响应示例

{
  "country": "USA",
  "period": "2026-Q2",
  "year_over_year": "2.4",
  "quarter_over_quarter": "0.503",
  "unit": "percent",
  "price_basis": "constant",
  "seasonal_adjustment": "seasonally_adjusted",
  "annualization": "not_annualized",
  "released_on": "2026-07-30"
}

字段	类型	必填	含义
`country`	字符串	是	所请求的大写 ISO 三字母国家代码。
`period`	字符串	是	返回的官方观测期间。
`year_over_year`	十进制字符串	是	与上一年同季度相比的实际 GDP 变化。
`quarter_over_quarter`	十进制字符串	是	实际 GDP 相对上一季度的变化。
`year_to_date`	十进制字符串	否	如果来源发布了年初至今的增长率，则提供该数据；否则省略。
`unit`	"percent"	是	增长指标所使用的单位。
`price_basis`	"constant"	是	确认增长率按实际 GDP 计算。
`seasonal_adjustment`	枚举	是	官方序列是否经过季节性调整。
`annualization`	枚举	是	发布的增长率是否年化。
`released_on`	日期	是	官方发布日期，而不是 Narwhal 的检索时间。

错误与配额

400 invalid_query — 国家、期间或筛选格式无效。
401 invalid_api_key — Bearer 密钥缺失或被拒绝。
404 series_not_found — 没有已批准的观测值符合请求。
429 rate_limit_exceeded — 已达到网络或账户的短时窗口限额；请按以下响应头指定的等待时间重试： Retry-After。
429 quota_exhausted — 账户已用完月度配额。
503 economics_unavailable — Narwhal 无法安全提供已接受的发布版本。

只有成功的数据响应才会消耗配额。参见所有错误、响应头和重试规则。

数据时效性

省略 period 返回 Narwhal 最新存储的已接受发布版本。API 调用读取 Narwhal 数据库，不会实时调用官方发布机构。

released_on 是官方发布日期。

读取源检查、验证、已存储发布版本和失败检查的工作方式。

当前公开测试覆盖范围

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

季度同比及环比增长率数据覆盖的国家见下方列表。可选字段 year_to_date 仅在官方来源发布相应数据时出现。

印度尼西亚和地区级经济数据路由不对外开放。日频外汇数据可通过以下 API 获取：外汇 API。

返回所有经济数据操作。