消費者物価指数（CPI）API
1つの国と月について、総合消費者物価指数を取得します。
economics_get_cpi REST と次の経路で利用できます： economics_get_cpi MCPツール。どちらも同じデータ形式を返し、同じ月間クォータを消費します。
エンドポイントとリクエスト
REST エンドポイント
GET /v1/economics/{country}/cpiリクエストの例
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
--header "Authorization: Bearer $NARWHAL_API_KEY"MCPはツールを使用します economics_get_cpi 以下の対応する引数を使用します。
パラメータ
この操作で受け付ける期間形式： YYYY-MM.
| 名前 | 必須 | 種別 | 意味 |
|---|---|---|---|
country | はい | パス · ISO alpha-3 | サポート対象の大文字国コードを1つ：AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA。 |
period | いいえ | クエリ · YYYY-MM | 最新の受け入れ済み完全リリースの場合は省略し、特定の期間を1つ指定することもできます。 |
レスポンス
レスポンスの例
{
"country": "USA",
"period": "2026-07",
"value": "333.918",
"base_period": "1982-84",
"base_value": "100",
"released_on": "2026-08-12"
}| フィールド | 種別 | 必須 | 意味 |
|---|---|---|---|
country | 文字列 | はい | 指定された大文字 ISO alpha-3 国コード。 |
period | 文字列 | はい | 返される公式観測期間。 |
value | 正の10進数文字列 | はい | 総合指数水準。 |
base_period | 文字列 | はい | 公式指数の基準期間。 |
base_value | 正の10進数文字列 | はい | 公式指数の基準値。 |
released_on | 日付 | はい | Narwhal の取得時刻ではなく、公式公開日。 |
エラーとクォータ
400 invalid_query— 国、期間、フィルター形式が無効です。401 invalid_api_key— Bearer キーがないか拒否されました。404 series_not_found— リクエストに一致する承認済み観測値がありません。429 rate_limit_exceeded— ネットワークまたはアカウントの短時間上限に達しました。再試行時刻：Retry-After.429 quota_exhausted— アカウントが月間枠に達しました。503 economics_unavailable— Narwhal は受け入れ済み公開データを安全に提供できません。
クォータを消費するのは成功したデータレスポンスだけです。次を参照： すべてのエラー、ヘッダー、再試行規則.
鮮度
省略 period Narwhal が保存した最新の受け入れ済みリリースを返します。API 呼び出しは Narwhal のデータベースを読み取り、公式発行元をリアルタイムで呼び出しません。
released_on 公式公開日です。
現在の公開ベータ版カバレッジ
総合国民 CPI は AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USA で公開されています。
インドネシア、地域別ルート、コモディティは公開されていません。FXは別の FX API.
戻る： すべての Economics 操作.