文件
變更日誌
Narwhal API 的產品與文件更新。
追蹤公開網站、文件和 API 可用性的變更。
經濟資料頁面
- 新增各國家及其指標的頁面，提供歷史圖表、CSV下載和嵌入內容。
- 新增各指標的跨國檢視、依國家和月份查看的財經日曆，以及殖利率曲線。
- 英文版國家涵蓋範圍頁面現已重新導向至各國的資料頁面。
事件與Webhook
- 新增GET /v1/events和/v1/events/stream WebSocket，支援重播游標。
- 新增Webhook目的地，支援附有簽章且至少一次的傳送、傳送歷史和重播。
- 為predictions事件類別新增prediction.event.closed和prediction.event.settled。
FX現已涵蓋144種貨幣
- 匯率、歷史資料和貨幣換算新增113種貨幣。
- 原有31種貨幣的請求維持不變。
金屬與FX價格歷史
- 為黃金、白銀、鉑金和鈀金新增GET /v1/commodities/spot/{commodity}/{currency}/bars和commodities_get_price_history。
- 新增GET /v1/fx/rates/{base}/bars和fx_get_rate_bars，用於查詢單一貨幣相對USD的資料。
- 價格柱間隔為1m、5m、15m、1h、4h和1d。分鐘級價格柱涵蓋最近30天；小時級和日級價格柱無限期保留，可用歷史範圍受方案限制。
商品月度基準與價格歷史
- 現有實物價格序列端點新增月度基準，支援探索序列、取得詳情、最新價格與觀測值。REST 與 MCP 使用相同的序列 ID。
- 涵蓋軟性商品、油脂與油籽、金屬、穀物、能源、肥料、林產品以及畜牧與乳製品。所有價格均以 USD 計價，並保留發布時的單位與數量。
- 最新可用月份為2026年9月。部分序列起始較晚或已結束。各序列會回報自己的涵蓋日期。
- 新增商品歷史價格 API 頁面、銅價格回應範例與完整的月度基準涵蓋清單。
美國汽油與柴油零售價格
- 在 /v1/commodities/physical/series 下新增四個 REST 與 MCP 操作，用於探索序列、取得序列詳情、最新價格與觀測值。
- 新增20個普通汽油與2號公路用柴油的週度序列。每種產品均涵蓋全美平均值與九個地區，價格以 USD/美制加侖計。
- 歷史包含2026年7月20日至10月5日的12週資料，每週一調查後更新。回應保留日期、以十進位字串表示的價格、可為 null 的發布日期、修訂資訊與來源署名。
WTI、布蘭特原油和銅的參考價格
- GET /v1/commodities/spot/{commodity}/{currency} 和 commodities_get_spot_price 新增 WTI 和 BRENT（USD/桶）以及 XCU（USD/磅）。
- 這些是基於期貨市場的參考價格，並非實體貨物的現貨價格。回應欄位和 stale 旗標維持不變。
- 可透過 GET /v1/commodities/spot/{commodity}/USD/bars 和 commodities_get_price_history 取得 WTI 和 BRENT 的價格歷史，間隔和規則與金屬相同。銅僅支援最新價格。
已新增鉑金和鈀金現貨價格
- 已透過 REST 和 MCP 新增以 USD 計價的 XPT 和 XPD 現貨價格。
- 黃金和白銀保持不變：黃金以 31 種貨幣報價，白銀以 USD 報價。
現貨價格已移除 bid 和 ask 欄位
- 已從現貨價格回應中移除 bid 和 ask。保留欄位：symbol、price、currency、unit、timestamp、stale。
- 期貨端點維持不變，繼續保留 bid 和 ask 欄位。
經濟數據發布指標支援更多值類型
- 已為每個指標新增 annualization 欄位，一律設為 annualized 或 not_annualized。
- 已在 index、percent 和 thousands 之外新增 currency、ratio 和 balance 單位，並僅為貨幣金額提供 currency（ISO 4217 代碼）和 scale（units、thousands、millions、hundred_millions、billions）欄位。
- 已在 level、month_over_month 和 year_over_year 之外新增 quarter_over_quarter、three_month_on_three_month 和 change 轉換方式。
- 允許 reference_period 和數值期間在既有的月份（YYYY-MM）和季度（YYYY-Qn）之外，使用週結束日期（YYYY-MM-DD）和滾動三個月視窗（YYYY-MM/YYYY-MM）。
- 已說明這些欄位未來可能出現新的列舉值，用戶端應接受未知值，避免剖析失敗。
歷史外匯觀測資料現已上線
- 新增 GET /v1/fx/rates/{base}/observations 和 fx_get_rate_history。
- 新增包含起訖日期的日期範圍、每頁日期數有上限的分頁，以及與篩選條件綁定的不透明游標，以便回填完整歷史資料。
- 保留真實觀測日期，不會沿用先前的值來填補週末、假日或缺失的貨幣匯率。
荷蘭已在經濟數據 API 中上線
- 在全部九項公開的經濟數據 REST 操作及對應的 MCP 工具中新增 NLD。
- 發布 Statistics Netherlands (CBS) 提供的每月 CPI、勞動力與商品貿易資料，以及每季 GDP 資料。
- 新增荷蘭涵蓋範圍、來源方法說明、API 文件和機器探索功能。
歷史經濟數據與荷蘭涵蓋範圍
- 透過 REST 和 MCP 新增九項支援分頁的歷史觀測值操作。
- 新增 CBS 提供的荷蘭官方通膨、勞動力、GDP 和商品貿易資料。
- 公開的經濟數據 API 已擴展至十個國家和 18 項操作。
公開經濟數據測試版
- 已透過 REST 和 MCP 開放九項國家經濟數據操作。
- 已上線 AUS、CAN、DEU、FRA、GBR、JPN、MYS、SGP 和 USA 的當前官方資料。
- 發布經濟數據快速入門指南與機器可讀的探索資訊。