现货金属 API 参考

提供黄金、白银、铂金和钯金的现货价格，以及 WTI、布伦特原油和铜的参考价格，附带单位和 UTC 时间戳。

身份验证和请求

在 Authorization 请求头中以 Bearer 方式发送你的 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 连接 →