所有 API

財經日曆 API

追蹤排定的經濟數據發布及其發布狀態。為 GDP、價格、勞動力、貿易和殖利率曲線建立發布行事曆,並避免將不確定的時程視為確切時間。

在線94.13% uptime, last 30天674 ms 一般回應

首次請求

列出某個月的發布

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"
}

端點

GET列出發布事件/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陣列

    已發布的數據。發布之前陣列為空。


完整參考文件 →
GET取得單次發布/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陣列

    已發布的數據。發布之前陣列為空。


完整參考文件 →

使用情境

下次 CPI 發布日期

查明下一次美國 CPI 何時發布,按 UTC 和紐約時間顯示。

閱讀指南 →

發布前提醒

透過日曆訂閱源或每日腳本,在發布前收到提醒。

閱讀指南 →

按你的時區顯示發布時間

把 UTC 發布時間換算成當地時間,並處理夏令時間。

閱讀指南 →

FOMC 會議與會議紀要

列出已排定的 FOMC 利率決議和會議紀要。

閱讀指南 →

涵蓋範圍

共114個國家。其中43個直接從發布機構讀取發布日程,其餘71個使用第三方日曆的日期,並標為參考日期。

顯示全部 114 個國家

來源

55個官方發布機構:統計局、部會與央行。發布機構自己的日期與數據始終優先於第三方日曆。

  • Instituto Nacional de Estadística y Censos (INDEC)阿根廷
  • Australian Bureau of Statistics (ABS)澳大利亞
  • Statistics Austria奧地利
  • Eurostat7個國家
  • Statbel比利時
  • National Bank of Belgium比利時
  • Banco Central do Brasil巴西
  • National Statistical Institute (NSI)保加利亞
  • Statistics Canada加拿大
  • Central Bank of Chile (BCCh)智利
  • National Statistics Institute of Chile (INE)智利
  • Croatian Bureau of Statistics (CBS)克羅埃西亞
顯示全部 55 個來源
  • Czech Statistical Office (ČSÚ)捷克
  • Statistics Denmark丹麥
  • Statistics Estonia愛沙尼亞
  • European Commission (DG ECFIN)歐元區
  • Statistics Finland芬蘭
  • Finnish Customs (Tulli)芬蘭
  • National Institute of Statistics and Economic Studies (INSEE)法國
  • French Customs法國
  • Federal Statistical Office of Germany (Destatis)德國
  • Hellenic Statistical Authority (ELSTAT)希臘
  • Hungarian Central Statistical Office (KSH)匈牙利
  • Statistics Iceland冰島
  • Ministry of Statistics and Programme Implementation (MoSPI)印度
  • Central Statistics Office (CSO)愛爾蘭
  • Italian National Institute of Statistics (Istat)義大利
  • Statistics Bureau of Japan日本
  • Cabinet Office of Japan日本
  • Japan Customs日本
  • Central Statistical Bureau of Latvia (CSB)拉脫維亞
  • State Data Agency of Lithuania立陶宛
  • STATEC盧森堡
  • Department of Statistics Malaysia (DOSM)馬來西亞
  • INEGI墨西哥
  • Statistics Netherlands (CBS)荷蘭
  • Stats NZ紐西蘭
  • Statistics Norway (SSB)挪威
  • Statistics Poland波蘭
  • Statistics Portugal (INE)葡萄牙
  • National Bank of Romania (BNR)羅馬尼亞
  • Federal State Statistics Service (Rosstat)俄羅斯
  • Bank of Russia俄羅斯
  • Singapore Department of Statistics (SingStat)新加坡
  • Singapore government open-data publications新加坡
  • Statistical Office of the Republic of Slovenia (SURS)斯洛維尼亞
  • National Statistics Institute of Spain (INE)西班牙
  • Spanish Tax Agency (AEAT)西班牙
  • Statistics Sweden (SCB)瑞典
  • Directorate-General of Budget, Accounting and Statistics (DGBAS)臺灣
  • Turkish Statistical Institute (TurkStat)土耳其
  • Office for National Statistics (ONS)英國
  • Bureau of Labor Statistics (BLS)美國
  • Bureau of Economic Analysis (BEA)美國
  • US Census Bureau美國

相關 API

國定假日 API

按國家列出的官方公共假日,區分全國與地區範圍。

探索 API →

經濟數據 API

關於價格、勞動、產出、貿易和利率的官方指標。

探索 API →

價格

預付額度,每1,000次呼叫2美元,沒有方案或級別。

查看價格 →

常見問題

每次發布都有確切時間嗎?

不是。發布機構可能僅指定日期、範圍或截止日期。回應透過最上層的 at、date、between 或 by 欄位保留該精確度。

可以取得較早版本嗎?

在取得發布事件詳細資訊的請求中,使用 version_id 參數選擇不可變更的版本。

有免費的經濟日曆 API 嗎?

有。每個 Narwhal 帳戶每月都有10美元免費額度,無需綁卡,也沒有期限。一次日曆請求算一次呼叫,每1,000次呼叫2美元,所以免費額度每月可呼叫5,000次。

日曆包含市場共識預測嗎?

有,前提是第三方日曆有該預測。每個值會在前值旁帶上市場共識,發布後再帶上實際值。市場共識是預測而不是已公布的數字,沒有已知預測時不會出現。沒有重要性評級。

發布時間使用哪個時區?

精確的發布時間(at 欄位)為 UTC。timezone 欄位給出發布機構自己的 IANA 時區,例如 Asia/Jakarta,便於顯示當地時間。只有日期的發布沒有時間。

日曆能回傳多少歷史資料?

一次請求最多涵蓋366天的區間。預設從今天前30天到今天後335天。更長的範圍請依區間逐段取得。內容有變化的發布會保留舊版本,用 version_id 讀取。

能以 ICS 訂閱源取得日曆嗎?

能。建立日曆訂閱後,Narwhal 會回傳一個私有的 .ics 連結,日曆應用程式可訂閱。它可包含發布、公共假日或兩者,涵蓋1至50個國家,區間最長366天。建立一次算一次呼叫。

AI 代理能透過 MCP 讀取日曆嗎?

能。Narwhal MCP 伺服器提供 economics_list_releases 與 economics_get_release,與 REST 端點的兩個操作相同。

速率限制是多少?

帳戶只有免費額度時每分鐘50次請求,持有付費額度後每分鐘500次。同一網路位址每分鐘限120次。429 回應帶有 Retry-After,且不收費。

使用資料之前應該檢查什麼?

預定發布並不保證在確切的預定時刻公布。請保留時間精確度和時區,並明確處理已取消的發布。預定發布時間與 Narwhal 觀測到該次發布的時間代表不同的事件。