次のCPI公表日を検索

APIで計算する

GET /v1/economics/calendarで、国と日付範囲を指定して公表スケジュールを取得します。リクエストにはトピックのフィルターがないため、Pythonコードでカレンダーのレスポンスから消費者物価のリリースを選択します。国のパラメーターを省略すると、消費者物価の選択結果に複数の国のリリースが含まれる場合があるため、米国のスケジュールが必要な場合はcountries=USAを指定してください。

1. キーを取得 無料のAPIキーを取得し、NARWHAL_API_KEYという環境変数に保存します。リクエストはAuthorization: Bearer YOUR_KEYヘッダーにキーを含めてhttps://api.narwhalapi.comに送信し、スクリプトはそのキーを環境変数から読み取ります。
2. 国と日付の範囲を選択 米国のカレンダーではcountriesをUSAに設定し、start_dateとend_dateで取得する範囲を指定します。スクリプトは実行日を開始日とし、120日後を終了日に使用します。複数の国を指定する場合はcountries=USA&countries=GBRのようにパラメーターを繰り返し、すべての国のリリースを取得する場合はcountriesを省略します。
3. 公表予定の消費者物価リリースを選択 カレンダーを取得し、topicがconsumer_prices、statusがscheduledで、atに値があるリリースを残します。スクリプトは一致したリリースの中からatが最も早いものを選び、対象期間、UTCの公表時刻、公表元のタイムゾーンを出力します。
   Python、次の米国消費者物価リリース

   import os
   from datetime import date, timedelta
   import requests
   
   r = requests.get(
       "https://api.narwhalapi.com/v1/economics/calendar",
       params={"countries": "USA", "start_date": date.today().isoformat(),
               "end_date": (date.today() + timedelta(days=120)).isoformat(), "limit": 100},
       headers={"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"}, timeout=10)
   r.raise_for_status()
   cpi = [x for x in r.json()["releases"]
          if x.get("topic") == "consumer_prices" and x["status"] == "scheduled" and "at" in x]
   nxt = min(cpi, key=lambda x: x["at"])
   print(nxt["period"], nxt["at"], nxt["timezone"])

4. リリースのフィールドを確認 各リリースにはrelease_id、country、name、topicがあり、periodは数値の対象月を、statusは公表予定の状態を示します。米国の消費者物価ではseries_idはusa-consumer-pricesで、値がある場合はatがUTCの時刻を、timezoneが公表元のIANAタイムゾーンであるAmerica/New_Yorkを示します。
5. 残りのページを取得 1ページは最大100件のリリースで、スクリプトはレスポンスの1ページ内のリリースを読み取ります。レスポンスにnext_cursorが含まれる場合は、それを使って残りのページを取得してから、カレンダーの結果全体で条件に一致する最も早いリリースを選択してください。カレンダーエンドポイントについては、経済リリースAPIドキュメントを参照してください。

リクエストのタイムアウトは10秒です。スクリプトはJSONのreleases配列を読み取る前にraise_for_status()を実行するため、HTTPエラーがあると消費者物価の選択前に処理が停止します。選択処理はレスポンス内の配列からリリースのフィールドを読み取ります。

コードを使わずに日付を検索

経済データページを開き、国別のインフレ率ページで次回の消費者物価の公表予定を確認します。各国のインフレ率ページには次の公表日があり、経済カレンダーページには国別の公表予定が一覧表示されます。

モデルやダッシュボードにカレンダーのリクエストを組み込まずに日付を確認する場合は、国別ページが便利です。国でスケジュールを絞り込み、公表日と対象月を併せて確認して、数値の対象月と公表予定日を区別してください。

スマートフォンで通知を受け取るには、カレンダーの購読を使用します。フィードでGoogle Calendar、Outlook、Apple Calendarに公表予定を追加できます。手順は経済リリースの通知を受け取る方法を参照してください。

状況に応じた方法の選び方

CPIの公表日は確定していますか？

リリースは公表されるまでstatus: scheduledの状態で、atの時刻は変更される場合があります。公表予定時刻を使用するモデル、ダッシュボード、通知でその日付を使う前に、カレンダーを再取得してください。

BasicとProのWebhookには、スケジュール変更を通知するrelease.rescheduledイベントがあります。予定時刻が必要な場合はカレンダーのatフィールドでUTCの公表時刻を確認し、timezoneで公表元のIANAタイムゾーンを確認します。

対象月が公表月より前なのはなぜですか？

periodは数値の対象月なので、2026年11月10日に公表予定のリリースは2026年10月分です。公表日は11月ですが、periodは2026-10です。

CPIの数値の対象月を特定するにはperiodを、公表予定時刻を特定するにはatを使用します。これらのフィールドを分けて確認すると、公表日をモデルやダッシュボードに取り込む際も、数値と対象月の対応を維持できます。

リリースに時刻がない場合はどうしますか？

リリースにdateしかない場合は、時点ではなく日付として扱います。カレンダーのリリースには時刻のない日付や期間で示されるものもあるため、すべての項目に正確なUTCリリース時刻があるわけではありません。

Pythonの抽出処理ではatが必要なため、これらの項目は抽出結果から除外されます。日付のみ、または期間で示されるリリースが必要な場合は、正確な時刻を持つ項目とは別に読み取ってください。日付だけでは、別のタイムゾーンに変換する時点を特定できません。

計算例：2026年10月の米国CPI

2026年10月の米国CPIリリースでは、まずperiod: 2026-10を確認します。予定されたatの値は2026-11-10T13:30:00Zで、公表元のタイムゾーンはAmerica/New_Yorkです。

UTCの値は2026年11月10日（火）の13:30と読みます。11月のニューヨークはEST（UTC-5）なので、13:30から5時間を引くと同日の08:30になります。

2026年10月の参照期間については、期間、予定されたUTCタイムスタンプ、公表元のタイムゾーンの順に出力されます：

2026-10 2026-11-10T13:30:00Z America/New_York

2026年11月の参照期間のリリースは、2026年12月10日の13:30 UTCに予定されています。2026年12月の参照期間のリリースは、2027年1月13日の13:30 UTCに予定されています。