所有 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
}

端点

GET获取现货价格或基于期货的参考价格。/v1/commodities/spot/{commodity}/{currency}
GET获取黄金、白银、铂金、钯金、WTI 和 BRENT 的开盘价、最高价、最低价和收盘价价格柱。铜的历史数据暂不可用。/v1/commodities/spot/{commodity}/{currency}/bars

数据说明

大宗商品代码

黄金使用 XAU,白银使用 XAG,铂金使用 XPT,钯金使用 XPD,WTI 原油使用 WTI,布伦特原油使用 BRENT,铜使用 XCU。

最新价格

同时读取价格、时间戳以及过时标志。

货币

黄金以 31 种货币报价;白银、铂金、钯金、WTI、BRENT 和 XCU 仅以 USD 报价。

请在应用中显示报价时间戳。过时的报价不得作为最新市场价格展示。休市期间,报价可能已过时;每日 21:00-22:00 UTC 暂停期间返回 stale: true。

探索相关页面

实物大宗商品价格 API

跟踪棕榈油、煤炭、美国燃油周度零售价格和商品月度基准。各序列均保留其市场、发布时的单位和观测期间。

探索 API →

常见问题

价格使用什么单位?

贵金属的 unit 字段为 troy_ounce,WTI 和 BRENT 为 barrel,XCU 为 pound。金衡盎司不同于普通盎司。

支持哪些货币?

黄金以 31 种货币报价;白银、铂金、钯金、WTI、BRENT 和 XCU 仅以 USD 报价。 覆盖列表列出每种大宗商品和货币。其他组合返回 404 currency_not_supported。

发起你的第一个请求

获取免费 API 密钥 →