所有 API

國內生產總值(GDP) API

官方來源的本幣計價季度 GDP。

首次請求

快速入門
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
支援的一個大寫國家代碼:AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
period
省略此參數可獲取最新已接受的完整發布,或傳入一個精確期間。

MCP · economics_get_gdp

API 參考
GET國內生產總值歷史数据/v1/economics/{country}/gdp/observations
country
支援的一個大寫國家代碼:AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA。
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"
}

來源與方法論

明確的期間

省略此參數可獲取最新已接受的完整發布,或傳入一個精確期間。

REST 和 MCP

使用一個 API 金鑰,透過 REST 或 MCP 取得最新及歷史資料。

常見問題

回應包含哪些內容?

獲取一個季度的現價國家 GDP。

可以請求哪些期間?

YYYY-QN

支援哪些資料範圍?

AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP 和 USA 的季度現價國家 GDP 為公開數據。

發起你的第一個請求

獲取免費 API 密鑰