国内生产总值（GDP） API

首次请求

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

响应示例示例响应 · 非实际请求结果

{
  "country": "USA",
  "period": "2026-Q2",
  "value": "31000100000000",
  "currency": "USD",
  "price_basis": "current",
  "seasonal_adjustment": "seasonally_adjusted",
  "annualization": "annualized",
  "released_on": "2026-07-30"
}

端点

GET国内生产总值/v1/economics/{country}/gdp

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

MCP · economics_get_gdp

API 参考 →

GET国内生产总值历史数据/v1/economics/{country}/gdp/observations

country: 一个受支持的大写国家代码；请参阅此操作的覆盖列表。
start: 起始观测期（包含该期）。
end: 结束观测期（包含该期）。
limit: 最多返回的观测值数量。默认为 100。
cursor: 上一页返回的next_cursor。

MCP · economics_get_gdp_history

API 参考 →

历史

cURL

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/gdp/observations?start=2026-Q2&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

响应示例示例响应 · 非实际请求结果

{
  "observations": [
    {
      "country": "USA",
      "measure": "gdp",
      "value": "31000100000000",
      "unit": "USD",
      "transformation": "",
      "period": "2026-Q2"
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T16:00:00Z"
}