一次ソース
稼働中のすべてのストリームは、国の公式発行元から取得します。
方法論を読む →すべての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",
"base_period": "1982-84",
"base_value": "100",
"released_on": "2026-08-12"
}エンドポイント
GET消費者物価指数/v1/economics/{country}/cpi
1つの国と月について、総合消費者物価指数を取得します。
country- サポート対象の大文字国コードを1つ：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA。
period- 最新の受け入れ済み完全リリースの場合は省略し、特定の期間を1つ指定することもできます。
MCP · economics_get_cpi
GETインフレ/v1/economics/{country}/inflation
1か月の前年同月比、前月比、年初来のインフレ率を取得します。
country- サポート対象の大文字国コードを1つ：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA。
period- 最新の受け入れ済み完全リリースの場合は省略し、特定の期間を1つ指定することもできます。
MCP · economics_get_inflation
GET失業率/v1/economics/{country}/unemployment
1つの観測期間について、公式の失業率を取得します。
country- サポート対象の大文字国コードを1つ：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA。
period- 最新の受け入れ済み完全リリースの場合は省略し、特定の期間を1つ指定することもできます。
MCP · economics_get_unemployment
GET労働力率/v1/economics/{country}/labour-force-participation
1つの観測期間について、公式の労働力参加率を取得します。
country- サポート対象の大文字国コードを1つ：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA。
period- 最新の受け入れ済み完全リリースの場合は省略し、特定の期間を1つ指定することもできます。
MCP · economics_get_labour_force_participation
GET国内総生産/v1/economics/{country}/gdp
1四半期の名目国別 GDP を取得します。
country- サポート対象の大文字国コードを1つ：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA。
period- 最新の受け入れ済み完全リリースの場合は省略し、特定の期間を1つ指定することもできます。
MCP · economics_get_gdp
GETGDP 成長率/v1/economics/{country}/gdp-growth
1四半期の公式実質 GDP 成長率指標を取得します。
country- サポート対象の大文字国コードを1つ：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA。
period- 最新の受け入れ済み完全リリースの場合は省略し、特定の期間を1つ指定することもできます。
MCP · economics_get_gdp_growth
GET商品貿易/v1/economics/{country}/trade
1期間の輸出、輸入、正確な財貿易収支を取得します。
country- サポート対象の大文字国コードを1つ：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA。
period- 最新の受け入れ済み完全リリースの場合は省略し、特定の期間を1つ指定することもできます。
MCP · economics_get_trade
GET商品輸出/v1/economics/{country}/trade/exports
1つの国と期間について、財輸出の合計を取得します。
country- サポート対象の大文字国コードを1つ：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA。
period- 最新の受け入れ済み完全リリースの場合は省略し、特定の期間を1つ指定することもできます。
partner- 契約上は受け入れられていますが、フィルター済みのパートナー合計は現在のベータ版では公開されていません。
product- HS商品コード。分類と併せて指定します。
classification- 統一システムの版。product と一緒に指定します。
MCP · economics_get_trade_exports
GET商品輸入/v1/economics/{country}/trade/imports
1つの国と期間について、財輸入の合計を取得します。
country- サポート対象の大文字国コードを1つ：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA。
period- 最新の受け入れ済み完全リリースの場合は省略し、特定の期間を1つ指定することもできます。
partner- 契約上は受け入れられていますが、フィルター済みのパートナー合計は現在のベータ版では公開されていません。
product- HS商品コード。分類と併せて指定します。
classification- 統一システムの版。product と一緒に指定します。
MCP · economics_get_trade_imports
ソースと方法論
明示的な期間
各レスポンスには観測期間と公式リリース日が含まれます。
REST と MCP
REST と MCP は18の操作、スキーマ、クォータを共有します。
カバレッジ
カバレッジを表示 →10か国の公式な国内発行元による現在および過去の経済データを確認できます。
AUS
CAN
DEU
FRA
GBR
JPN
MYS
NLD
SGP
USAよくある質問
どの国がサポートされていますか？
オーストラリア、カナダ、ドイツ、フランス、英国、日本、マレーシア、オランダ、シンガポール、米国。
APIには過去の経済データが含まれますか？
はい。9つの最新リリース操作それぞれに、現在受け入れられている履歴系列用の対応する観測ルートがあります。
経済データはどこから来ますか？
稼働中のすべてのストリームは、カバレッジマトリクスに記載された政府統計局またはその他の国の公式発行元から取得します。
新しいリリースはどのくらい早く利用できますか？
Narwhal はリリースが検証を通過した後に公開します。パブリックベータでは、ソースから公開までの固定遅延を約束しません。