すべてのAPI

経済データAPI

公式統計機関による CPI、インフレ、労働、GDP、貿易データを1つのソースで提供します。

最初のリクエスト

1つの国と月について、総合消費者物価指数を取得します。

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",
  "index_base": "1982-84=100",
  "released_on": "2026-08-12"
}

GET消費者物価指数/v1/economics/{country}/cpi

1つの国と月について、総合消費者物価指数を取得します。

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

MCP · economics_get_cpi

GETインフレ率/v1/economics/{country}/inflation

1か月の前年同月比、前月比、年初来のインフレ率を取得します。

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

MCP · economics_get_inflation

GET失業率/v1/economics/{country}/unemployment

1つの観測期間について、公式の失業率を取得します。

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

MCP · economics_get_unemployment

GET労働力率/v1/economics/{country}/labour-force-participation

1つの観測期間について、公式の労働力率を取得します。

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

MCP · economics_get_labour_force_participation

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

1四半期の国全体の GDP を取得します。常に当期価格です。

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

MCP · economics_get_gdp

GETGDP 成長率/v1/economics/{country}/gdp-growth

1四半期の公式実質 GDP 成長率を取得します。固定価格で測定し、パーセントで表します。

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

MCP · economics_get_gdp_growth

GET財貿易/v1/economics/{country}/trade

1期間の輸出額、輸入額、正確な財貿易収支を取得します。サービスは含みません。

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

MCP · economics_get_trade