尋找下一次 CPI 發布日期

使用 API

使用 GET /v1/economics/calendar，請求指定國家和日期範圍的發布時間表。請求沒有主題篩選參數，因此 Python 程式碼會從行事曆回應中選取消費者物價發布資料。省略國家參數時，消費者物價篩選結果可能包含多個國家的發布資料，因此需要美國時間表時，請保留 countries=USA。

1. 取得金鑰 取得免費 API 金鑰，並存放在名為 NARWHAL_API_KEY 的環境變數中。請求會傳送至 https://api.narwhalapi.com，並在 Authorization: Bearer YOUR_KEY 標頭中帶上金鑰；指令碼會從環境中讀取該金鑰。
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. 繼續讀取其餘分頁 每頁最多包含 100 個發布項目，指令碼會讀取回應頁面中的發布項目。如果回應包含 next_cursor，請使用它讀取其餘分頁，再從所有行事曆結果中選出最早的相符發布項目；行事曆端點詳見經濟數據發布 API 文件。

請求的逾時時間為 10 秒。指令碼會先執行 raise_for_status()，再讀取 JSON 的 releases 陣列，因此 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。

請用 period 識別 CPI 數據的月份，並用 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 減去五小時，就會得到同一天的 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 發布。