国内総生産（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",
  "annualized": true,
  "released_on": "2026-07-30"
}

エンドポイント

GET国内総生産/v1/economics/{country}/gdp

country: 対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。
period: 受け入れ済みの完全な公表データのうち最新のものを取得するには省略します。特定の期間を1つ指定することもできます。
version_id: 省略可能な変更不可の公開版です。`dataset.published`または`dataset.revised`イベントの`resource_version`を指定できます。省略すると、現在採用されている指標を取得します。

MCP · economics_get_gdp

APIリファレンス →

GET国内総生産の履歴/v1/economics/{country}/gdp/observations

country: 対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。
start: 最初の観測期間。この期間を含みます。FreeとBasicでは、開始期間がプランの対象期間より前の場合、対象内の最初の期間に変更されます。その場合、レスポンスにはstartが含まれます。
end: 最後の観測期間（その期間を含む）。
limit: 返す期間数の上限。デフォルトは 100 です。1ページの期間数がこれより少ない場合もあるため、next_cursor をたどってください。
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"

レスポンスの例説明用レスポンス · 実際のリクエストによるものではありません

{
  "country": "USA",
  "currency": "USD",
  "annualized": true,
  "as_of": "2026-08-12T00:00:00Z",
  "observations": [
    {
      "period": "2026-Q2",
      "value": "31000100000000"
    }
  ],
  "next_cursor": null
}