下次 CPI 發布日期
查明下一次美國 CPI 何時發布,按 UTC 和紐約時間顯示。
閱讀指南 →追蹤排定的經濟數據發布及其發布狀態。為 GDP、價格、勞動力、貿易和殖利率曲線建立發布行事曆,並避免將不確定的時程視為確切時間。
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-10-01&end_date=2026-10-31" \
--header "Authorization: Bearer $NARWHAL_API_KEY"{
"releases": [
{
"release_id": "00000000-0000-4000-8000-000000000201",
"revision": 0,
"country": "USA",
"series_id": "usa-consumer-prices",
"name": "Consumer prices",
"topic": "consumer_prices",
"family": "prices",
"period": "2026-09",
"status": "scheduled",
"at": "2026-10-14T12:30:00Z",
"timezone": "America/New_York",
"values": []
}
],
"next_cursor": null
}curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-12-09&end_date=2026-12-09" \
--header "Authorization: Bearer $NARWHAL_API_KEY"{
"releases": [
{
"release_id": "52e78613-4f51-4cc8-b8dd-a4c3cc798c50",
"revision": 1,
"country": "USA",
"series_id": "usa-monetary-policy-press-conference",
"name": "Monetary policy press conference",
"topic": "policy_communication",
"family": "policy_rate",
"status": "scheduled",
"at": "2026-12-09T19:30:00Z",
"timezone": "America/New_York",
"values": []
},
{
"release_id": "ed7bb0f9-6b9b-4e27-9b43-d891742ec3d4",
"revision": 1,
"country": "USA",
"series_id": "usa-policy-rate-decision",
"name": "Policy rate decision",
"topic": "policy_rate",
"family": "policy_rate",
"status": "scheduled",
"at": "2026-12-09T19:00:00Z",
"timezone": "America/New_York",
"values": []
}
],
"next_cursor": null
}curl --request POST \
--url "https://api.narwhalapi.com/v1/calendars/subscriptions" \
--header "Authorization: Bearer $NARWHAL_API_KEY" \
--header "Content-Type: application/json" \
--data '{"countries":["USA"],"start_date":"2026-09-01","end_date":"2026-12-31","include_releases":true,"include_holidays":true}'{
"subscription_id": "00000000-0000-4000-8000-000000000301",
"url": "https://api.narwhalapi.com/v1/calendars/subscriptions/EXAMPLE_TOKEN.ics",
"expires_at": "2027-10-22T09:00:00Z"
}/v1/economics/calendar列出日期範圍內的發布事件。
countries選填ISO alpha-3 代碼,如 USA。多個國家可重複該參數,最多 50 個。
start_date選填時間窗口的第一天。預設從今天前 30 天開始。
end_date選填時間窗口的最後一天。預設到今天後 335 天結束。窗口最長 366 天。
limit選填每頁的公布項目數,1 至 100。預設為 100。
cursor選填使用 next_cursor 和相同的篩選條件繼續。
release_id字串要查看詳情的發布。
name字串Narwhal 的標準英文名稱,如 Producer prices。不含日期。
topic字串該序列衡量的內容,在每個國家都相同,如 consumer_prices 或 gdp。
period字串該發布所涵蓋的期間,如 2026-09 或 2026-Q3。
status字串發布所處的狀態,如 scheduled。
at / date / between / by字串發布機構給出的時間:確切時間、某一天、一段日期範圍或截止日期。日期未知時為 None。
values陣列已發布的數據。發布之前陣列為空。
/v1/economics/calendar/{release_id}讀取發布事件,可選擇指定 version_id。
release_id必填該發布的 UUID。
version_id選填較早版本的 UUID。省略則回傳目前版本。
version字串不可變的版本,可作為 version_id 傳回。
name字串Narwhal 的標準英文名稱,如 Producer prices。不含日期。
topic字串該序列衡量的內容,在每個國家都相同,如 consumer_prices 或 gdp。
period字串該發布所涵蓋的期間,如 2026-09 或 2026-Q3。
status字串發布所處的狀態,如 scheduled。
at / date / between / by字串發布機構給出的時間:確切時間、某一天、一段日期範圍或截止日期。日期未知時為 None。
values陣列已發布的數據。發布之前陣列為空。
共114個國家。其中43個直接從發布機構讀取發布日程,其餘71個使用第三方日曆的日期,並標為參考日期。
55個官方發布機構:統計局、部會與央行。發布機構自己的日期與數據始終優先於第三方日曆。
不是。發布機構可能僅指定日期、範圍或截止日期。回應透過最上層的 at、date、between 或 by 欄位保留該精確度。
在取得發布事件詳細資訊的請求中,使用 version_id 參數選擇不可變更的版本。
有。每個 Narwhal 帳戶每月都有10美元免費額度,無需綁卡,也沒有期限。一次日曆請求算一次呼叫,每1,000次呼叫2美元,所以免費額度每月可呼叫5,000次。
有,前提是第三方日曆有該預測。每個值會在前值旁帶上市場共識,發布後再帶上實際值。市場共識是預測而不是已公布的數字,沒有已知預測時不會出現。沒有重要性評級。
精確的發布時間(at 欄位)為 UTC。timezone 欄位給出發布機構自己的 IANA 時區,例如 Asia/Jakarta,便於顯示當地時間。只有日期的發布沒有時間。
一次請求最多涵蓋366天的區間。預設從今天前30天到今天後335天。更長的範圍請依區間逐段取得。內容有變化的發布會保留舊版本,用 version_id 讀取。
能。建立日曆訂閱後,Narwhal 會回傳一個私有的 .ics 連結,日曆應用程式可訂閱。它可包含發布、公共假日或兩者,涵蓋1至50個國家,區間最長366天。建立一次算一次呼叫。
能。Narwhal MCP 伺服器提供 economics_list_releases 與 economics_get_release,與 REST 端點的兩個操作相同。
帳戶只有免費額度時每分鐘50次請求,持有付費額度後每分鐘500次。同一網路位址每分鐘限120次。429 回應帶有 Retry-After,且不收費。
預定發布並不保證在確切的預定時刻公布。請保留時間精確度和時區,並明確處理已取消的發布。預定發布時間與 Narwhal 觀測到該次發布的時間代表不同的事件。
每月 10 美元免費額度,無需綁卡。每月 10 美元免費額度,無需綁卡。