現貨金屬 API 參考

提供黃金、白銀、鉑金和鈀金的現貨價格，以及 WTI、布蘭特原油和銅的參考價格，附帶單位和 UTC 時間戳記。

身分驗證與請求

請以 Bearer 驗證方式，在 Authorization 標頭中傳送你的 API 金鑰。產品概覽 →

curl "https://api.narwhalapi.com/v1/commodities/spot/XAU/USD" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

操作

端點	操作
`GET /v1/commodities/spot/{commodity}/{currency}`	取得現貨價格或基於期貨的參考價格。
`GET /v1/commodities/spot/{commodity}/{currency}/bars`	取得黃金、白銀、鉑金、鈀金、WTI 和 BRENT 的開盤價、最高價、最低價和收盤價價格柱。銅的歷史資料暫不可用。

參數

欄位	含義
`commodity`	路徑參數。XAU、XAG、XPT、XPD、WTI（WTI 原油）、BRENT（布蘭特原油）或 XCU（銅）。
`currency`	路徑參數，使用大寫。黃金：USD, AUD, BGN, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TRY 或 ZAR。白銀、鉑金、鈀金、WTI、BRENT 和 XCU：僅支援 USD。
`interval`	僅適用於價格柱。1m、5m、15m、1h、4h或1d（預設值）。
`start / end`	僅適用於價格柱。對齊完整間隔邊界的UTC時刻（4h為00、04、08時，依此類推；1d為午夜）。包含起始時刻，不包含結束時刻。
`limit / cursor`	僅適用於價格柱。預設100，最多500。使用相同查詢重複使用next_cursor。

報價欄位

欄位	含義
`symbol, currency, unit`	代碼和報價貨幣。貴金屬的 unit 為 troy_ounce，WTI 和 BRENT 為 barrel，XCU 為 pound。
`price`	一個正數參考價格，以十進位字串表示。
`timestamp, stale`	報價的 UTC 時間戳記與明確的資料時效旗標。
`bars`	僅適用於價格柱。已收盤價格柱依時間由早到晚排列，每個價格柱包含timestamp（價格柱起始時刻），以及用四位小數字串表示的open、high、low和close。以USD以外貨幣計價的黃金僅提供close。
`next_cursor`	僅適用於價格柱。用於繼續查詢的游標；沒有更多價格柱時為null。

範例回應： GET /v1/commodities/spot/{commodity}/{currency}。

報價回應

{
  "symbol": "XAU-USD",
  "price": "2500.00",
  "currency": "USD",
  "unit": "troy_ounce",
  "timestamp": "2026-08-21T12:00:00Z",
  "stale": true
}

解讀資料

WTI、BRENT 和 XCU 是基於期貨市場的參考價格，並非實體貨物的現貨價格。顯示價格時，請一併顯示單位與時間戳記。時間戳記為價格所屬分鐘的開始時間；每日 21:00-22:00 UTC 暫停期間回傳 stale: true。市場休市時，報價可能已過期；請勿將其呈現為最新市場價格。其他大宗商品或貨幣組合會回傳 404。提供黃金、白銀、鉑金、鈀金、WTI 和 BRENT 的價格歷史，暫不提供 XCU 的價格歷史。我們從不填補空缺，缺失的價格柱維持缺失。分鐘級價格柱保留30天，小時級和日級價格柱無限期保留，可用歷史範圍受方案限制。 WTI 和 BRENT 的 15 分鐘級和小時級歷史從 2020 年開始。

錯誤格式與配額 →

MCP 工具

commodities_get_spot_pricecommodities_get_price_history

透過 MCP 連線 →