Significado de XAU/USD: o que são XAU, XAG, XPT e XPD

O que significa XAU/USD?

XAU/USD é o preço de uma onça troy de ouro em dólares americanos. Esse é todo o significado de XAU/USD em uma frase: XAU é o código do ouro, USD é o dólar americano, e o número ao lado do par diz quantos dólares custa uma onça de ouro. Se um gráfico mostra XAU/USD em 3.997,89, uma onça de ouro custa 3.997,89 dólares. Esse número é o valor de exemplo usado em toda a documentação da MetalAPI, não um preço ao vivo.

A notação vem do mercado de câmbio (forex), onde todo preço é escrito como um par de códigos:

• A base (o primeiro código) é o que está sendo precificado, aqui uma onça troy de ouro.
• A moeda de cotação (o segundo código) é a moeda em que o preço é expresso, aqui o dólar americano.
• A taxa é o número de unidades da moeda de cotação que uma unidade da base vale.

O EUR/USD funciona da mesma forma: é o preço de um euro em dólares. Corretoras e plataformas de trading costumam tirar a barra e escrever XAUUSD, e sites de gráficos chamam a mesma série de ouro spot (gold spot). Todos esses nomes se referem ao preço à vista do ouro em dólares por onça troy, geralmente o ponto médio entre as cotações de compra (bid) e de venda (ask) do mercado de atacado. Spot, bid e ask explicados mostra como esse ponto médio se relaciona com os preços que os revendedores de fato cobram.

O que significam XAU, XAG, XPT e XPD?

Quatro metais preciosos têm códigos próprios na ISO 4217, o padrão internacional de códigos de moeda. Cada código representa uma onça troy do metal, que equivale a 31,1034768 gramas:

O padrão é um X seguido do símbolo químico do metal. O ouro e a prata têm símbolos derivados do latim, e é por isso que o ouro é XAU, e não algo que comece com O, e a prata é XAG, e não algo que comece com P.

Prata, platina e paládio são lidos exatamente como o ouro. XAG/USD é o preço de uma onça troy de prata em dólares (53,94 no exemplo da documentação), XPT/USD é o preço de uma onça de platina (1.612,35) e XPD/USD é o preço de uma onça de paládio (1.475,80).

A ISO 4217 não define subunidade para os metais. Um dólar tem 100 centavos, mas não existe um centésimo oficial de onça de ouro, então quantidades e preços de metais são escritos com tantas casas decimais quanto o uso exigir.

Por que o ouro tem um código de moeda?

Os códigos ISO 4217 têm três letras. Nas moedas nacionais, as duas primeiras letras são o código ISO 3166 do país e a terceira geralmente vem do nome da moeda: US mais D para o dólar americano, JP mais Y para o iene japonês. Códigos que não pertencem a nenhum país específico começam com X. Além dos quatro metais, esse grupo inclui o direito especial de saque do FMI (XDR), moedas regionais como o franco CFA da África Ocidental (XOF) e o dólar do Caribe Oriental (XCD), e dois códigos técnicos: XTS para testes e XXX para transações que não envolvem moeda.

O ouro não é a moeda de nenhum país, então por que ele está em uma lista de moedas? Porque, no mercado de atacado, os metais preciosos se comportam de forma muito parecida com as moedas. Os bancos os mantêm em contas de metal, cotam-nos à vista contra o dólar americano 24 horas por dia nos dias úteis e liquidam operações entre contas de maneira semelhante ao câmbio. Um código padrão permite que sistemas de pagamento, contabilidade e trading registrem uma onça de ouro da mesma forma que registram um euro.

Para desenvolvedores, isso tem uma vantagem prática: o ouro cabe em qualquer campo, tabela ou biblioteca que espere um código de moeda de três letras. O porém é que um valor em XAU é uma quantidade de metal medida em onças troy, e não uma quantia em dinheiro. Formatá-lo com um símbolo de moeda, ou arredondá-lo para duas casas decimais como se fossem centavos, dá errado rapidamente: 0,00025 XAU arredondado como centavos vira 0,00.

XAU/USD ou USD/XAU: qual é a ordem certa?

Todo par pode ser escrito nas duas direções, e ambas trazem a mesma informação. XAU/USD é dólares por onça de ouro. USD/XAU é onças de ouro por dólar, que é simplesmente 1 dividido pela taxa XAU/USD. Com os preços de exemplo da documentação:

A convenção de mercado coloca o metal primeiro, para que o número cotado seja um preço que as pessoas consigam ler. USD/XAU raramente aparece nas telas, mas é comum dentro de software, onde uma tabela de taxas lista quanto de cada moeda uma unidade de uma base comum compra. As duas direções têm sua utilidade; os bugs surgem quando elas são confundidas.

As duas últimas linhas mostram que o lado da cotação não precisa ser o dólar. XAU/EUR precifica o ouro em euros (o exemplo usa 1,1642 dólar por euro), e XAU/XAG precifica o ouro em onças de prata, que é a relação ouro/prata. A relação ouro/prata explica o que esse número indica e como acompanhá-lo.

Uma verificação rápida pega quase todo erro de direção. O preço de uma onça troy de ouro em uma moeda nacional é muito maior que 1, então, se o número que você está prestes a exibir como preço do ouro for uma fração pequena, você está olhando para a taxa inversa.

Como a MetalAPI retorna XAU e USDXAU

A MetalAPI usa os mesmos códigos e retorna as duas direções para cada símbolo solicitado. Esta requisição pede os quatro metais preciosos em dólares americanos:

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

O objeto rates contém duas chaves por símbolo. Estes são os valores de exemplo da documentação:

{
  "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
  }
}

A regra por trás das chaves: rates.<BASE><SYMBOL> é o preço de uma unidade do símbolo na moeda base, e a chave simples rates.<SYMBOL> é o seu inverso, mantida por compatibilidade com APIs no estilo forex. Em notação de mercado:

Para transformar qualquer par em uma requisição, use a moeda de cotação como base e o primeiro código como símbolo e, em seguida, leia a chave que une os dois. Este helper faz isso para pares escritos como XAU/USD, XAG/EUR, XAU/XAG ou até USD/XAU. Salve-o como pair.mjs e execute-o com Node.js 18 ou mais recente:

// Transforma um par como "XAU/USD" em uma requisição à MetalAPI e lê a chave correspondente.
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")); // taxa 3997.89 com os preços de exemplo
console.log(await pairRate("USD/XAU")); // taxa 0.0002501319446, o inverso
console.log(await pairRate("XAU/XAG")); // taxa de cerca de 74.12, a relação ouro/prata

Cada chamada é uma requisição. Quando vários pares compartilham a mesma moeda de cotação, como XAU/USD, XAG/USD e XPT/USD, peça todos os símbolos em uma só chamada com currencies=XAU,XAG,XPT; ela continua contando como uma única requisição. O guia de formatos de dados mostra a mesma regra para moedas e para preços de compra (bid) e de venda (ask).

XAU é sempre uma onça troy?

Na ISO 4217 e nas cotações de mercado, sim: uma unidade de XAU é uma onça troy de ouro, e XAU/USD é um preço por onça troy. A onça troy tem 31,1034768 gramas, cerca de 9,7% a mais que a onça avoirdupois do dia a dia, de 28,35 gramas, então um preço do ouro nunca é um preço por onça comum.

A MetalAPI também usa onças troy por padrão, e o parâmetro unit muda o peso a que o preço se refere: troy_oz, gram, kilogram, ounce (avoirdupois), pound, metric_ton ou short_ton. Com unit=gram, EURXAU passa a ser o preço de um grama de ouro em euros, e a resposta repete a unidade em um campo unit de nível superior para que não haja confusão entre as duas:

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

No exemplo da documentação, isso retorna "EURXAU": 110.4064149, euros por grama, contra 3.434,02 euros por onça troy. Guarde a unidade junto com cada preço que você salvar e tome cuidado com unit=ounce e sua forma abreviada oz, que significam a onça avoirdupois. Onças troy, gramas e quilogramas traz os fatores exatos e as regras de arredondamento.

Outros símbolos: cobre, energia e cripto

Apenas ouro, prata, platina e paládio têm códigos ISO 4217. As outras commodities são cotadas com símbolos que seguem convenções de trading. A MetalAPI cobre 83 símbolos em cinco grupos, e todos seguem as mesmas regras de base, currencies e chaves:

• Metais preciosos: XAU, XAG, XPT e XPD, os códigos ISO 4217.
• Metais industriais: XCU cobre, ALU alumínio, ZNC zinco e HRC bobina de aço laminada a quente. XCU segue o padrão X mais símbolo químico, mas não é um código ISO.
• Energia: WTI, BRENT, NATURALGAS, GASOLINE e HEATINGOIL, cotados por barril, MMBtu ou galão.
• Moedas: 57 moedas ISO 4217, como USD, EUR, GBP, JPY e INR.
• Cripto: 13 criptomoedas, incluindo BTC e ETH. Seus tickers vêm das exchanges, não da ISO 4217.

Como qualquer símbolo pode ser a base, o mesmo formato de requisição pode precificar o ouro em bitcoin ou avaliar uma moeda em ouro. A página de símbolos lista todos os códigos com nome e preço ao vivo, e GET /api/v1/symbols?details=1 retorna a categoria e a unidade de cada símbolo sem contar para a sua cota.

Para testar os códigos você mesmo, crie uma conta grátis. O plano Free não exige cartão de crédito e inclui 100 requisições por mês com atualização diária dos preços, mais do que suficiente para explorar todos os símbolos e as duas direções de cada taxa.

Perguntas frequentes

O que significa XAU?

XAU é o código ISO 4217 para uma onça troy de ouro. O X indica um código que não pertence a nenhum país, e AU é o símbolo químico do ouro, do latim aurum. A prata é XAG, a platina XPT e o paládio XPD.

XAU/USD é o mesmo que o preço spot do ouro?

Sim. XAU/USD é a notação usual do preço à vista (spot) do ouro em dólares americanos por onça troy. A maioria dos sites e APIs mostra o preço médio entre bid e ask. Os revendedores compram abaixo dele e vendem acima, por isso uma moeda ou barra no varejo custa mais que o XAU/USD.

Qual é a diferença entre XAUUSD e XAU/USD?

No trading, nenhuma: XAUUSD é o mesmo par sem a barra, como muitas corretoras e plataformas de gráficos o escrevem. Nas respostas da MetalAPI, porém, esse preço é a chave USDXAU, porque as chaves da API colocam a moeda base primeiro. Uma chave chamada XAUUSD só aparece com base=XAU e significa o inverso, o preço de um dólar em onças de ouro.

Por que o valor de XAU na minha resposta da API é tão pequeno?

Porque a chave simples XAU é a taxa inversa: onças troy de ouro por unidade da moeda base, como 0,00025 onça por dólar. O preço por onça está na chave com prefixo, USDXAU com base USD ou EURXAU com base EUR. Se você tiver apenas o inverso, o preço é 1 dividido por ele.

XAU é uma moeda?

Não no sentido de dinheiro emitido por um país. A ISO 4217 atribui códigos ao ouro, à prata, à platina e ao paládio porque os bancos os mantêm e negociam de forma muito parecida com moedas, e assim sistemas criados para taxas de câmbio conseguem tratar metais com a mesma notação e os mesmos campos de três letras.