大宗商品代碼
黃金使用 XAU，白銀使用 XAG，鉑金使用 XPT，鈀金使用 XPD，WTI 原油使用 WTI，布蘭特原油使用 BRENT，銅使用 XCU。
所有 API
現貨金屬價格 API
取得黃金、白銀、鉑金和鈀金的現貨價格，以及基於期貨市場的 WTI、布蘭特原油和銅的參考價格。這些參考價格並非實體貨物的現貨價格。
首次請求
快速入門 →curl --request GET \
--url "https://api.narwhalapi.com/v1/commodities/spot/XAU/USD" \
--header "Authorization: Bearer $NARWHAL_API_KEY"回應範例 示意回應 · 非實際請求結果
{
"symbol": "XAU-USD",
"price": "2500.00",
"currency": "USD",
"unit": "troy_ounce",
"timestamp": "2026-08-21T12:00:00Z",
"stale": true
}端點
資料如何運作
最新價格
同時讀取價格、時間戳記，以及過時標記。
貨幣
黃金以 31 種貨幣報價；白銀、鉑金、鈀金、WTI、BRENT 和 XCU 僅以 USD 報價。
涵蓋範圍
查看涵蓋範圍 →請在應用程式中顯示報價時間戳記。過時報價不得當作最新市場價格呈現。市場休市時，報價可能處於過時狀態；每日 21:00-22:00 UTC 暫停期間回傳 stale: true。
探索相關頁面
常見問題
價格使用什麼單位？
貴金屬的 unit 欄位為 troy_ounce，WTI 和 BRENT 為 barrel，XCU 為 pound。金衡盎司不同於普通盎司。
支援哪些貨幣？
黃金以 31 種貨幣報價；白銀、鉑金、鈀金、WTI、BRENT 和 XCU 僅以 USD 報價。 涵蓋範圍清單列出每種大宗商品和貨幣。其他組合回傳 404 currency_not_supported。