Qué significa XAU/USD: los códigos XAU, XAG, XPT y XPD

¿Qué significa XAU/USD?

XAU/USD es el precio de una onza troy de oro en dólares estadounidenses. Ese es todo el significado de XAU/USD en una frase: XAU es el código del oro, USD es el dólar estadounidense, y la cifra junto al par indica cuántos dólares cuesta una onza de oro. Si un gráfico muestra XAU/USD a 3997,89, una onza de oro cuesta 3997,89 dólares. Esa cifra es el valor de ejemplo que se usa en toda la documentación de MetalAPI, no un precio en tiempo real.

La notación procede del mercado de divisas, donde cada precio se escribe como un par de códigos:

• La base (el primer código) es lo que se valora, en este caso una onza troy de oro.
• La divisa de cotización (el segundo código) es aquello en lo que se expresa el precio, en este caso dólares estadounidenses.
• La cotización es el número de unidades de la divisa de cotización que vale una unidad de la base.

EUR/USD funciona igual: es el precio de un euro en dólares. Los brókeres y las plataformas de trading suelen quitar la barra y escribir XAUUSD, y los sitios de gráficos llaman a la misma serie oro al contado (gold spot). Todos estos nombres se refieren al precio al contado del oro en dólares por onza troy, normalmente el punto medio entre las cotizaciones de compra (bid) y de venta (ask) del mercado mayorista. Spot, bid, ask y spread explica cómo se relaciona ese punto medio con los precios que cobran realmente los distribuidores.

¿Qué significan XAU, XAG, XPT y XPD?

Cuatro metales preciosos tienen sus propios códigos en ISO 4217, la norma internacional de códigos de divisas. Cada código representa una onza troy del metal, que equivale a 31,1034768 gramos:

El patrón es una X seguida del símbolo químico del metal. El oro y la plata tienen símbolos derivados del latín, por eso el oro es XAU y no un código que empiece por G (de gold, su nombre en inglés), y la plata es XAG y no uno que empiece por S (de silver).

La plata, el platino y el paladio se leen exactamente igual que el oro. XAG/USD es el precio de una onza troy de plata en dólares (53,94 en el ejemplo de la documentación), XPT/USD el precio de una onza de platino (1612,35) y XPD/USD el precio de una onza de paladio (1475,80).

La ISO 4217 no define ninguna unidad fraccionaria para los metales. Un dólar tiene 100 centavos, pero no existe una centésima oficial de onza de oro, así que las cantidades y los precios de los metales se escriben con tantos decimales como requiera el uso.

¿Por qué el oro tiene un código de divisa?

Los códigos ISO 4217 tienen tres letras. En las divisas nacionales, las dos primeras letras son el código ISO 3166 del país y la tercera suele proceder del nombre de la divisa: US más D para el dólar estadounidense, JP más Y para el yen japonés. Los códigos que no pertenecen a ningún país concreto empiezan por X. Además de los cuatro metales, ese grupo incluye el derecho especial de giro del FMI (XDR), divisas regionales como el franco CFA de África Occidental (XOF) y el dólar del Caribe Oriental (XCD), y dos códigos técnicos: XTS para pruebas y XXX para transacciones en las que no interviene ninguna divisa.

El oro no es la moneda de ningún país, así que ¿por qué figura en una lista de divisas? Porque en el mercado mayorista los metales preciosos se comportan en gran medida como divisas. Los bancos los mantienen en cuentas metal, los cotizan al contado frente al dólar estadounidense las 24 horas de los días laborables y liquidan las operaciones entre cuentas de forma parecida a las de divisas. Un código estándar permite que los sistemas de pagos, contabilidad y trading registren una onza de oro igual que registran un euro.

Para los desarrolladores, esto tiene una ventaja práctica: el oro encaja en cualquier campo, tabla o biblioteca que espere un código de divisa de tres letras. La pega es que un importe en XAU es una cantidad de metal medida en onzas troy, no una suma de dinero. Darle formato con un símbolo de moneda, o redondearlo a dos decimales como si fueran céntimos, sale mal enseguida: 0,00025 XAU redondeado como céntimos se convierte en 0,00.

XAU/USD frente a USD/XAU: ¿en qué orden?

Cada par puede escribirse en dos sentidos, y ambos contienen la misma información. XAU/USD son dólares por onza de oro. USD/XAU son onzas de oro por dólar, que es simplemente 1 dividido entre la cotización XAU/USD. Con los precios de ejemplo de la documentación:

La convención del mercado pone primero el metal, para que la cifra cotizada sea un precio que la gente pueda leer. USD/XAU rara vez aparece en pantalla, pero es habitual dentro del software, donde una tabla de cotizaciones indica cuánto de cada divisa se compra con una unidad de una base común. Ambos sentidos tienen su utilidad; los errores vienen de confundirlos.

Las dos últimas filas muestran que el lado de la cotización no tiene por qué ser el dólar. XAU/EUR expresa el precio del oro en euros (el ejemplo usa 1,1642 dólares por euro), y XAU/XAG lo expresa en onzas de plata, que es la relación oro/plata. La relación oro/plata explica qué te dice esa cifra y cómo seguirla.

Una comprobación rápida detecta casi cualquier error de sentido. El precio de una onza troy de oro en una divisa nacional es muy superior a 1, así que si la cifra que estás a punto de mostrar como precio del oro es una pequeña fracción, estás viendo la cotización inversa.

Cómo devuelve MetalAPI XAU y USDXAU

MetalAPI usa los mismos códigos y devuelve ambos sentidos para cada símbolo que pidas. Esta solicitud pide los cuatro metales preciosos en dólares estadounidenses:

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

El objeto rates contiene dos claves por símbolo. Estos son los valores de ejemplo de la documentación:

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

La regla detrás de las claves: rates.<BASE><SYMBOL> es el precio de una unidad del símbolo en la divisa base, y la clave simple rates.<SYMBOL> es su inversa, que se mantiene por compatibilidad con las API de estilo forex. Su equivalencia con la notación de mercado:

Para convertir cualquier par en una solicitud, usa la divisa de cotización como base y el primer código como símbolo, y luego lee la clave que los une. Esta función auxiliar lo hace con pares escritos como XAU/USD, XAG/EUR, XAU/XAG o incluso USD/XAU. Guárdala como pair.mjs y ejecútala con Node.js 18 o posterior:

// Convierte un par como "XAU/USD" en una solicitud a MetalAPI y lee la clave correspondiente.
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")); // cotización 3997.89 con los precios de ejemplo
console.log(await pairRate("USD/XAU")); // cotización 0.0002501319446, la inversa
console.log(await pairRate("XAU/XAG")); // cotización de unos 74.12, la relación oro/plata

Cada llamada es una solicitud. Cuando varios pares comparten divisa de cotización, como XAU/USD, XAG/USD y XPT/USD, pide todos los símbolos en una sola llamada con currencies=XAU,XAG,XPT; sigue contando una sola vez. La guía de formatos de datos muestra la misma regla para las divisas y para los precios bid y ask.

¿XAU es siempre una onza troy?

En ISO 4217 y en las cotizaciones de mercado, sí: una unidad de XAU es una onza troy de oro, y XAU/USD es un precio por onza troy. La onza troy equivale a 31,1034768 gramos, aproximadamente un 9,7 % más que la onza avoirdupois de uso cotidiano, de 28,35 gramos, así que un precio del oro nunca es un precio por onza normal.

MetalAPI también usa la onza troy por defecto, y el parámetro unit cambia el peso al que se refiere un precio: troy_oz, gram, kilogram, ounce (avoirdupois), pound, metric_ton o short_ton. Con unit=gram, EURXAU pasa a ser el precio de un gramo de oro en euros, y la respuesta repite la unidad en un campo unit de nivel superior para que no puedan confundirse:

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

En el ejemplo de la documentación, esto devuelve "EURXAU": 110.4064149, euros por gramo, frente a 3434,02 euros por onza troy. Guarda la unidad junto a cada precio que almacenes, y ten cuidado con unit=ounce y su forma abreviada oz, que se refieren a la onza avoirdupois. Onzas troy, gramos y kilogramos incluye los factores exactos y las reglas de redondeo.

Otros símbolos: cobre, energía y criptomonedas

Solo el oro, la plata, el platino y el paladio tienen códigos ISO 4217. Las demás materias primas se cotizan con símbolos que siguen convenciones de trading. MetalAPI cubre 83 símbolos en cinco grupos, y todos siguen las mismas reglas de base, currencies y claves:

• Metales preciosos: XAU, XAG, XPT y XPD, los códigos ISO 4217.
• Metales industriales: XCU cobre, ALU aluminio, ZNC zinc y HRC bobina de acero laminado en caliente. XCU toma prestado el patrón de X más símbolo químico, pero no es un código ISO.
• Energía: WTI, BRENT, NATURALGAS, GASOLINE y HEATINGOIL, con precio por barril, MMBtu o galón.
• Divisas: 57 divisas ISO 4217, como USD, EUR, GBP, JPY e INR.
• Criptomonedas: 13 monedas, entre ellas BTC y ETH. Sus tickers proceden de los exchanges, no de ISO 4217.

Como cualquier símbolo puede ser la base, la misma forma de solicitud sirve para expresar el precio del oro en bitcoin o valorar una divisa en oro. La página de símbolos enumera cada código con su nombre y su precio en tiempo real, y GET /api/v1/symbols?details=1 devuelve la categoría y la unidad de cada símbolo sin contar para tu cuota.

Para probar los códigos tú mismo, crea una cuenta gratuita. El plan Free no requiere tarjeta de crédito e incluye 100 solicitudes al mes con actualización diaria de precios, más que suficiente para explorar cada símbolo y ambos sentidos de cada cotización.

Preguntas frecuentes

¿Qué significa XAU?

XAU es el código ISO 4217 de una onza troy de oro. La X indica un código que no pertenece a ningún país, y AU es el símbolo químico del oro, del latín aurum. La plata es XAG, el platino XPT y el paladio XPD.

¿XAU/USD es lo mismo que el precio al contado del oro?

Sí. XAU/USD es la notación habitual del precio al contado del oro en dólares estadounidenses por onza troy. La mayoría de los sitios web y de las API muestran el precio medio entre bid y ask. Los distribuidores compran por debajo de él y venden por encima, así que una moneda o un lingote al por menor cuesta más que XAU/USD.

¿Qué diferencia hay entre XAUUSD y XAU/USD?

En trading, ninguna: XAUUSD es el mismo par sin la barra, tal como lo escriben muchos brókeres y plataformas de gráficos. Sin embargo, en las respuestas de MetalAPI ese precio es la clave USDXAU, porque las claves de la API ponen primero la divisa base. Una clave llamada XAUUSD solo aparece con base=XAU y significa la inversa: el precio de un dólar en onzas de oro.

¿Por qué el valor de XAU en mi respuesta de la API es tan pequeño?

Porque la clave simple XAU es la cotización inversa: onzas troy de oro por unidad de la divisa base, como 0,00025 onzas por dólar. El precio por onza está en la clave con prefijo, USDXAU con base USD o EURXAU con base EUR. Si solo tienes la inversa, el precio es 1 dividido entre ella.

¿XAU es una divisa?

No en el sentido de dinero emitido por un país. La ISO 4217 asigna códigos al oro, la plata, el platino y el paladio porque los bancos los mantienen y negocian de forma muy parecida a las divisas, de modo que los sistemas creados para tipos de cambio pueden manejar los metales con la misma notación y los mismos campos de tres letras.