XAU/USD 是什么意思：XAU、XAG、XPT 和 XPD 代码详解

XAU/USD 是什么意思？

XAU/USD 是 1 金衡盎司黄金以美元计的价格。一句话概括 XAU/USD 的含义就是：XAU 是黄金的代码，USD 是美元，货币对旁边的数字表示 1 盎司黄金值多少美元。如果图表显示 XAU/USD 为 3,997.89，那么 1 盎司黄金的价格就是 3,997.89 美元。这个数字是 MetalAPI 文档中通用的示例数值，并非实时价格。

这种写法源自外汇市场，在外汇市场中，每个价格都写成一对代码：

• 基准货币（base，即第一个代码）是被定价的对象，这里是 1 金衡盎司黄金。
• 报价货币（quote currency，即第二个代码）是价格的计价单位，这里是美元。
• 汇率是 1 单位基准货币值多少单位的报价货币。

EUR/USD 的道理相同：它是 1 欧元以美元计的价格。经纪商和交易平台常常省略斜杠，写作 XAUUSD，图表网站则把同一序列标为黄金现货（gold spot）。这些名称都指以美元/金衡盎司计的黄金现货价格，通常是批发市场买入价与卖出价报价的中间值。现货价、买入价、卖出价与价差介绍了这个中间价与交易商实际收取的价格之间的关系。

XAU、XAG、XPT 和 XPD 分别代表什么？

有四种贵金属在 ISO 4217（国际货币代码标准）中拥有自己的代码。每个代码代表 1 金衡盎司该金属，即 31.1034768 克：

规律是 X 加上该金属的化学符号。金和银的化学符号源自拉丁语，所以黄金是 XAU，而不是以 G（gold）开头的代码；白银是 XAG，而不是以 S（silver）开头的代码。

白银、铂金和钯金的读法与黄金完全相同。XAG/USD 是 1 金衡盎司白银以美元计的价格（文档示例中为 53.94），XPT/USD 是 1 盎司铂金的价格（1,612.35），XPD/USD 是 1 盎司钯金的价格（1,475.80）。

ISO 4217 没有为金属规定辅币单位。1 美元等于 100 美分，但并不存在官方的“百分之一盎司黄金”，因此金属的数量和价格可以按用途需要保留任意位数的小数。

为什么黄金有货币代码？

ISO 4217 代码由三个字母组成。对于国家货币，前两个字母是该国的 ISO 3166 代码，第三个字母通常取自货币名称：美元是 US 加 D，日元是 JP 加 Y。不属于任何单一国家的代码以 X 开头。除这四种金属外，这一组还包括国际货币基金组织的特别提款权（XDR）、西非法郎（XOF）和东加勒比元（XCD）等区域货币，以及两个技术代码：用于测试的 XTS 和用于不涉及货币的交易的 XXX。

黄金不是任何国家的货币，那为什么会出现在货币清单上？因为在批发市场中，贵金属的运作方式与货币十分相似。银行在金属账户中持有贵金属，在工作日全天候以美元报出现货价格，并以类似外汇的方式在账户之间结算交易。有了标准代码，支付、会计和交易系统就能像记录 1 欧元那样记录 1 盎司黄金。

对开发者来说，这带来一个实际的好处：任何需要三字母货币代码的字段、数据表或库都能直接容纳黄金。需要注意的是，以 XAU 计的金额是以金衡盎司计量的金属数量，而不是一笔钱。如果给它加上货币符号，或像美分那样取整到两位小数，很快就会出错：0.00025 XAU 按美分方式取整后会变成 0.00。

XAU/USD 与 USD/XAU：哪个方向才对？

每个货币对都可以写成两个方向，两者包含的信息相同。XAU/USD 是每盎司黄金的美元价格。USD/XAU 是每美元可买到的黄金盎司数，也就是 1 除以 XAU/USD 汇率。按文档中的示例价格：

市场惯例是把金属放在前面，这样报出的数字就是人们能直接读懂的价格。USD/XAU 很少出现在屏幕上，但在软件内部很常见：汇率表会列出 1 单位通用基础货币可以兑换多少各种货币。两个方向各有用途，错误往往出在把两者混为一谈。

最后两行表明，报价一方不一定是美元。XAU/EUR 以欧元为黄金计价（示例采用 1 欧元兑 1.1642 美元），XAU/XAG 则以白银盎司数为黄金计价，这就是金银比。金银比解释了这个数字的含义以及如何追踪它。

一个简单的合理性检查几乎能发现所有方向错误：以任何国家货币计，1 金衡盎司黄金的价格都远大于 1。因此，如果您准备显示为金价的数字是一个很小的小数，那么您看到的就是倒数汇率。

MetalAPI 如何返回 XAU 和 USDXAU

MetalAPI 使用相同的代码，并为您请求的每个品种同时返回两个方向。下面的请求获取以美元计的四种贵金属价格：

curl "https://metalapi.com/api/v1/latest?base=USD&currencies=XAU,XAG,XPT,XPD" \
  -H "X-API-Key: $METALAPI_KEY"

rates 对象中每个品种有两个键。以下是文档中的示例数值：

{
  "success": true,
  "timestamp": 1792713600,
  "date": "2026-10-23",
  "base": "USD",
  "rates": {
    "XAU": 0.0002501319446,
    "USDXAU": 3997.89,
    "XAG": 0.01853911754,
    "USDXAG": 53.94,
    "XPT": 0.000620212733,
    "USDXPT": 1612.35,
    "XPD": 0.0006775985906,
    "USDXPD": 1475.8
  }
}

键的规则是：rates.<BASE><SYMBOL> 是 1 单位该品种以基础货币计的价格；不带前缀的 rates.<SYMBOL> 键则是其倒数，保留它是为了兼容外汇类 API。与市场写法的对应关系如下：

要把任意货币对转换为请求，请将报价货币作为 base，将第一个代码作为品种，然后读取二者组合而成的键。下面的辅助函数可以处理 XAU/USD、XAG/EUR、XAU/XAG 甚至 USD/XAU 这样的写法。将其保存为 pair.mjs，并用 Node.js 18 或更高版本运行：

// 将 "XAU/USD" 这样的货币对转换为 MetalAPI 请求，并读取对应的键。
async function pairRate(pair) {
  const [symbol, quote] = pair.toUpperCase().split("/");
  const params = new URLSearchParams({ base: quote, currencies: symbol });
  const res = await fetch(`https://metalapi.com/api/v1/latest?${params}`, {
    headers: { "X-API-Key": process.env.METALAPI_KEY },
    signal: AbortSignal.timeout(10_000),
  });
  const data = await res.json();
  if (!data.success) throw new Error(`MetalAPI ${data.error.code} (${data.error.type}): ${data.error.info}`);

  return { pair, rate: data.rates[`${quote}${symbol}`], asOf: new Date(data.timestamp * 1000).toISOString() };
}

console.log(await pairRate("XAU/USD")); // 按示例价格，rate 为 3997.89
console.log(await pairRate("USD/XAU")); // rate 为 0.0002501319446，即倒数
console.log(await pairRate("XAU/XAG")); // rate 约为 74.12，即金银比

每次调用计为一次请求。当多个货币对使用相同的报价货币时，例如 XAU/USD、XAG/USD 和 XPT/USD，请改为用 currencies=XAU,XAG,XPT 在一次调用中请求所有品种，这样仍只计为一次请求。数据格式指南展示了同一规则如何适用于货币以及买入价和卖出价。

XAU 总是指 1 金衡盎司吗？

在 ISO 4217 和市场报价中，是的：1 单位 XAU 就是 1 金衡盎司黄金，XAU/USD 是每金衡盎司的价格。1 金衡盎司为 31.1034768 克，比日常使用的 28.35 克常衡盎司重约 9.7%，因此金价从来都不是按普通盎司计算的价格。

MetalAPI 默认同样使用金衡盎司，unit 参数可以改变价格所对应的重量单位：troy_oz、gram、kilogram、ounce（常衡）、pound、metric_ton 或 short_ton。使用 unit=gram 时，EURXAU 变为 1 克黄金的欧元价格，响应会在顶层的 unit 字段中重复该单位，以免二者混淆：

curl "https://metalapi.com/api/v1/latest?base=EUR&currencies=XAU&unit=gram" \
  -H "X-API-Key: $METALAPI_KEY"

在文档的示例中，这会返回 "EURXAU": 110.4064149，即每克的欧元价格，而每金衡盎司为 3,434.02 欧元。请在保存的每个价格旁边存储其单位，并留意 unit=ounce 及其简写 oz，它们表示常衡盎司。金衡盎司、克与千克提供了精确的换算系数和取整规则。

其他品种：铜、能源和加密货币

只有黄金、白银、铂金和钯金拥有 ISO 4217 代码。其他大宗商品则使用遵循交易惯例的代码报价。MetalAPI 涵盖五大类共 83 个品种，全部遵循相同的 base、currencies 和键规则：

• 贵金属：XAU、XAG、XPT 和 XPD，即 ISO 4217 代码。
• 工业金属：XCU 铜、ALU 铝、ZNC 锌和 HRC 热轧卷板钢材。XCU 借用了“X 加化学符号”的模式，但它不是 ISO 代码。
• 能源：WTI、BRENT、NATURALGAS、GASOLINE 和 HEATINGOIL，分别按桶、MMBtu 或加仑计价。
• 货币：57 种 ISO 4217 货币，例如 USD、EUR、GBP、JPY 和 INR。
• 加密货币：13 种币，包括 BTC 和 ETH。它们的代码来自交易所，而不是 ISO 4217。

由于任何品种都可以作为基础货币，同样的请求形式既可以用比特币为黄金计价，也可以用黄金衡量一种货币的价值。品种页面列出了每个代码及其名称和实时价格，GET /api/v1/symbols?details=1 则返回每个品种的类别和单位，且不计入配额。

想亲自试试这些代码，请创建免费账户。Free 套餐无需信用卡，每月包含 100 次请求，价格每日更新，足以探索每个品种以及每种汇率的两个方向。

常见问题

XAU 代表什么？

XAU 是 ISO 4217 中代表 1 金衡盎司黄金的代码。X 表示该代码不属于任何国家，AU 是黄金的化学符号，源自拉丁语 aurum。白银是 XAG，铂金是 XPT，钯金是 XPD。

XAU/USD 就是黄金现货价格吗？

是的。XAU/USD 是以美元/金衡盎司计的黄金现货价格的通用写法。大多数网站和 API 显示的是买入价与卖出价之间的中间价。交易商以低于该价格的价格买入、以高于该价格的价格卖出，因此零售金币或金条的价格高于 XAU/USD。

XAUUSD 和 XAU/USD 有什么区别？

在交易中两者没有区别：XAUUSD 就是去掉斜杠的同一个货币对，许多经纪商和图表平台都这样写。但在 MetalAPI 的响应中，这个价格对应的是键 USDXAU，因为 API 的键把基础货币放在前面。名为 XAUUSD 的键只在 base=XAU 时出现，表示倒数，即 1 美元以黄金盎司计的价格。

为什么我的 API 响应中 XAU 的值这么小？

因为不带前缀的 XAU 键是倒数汇率：每单位基础货币可买到的黄金金衡盎司数，例如每美元 0.00025 盎司。每盎司价格在带前缀的键中，基础货币为 USD 时是 USDXAU，为 EUR 时是 EURXAU。如果您只有倒数，价格就是 1 除以它。

XAU 是一种货币吗？

不是由国家发行的那种货币。ISO 4217 为黄金、白银、铂金和钯金分配代码，是因为银行持有和交易它们的方式与货币十分相似，这样为汇率构建的系统就能用相同的写法和相同的三字母字段处理金属。