Signification de XAU/USD : que veulent dire XAU, XAG, XPT et XPD

Que signifie XAU/USD ?

XAU/USD est le prix d'une once troy d'or en dollars américains. Voilà toute la signification de XAU/USD en une phrase : XAU est le code de l'or, USD celui du dollar américain, et le nombre affiché à côté de la paire indique combien de dollars coûte une once d'or. Si un graphique affiche XAU/USD à 3 997,89, une once d'or coûte 3 997,89 dollars. Ce chiffre est la valeur d'exemple utilisée dans toute la documentation de MetalAPI, pas un prix en direct.

Cette notation vient du marché des changes, où chaque prix s'écrit sous la forme d'une paire de codes :

• La base (le premier code) est ce dont on donne le prix, ici une once troy d'or.
• La devise de cotation (le second code) est celle dans laquelle le prix est exprimé, ici le dollar américain.
• Le cours est le nombre d'unités de la devise de cotation que vaut une unité de la base.

EUR/USD fonctionne de la même manière : c'est le prix d'un euro en dollars. Les courtiers et les plateformes de trading omettent souvent la barre oblique et écrivent XAUUSD, et les sites de graphiques intitulent la même série « or spot ». Tous ces noms désignent le prix spot de l'or en dollars par once troy, généralement le point médian entre les cotations bid et ask du marché de gros. Spot, bid et ask expliqués montre comment ce point médian se rapporte aux prix que pratiquent réellement les négociants.

Que signifient XAU, XAG, XPT et XPD ?

Quatre métaux précieux ont leur propre code dans la norme ISO 4217, le standard international des codes de devises. Chaque code représente une once troy du métal, soit 31,1034768 grammes :

Le principe : un X suivi du symbole chimique du métal. Les symboles de l'or et de l'argent dérivent du latin, d'où XAU pour l'or (aurum) et XAG pour l'argent (argentum), et non des codes tirés de leurs noms anglais, gold et silver.

L'argent, le platine et le palladium se lisent exactement comme l'or. XAG/USD est le prix d'une once troy d'argent en dollars (53,94 dans l'exemple de la documentation), XPT/USD celui d'une once de platine (1 612,35) et XPD/USD celui d'une once de palladium (1 475,80).

La norme ISO 4217 ne définit aucune subdivision pour les métaux. Un dollar compte 100 cents, mais il n'existe pas de centième officiel d'once d'or : les quantités et les prix des métaux s'écrivent donc avec autant de décimales que l'usage l'exige.

Pourquoi l'or a-t-il un code de devise ?

Les codes ISO 4217 comportent trois lettres. Pour les monnaies nationales, les deux premières sont le code ISO 3166 du pays et la troisième vient généralement du nom de la monnaie : US plus D pour le dollar américain, JP plus Y pour le yen japonais. Les codes qui n'appartiennent à aucun pays commencent par X. Outre les quatre métaux, ce groupe comprend le droit de tirage spécial du FMI (XDR), des monnaies régionales comme le franc CFA d'Afrique de l'Ouest (XOF) et le dollar des Caraïbes orientales (XCD), ainsi que deux codes techniques : XTS pour les tests et XXX pour les transactions sans devise.

L'or n'est la monnaie d'aucun pays : pourquoi figure-t-il alors dans une liste de devises ? Parce que, sur le marché de gros, les métaux précieux se comportent largement comme des devises. Les banques les détiennent sur des comptes métal, les cotent au comptant face au dollar américain jour et nuit en semaine et règlent les transactions entre comptes de façon semblable au change. Un code standard permet aux systèmes de paiement, de comptabilité et de trading d'enregistrer une once d'or comme ils enregistrent un euro.

Pour les développeurs, cela présente un avantage pratique : l'or s'intègre dans n'importe quel champ, table ou bibliothèque qui attend un code de devise à trois lettres. Le piège, c'est qu'un montant en XAU est une quantité de métal mesurée en onces troy, pas une somme monétaire. Le formater avec un symbole monétaire ou l'arrondir à deux décimales comme des centimes tourne vite mal : 0,00025 XAU arrondi comme des centimes devient 0,00.

XAU/USD ou USD/XAU : dans quel sens ?

Chaque paire peut s'écrire dans les deux sens, et les deux portent la même information. XAU/USD, ce sont des dollars par once d'or. USD/XAU, ce sont des onces d'or par dollar, soit simplement 1 divisé par le cours XAU/USD. Avec les prix d'exemple de la documentation :

La convention de marché place le métal en premier, pour que le nombre coté soit un prix lisible. USD/XAU apparaît rarement à l'écran, mais il est courant dans les logiciels, où une table de cours indique combien de chaque devise achète une unité d'une base commune. Les deux sens ont leur utilité ; les bugs viennent de leur confusion.

Les deux dernières lignes montrent que la devise de cotation n'est pas forcément le dollar. XAU/EUR donne le prix de l'or en euros (l'exemple utilise 1,1642 dollar par euro), et XAU/XAG le prix de l'or en onces d'argent, c'est-à-dire le ratio or/argent. Le ratio or/argent explique ce que ce nombre indique et comment le suivre.

Une vérification rapide détecte presque toutes les erreurs de sens. Le prix d'une once troy d'or dans une monnaie nationale est bien supérieur à 1 : si le nombre que vous vous apprêtez à afficher comme cours de l'or est une petite fraction, vous avez sous les yeux le taux inverse.

Comment MetalAPI renvoie XAU et USDXAU

MetalAPI utilise les mêmes codes et renvoie les deux sens pour chaque symbole demandé. Cette requête demande les quatre métaux précieux en dollars américains :

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

L'objet rates contient deux clés par symbole. Voici les valeurs d'exemple de la documentation :

{
  "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 règle derrière les clés : rates.<BASE><SYMBOL> est le prix d'une unité du symbole dans la devise de base, et la clé simple rates.<SYMBOL> en est l'inverse, conservée pour la compatibilité avec les API de type forex. Transposé en notation de marché :

Pour transformer n'importe quelle paire en requête, utilisez la devise de cotation comme base et le premier code comme symbole, puis lisez la clé qui les réunit. Cet utilitaire le fait pour des paires écrites XAU/USD, XAG/EUR, XAU/XAG ou même USD/XAU. Enregistrez-le sous pair.mjs et exécutez-le avec Node.js 18 ou plus récent :

// Traduit une paire comme "XAU/USD" en requête MetalAPI et lit la clé correspondante.
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")); // cours 3997.89 aux prix d'exemple
console.log(await pairRate("USD/XAU")); // cours 0.0002501319446, l'inverse
console.log(await pairRate("XAU/XAG")); // cours d'environ 74.12, le ratio or/argent

Chaque appel est une requête. Lorsque plusieurs paires partagent la même devise de cotation, comme XAU/USD, XAG/USD et XPT/USD, demandez plutôt tous les symboles en un seul appel avec currencies=XAU,XAG,XPT ; il ne compte toujours qu'une fois. Le guide des formats de données applique la même règle aux devises et aux prix bid et ask.

XAU correspond-il toujours à une once troy ?

Dans la norme ISO 4217 et dans les cotations de marché, oui : une unité de XAU est une once troy d'or, et XAU/USD est un prix par once troy. L'once troy pèse 31,1034768 grammes, environ 9,7 % de plus que l'once avoirdupois courante de 28,35 grammes : un cours de l'or n'est donc jamais un prix par once ordinaire.

MetalAPI utilise aussi l'once troy par défaut, et le paramètre unit change le poids auquel un prix se rapporte : troy_oz, gram, kilogram, ounce (avoirdupois), pound, metric_ton ou short_ton. Avec unit=gram, EURXAU devient le prix d'un gramme d'or en euros, et la réponse répète l'unité dans un champ unit de premier niveau pour éviter toute confusion :

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

Dans l'exemple de la documentation, cette requête renvoie "EURXAU": 110.4064149, en euros par gramme, contre 3 434,02 euros par once troy. Stockez l'unité à côté de chaque prix que vous enregistrez, et méfiez-vous de unit=ounce et de sa forme courte oz, qui désignent l'once avoirdupois. Onces troy, grammes et kilogrammes donne les facteurs exacts et les règles d'arrondi.

Autres symboles : cuivre, énergie et cryptos

Seuls l'or, l'argent, le platine et le palladium ont des codes ISO 4217. Les autres matières premières sont cotées avec des symboles qui suivent plutôt les conventions du trading. MetalAPI couvre 83 symboles répartis en cinq groupes, qui suivent tous les mêmes règles pour base, currencies et les clés :

• Métaux précieux : XAU, XAG, XPT et XPD, les codes ISO 4217.
• Métaux industriels : XCU pour le cuivre, ALU pour l'aluminium, ZNC pour le zinc et HRC pour l'acier en bobines laminées à chaud. XCU reprend le principe X plus symbole chimique, mais ce n'est pas un code ISO.
• Énergie : WTI, BRENT, NATURALGAS, GASOLINE et HEATINGOIL, cotés par baril, par MMBtu ou par gallon.
• Devises : 57 devises ISO 4217, comme USD, EUR, GBP, JPY et INR.
• Cryptos : 13 cryptomonnaies, dont BTC et ETH. Leurs tickers viennent des plateformes d'échange, pas de la norme ISO 4217.

Comme n'importe quel symbole peut servir de base, la même forme de requête permet de coter l'or en bitcoins ou d'évaluer une devise en or. La page des symboles liste chaque code avec son nom et son prix en direct, et GET /api/v1/symbols?details=1 renvoie la catégorie et l'unité de chaque symbole sans être décompté de votre quota.

Pour essayer ces codes vous-même, créez un compte gratuit. Le plan Free ne demande pas de carte bancaire et inclut 100 requêtes par mois avec des prix mis à jour quotidiennement, de quoi explorer chaque symbole et les deux sens de chaque cours.

Questions fréquentes

Que signifie XAU ?

XAU est le code ISO 4217 d'une once troy d'or. Le X signale un code qui n'appartient à aucun pays, et AU est le symbole chimique de l'or, du latin aurum. L'argent est XAG, le platine XPT et le palladium XPD.

XAU/USD est-il la même chose que le cours spot de l'or ?

Oui. XAU/USD est la notation habituelle du prix spot de l'or en dollars américains par once troy. La plupart des sites web et des API affichent le prix mid entre bid et ask. Les négociants achètent en dessous et vendent au-dessus : une pièce ou un lingot au détail coûte donc plus cher que XAU/USD.

Quelle est la différence entre XAUUSD et XAU/USD ?

En trading, aucune : XAUUSD est la même paire sans la barre oblique, telle que l'écrivent de nombreux courtiers et plateformes de graphiques. Dans les réponses de MetalAPI, en revanche, ce prix correspond à la clé USDXAU, car les clés de l'API placent la devise de base en premier. Une clé nommée XAUUSD n'apparaît qu'avec base=XAU et désigne l'inverse : le prix d'un dollar en onces d'or.

Pourquoi la valeur XAU de ma réponse d'API est-elle si petite ?

Parce que la clé simple XAU est le taux inverse : des onces troy d'or par unité de la devise de base, par exemple 0,00025 once par dollar. Le prix par once se trouve dans la clé préfixée, USDXAU avec la base USD ou EURXAU avec la base EUR. Si vous n'avez que l'inverse, le prix vaut 1 divisé par celui-ci.

XAU est-il une devise ?

Pas au sens d'une monnaie émise par un pays. La norme ISO 4217 attribue des codes à l'or, à l'argent, au platine et au palladium parce que les banques les détiennent et les échangent un peu comme des devises : les systèmes conçus pour les taux de change peuvent ainsi traiter les métaux avec la même notation et les mêmes champs à trois lettres.