最初の経済データリクエストを実行

キーをURLに入れない

Narwhal キーはシークレットまたは環境変数として保存します。Authorization ヘッダーで Bearer トークンとして送信してください。クエリ文字列に入れたり、リポジトリにコミットしたり、ブラウザコードに公開したりしないでください。

期間を省略すると、最新の受け入れ済み完全リリースを取得します。

リクエスト

curl --request GET \
  --url https://api.narwhalapi.com/v1/economics/USA/cpi \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

レスポンスは汎用 data ラッパーのない型付き JSON です。クライアントが精度を暗黙に失わないよう、10進値は文字列です。欠損値は欠損のままで、ゼロにはなりません。

レスポンスの例

{
  "country": "USA",
  "period": "2026-07",
  "value": "333.918",
  "base_period": "1982-84",
  "base_value": "100",
  "released_on": "2026-08-12"
}

別の稼働中の国について同じ指標をリクエストするには、USA を AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP のいずれかに置き換えます。cpi は、インフレ、失業率、労働力参加率、GDP、GDP 成長率、貿易、輸出、輸入のドキュメント化された別の操作パスに置き換えます。

400レスポンスはリクエストが無効であることを示します。401はAPIキーがないか無効であることを示します。404は指定されたルートまたは系列が利用できないことを示します。429はクォータを使い切ったことを示します。503はその時点で指定データまたはサービスを安全に提供できないことを示します。

エラーボディはapplication/problem+jsonを使用し、リクエストIDを含みます。500と503のレスポンスは上限付きバックオフで再試行してください。再試行する前に400と401を修正し、429を再試行する前に文書化されたリセットを待ってください。

MCP ツールは REST と同じキー、保存済み公開データ、レスポンススキーマ、データクォータを使用します。アプリに合うインターフェースを選んでください。基盤となる経済データは同じです。

公開済み 2026年8月27日。最終確認日 2026年8月28日.