API du cours de l'argent : prix XAG en direct et historiques

Ce que vous apporte une API du cours de l'argent

Une API du cours de l'argent renvoie le prix actuel et historique de l'argent sous forme de données structurées, généralement du JSON via HTTPS, pour qu'une boutique, une application ou un rapport puisse l'utiliser sans recopier des chiffres depuis un site web. Dans MetalAPI, l'argent a pour symbole XAG, le code ISO 4217 d'une once troy d'argent. Sa valeur en direct est le prix spot : le point médian entre les cotations bid et ask du marché de gros.

L'argent partage son API avec l'or, mais il a ses propres habitudes. Il est coté à l'once troy mais acheté et vendu au gramme et au kilogramme, son prix au gramme est assez faible pour que l'arrondi compte, et les acheteurs d'argenterie et de vieil argent raisonnent en titre plutôt qu'en carats. Ce guide couvre les requêtes et les détails propres à l'argent :

• Le cours de l'argent en direct en une requête, et comment le lire.
• Le prix de l'argent à l'once, au gramme et au kilogramme.
• L'argent dans d'autres devises, toujours en une seule requête.
• Les cours historiques de l'argent depuis 2000.
• Cas d'usage : négociants en métaux précieux, acheteurs d'argenterie et de vieil argent, et applications d'investissement.

Obtenir le cours de l'argent en direct par API

Créez un compte gratuit et ajoutez une clé API dans le tableau de bord. Les clés commencent par mk_live_. Conservez la vôtre dans une variable d'environnement et envoyez-la dans un en-tête, puis interrogez /latest avec XAG :

export METALAPI_KEY="mk_live_your_key_here"

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

La réponse ressemble à ceci. Les chiffres sont les valeurs d'exemple utilisées dans toute la documentation MetalAPI, pas des prix en direct :

{
  "success": true,
  "timestamp": 1792713600,
  "date": "2026-10-23",
  "base": "USD",
  "rates": {
    "XAG": 0.01853911754,
    "USDXAG": 53.94
  }
}

USDXAG est le prix d'une once troy d'argent dans la devise de base, 53,94 dollars américains dans cet exemple. XAG en est l'inverse, des onces troy d'argent par dollar, conservé pour la compatibilité avec les API de type forex. Lisez toujours la clé préfixée : traiter rates.XAG comme le prix afficherait 0,0185 au lieu de 53,94.

timestamp est l'heure des données, pas celle de votre requête. L'argent au comptant se négocie jour et nuit en semaine et marque une pause du vendredi 17:00 au dimanche 17:00, heure de New York : le week-end, l'API continue donc de renvoyer le cours de clôture du vendredi. Affichez l'horodatage à côté du prix, surtout le samedi et le dimanche.

Si vous avez aussi besoin de l'or, du platine ou du palladium, ajoutez-les à la même requête : currencies=XAU,XAG,XPT,XPD. Une requête ne compte qu'une fois, quel que soit le nombre de symboles renvoyés.

Prix de l'argent à l'once, au gramme et au kilogramme

Les prix de l'argent sont exprimés par once troy, soit 31,1034768 grammes, sauf si vous passez unit. Les valeurs acceptées sont troy_oz (par défaut), gram, kilogram, ounce, pound, metric_ton et short_ton, et la réponse ajoute un champ unit de premier niveau chaque fois que l'unité n'est pas celle par défaut :

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

Au prix d'exemple de 53,94 dollars l'once troy, l'argent coûte :

Deux habitudes valent la peine d'être adoptées pour l'argent. D'abord, affichez plus de décimales au gramme : à 1,7342 dollar, deux décimales masquent l'essentiel des variations quotidiennes, et quatre sont donc courantes. Ensuite, si vous affichez plusieurs unités, demandez l'once troy une fois et convertissez localement au lieu de faire une requête par unité. Les facteurs sont exacts :

const GRAMS_PER_TROY_OZ = 31.1034768;

const res = await fetch("https://metalapi.com/api/v1/latest?currencies=XAG", {
  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}`);

const perOz = data.rates[`${data.base}XAG`]; // 53.94 dans l'exemple de la documentation
const perGram = perOz / GRAMS_PER_TROY_OZ; // 1.7342...
const perKg = perGram * 1000; // 1734.21...

console.log({ perOz, perGram: perGram.toFixed(4), perKg: perKg.toFixed(2) });

Onces troy, grammes et kilogrammes liste tous les facteurs, y compris le pennyweight, ainsi que les règles d'arrondi pour les factures.

Le prix de l'argent dans d'autres devises

Définissez base pour coter l'argent dans une autre devise : base=EUR renvoie EURXAG, base=INR renvoie INRXAG. Combinée avec unit, cette requête renvoie des euros par gramme :

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

{
  "success": true,
  "timestamp": 1792765800,
  "date": "2026-10-23",
  "base": "EUR",
  "unit": "gram",
  "rates": {
    "XAG": 0.6713138244,
    "EURXAG": 1.489616277
  }
}

Pour afficher l'argent dans plusieurs devises, une seule requête suffit encore. Demandez l'argent et les devises avec la base USD, puis divisez : l'argent en euros vaut USDXAG ÷ USDEUR, car USDEUR est le prix d'un euro en dollars. Toutes les valeurs proviennent du même instantané : le résultat correspond donc à ce que renvoie base=EUR. Avec le taux d'exemple de la documentation, 1,1642 dollar par euro, 53,94 ÷ 1,1642 donne 46,33 euros l'once troy, soit 1,4896 euro le gramme, comme ci-dessus :

import os

import requests

GRAMS_PER_TROY_OZ = 31.1034768
CURRENCIES = ["EUR", "GBP", "INR", "TRY"]

resp = requests.get(
    "https://metalapi.com/api/v1/latest",
    params={"base": "USD", "currencies": ",".join(["XAG", *CURRENCIES])},
    headers={"X-API-Key": os.environ["METALAPI_KEY"]},
    timeout=10,
)
data = resp.json()
if not data["success"]:
    err = data["error"]
    raise RuntimeError(f"MetalAPI {err['code']} ({err['type']}): {err['info']}")

rates = data["rates"]
silver_usd = rates["USDXAG"]
for cur in ["USD", *CURRENCIES]:
    per_oz = silver_usd if cur == "USD" else silver_usd / rates["USD" + cur]
    print(f"{cur}: {per_oz:,.2f} per troy oz, {per_oz / GRAMS_PER_TROY_OZ:,.4f} per gram")

Les 57 devises prises en charge fonctionnent toutes ainsi, tout comme l'or, le platine et le palladium : un seul appel peut alimenter tout un tableau de prix. En Inde, où l'argent se cote généralement au kilogramme, base=INR&unit=kilogram donne directement le chiffre habituel.

Cours historiques de l'argent par API

L'historique de l'argent commence en 2000 et utilise les mêmes paramètres et le même format de réponse que le prix en direct. Les valeurs de chaque jour sont les cours de clôture de ce jour, avec des dates en UTC. Quatre endpoints couvrent la plupart des besoins :

• /YYYY-MM-DD, /historical?date= ou /yesterday : la clôture d'un jour. Pour un week-end ou un jour férié, c'est la clôture du dernier jour de cotation qui est renvoyée.
• /timeframe : les clôtures quotidiennes entre start_date et end_date, jusqu'à 30 jours par requête sur Free et 365 jours sur les plans payants.
• /change : prix de départ, prix de fin, variation absolue et en pourcentage entre deux dates.
• /ohlc : ouverture, plus haut, plus bas et clôture d'un jour.

# L'argent à la clôture du 15 janvier 2024 (USDXAG 23.162 dans l'exemple de la documentation)
curl "https://metalapi.com/api/v1/2024-01-15?currencies=XAG" \
  -H "X-API-Key: $METALAPI_KEY"

# Clôtures quotidiennes de l'argent en euros par gramme pour septembre 2026
curl "https://metalapi.com/api/v1/timeframe?start_date=2026-09-01&end_date=2026-09-30&base=EUR&currencies=XAG&unit=gram" \
  -H "X-API-Key: $METALAPI_KEY"

# Valeur en euros de 500 grammes d'argent à la clôture du 1er octobre 2026
curl "https://metalapi.com/api/v1/convert?from=XAG&to=EUR&amount=500&unit=gram&date=2026-10-01" \
  -H "X-API-Key: $METALAPI_KEY"

Les cours de clôture des jours passés ne changent jamais : stockez-les au lieu de les redemander. Avec la limite de 365 jours des plans payants, un rattrapage complet depuis 2000 demande une requête /timeframe par année. Gardez à l'esprit que les prix des métaux antérieurs à octobre 2026 sont dérivés des contrats à terme de première échéance : ils peuvent donc légèrement différer du spot du même jour.

Cours historiques de l'or et de l'argent par API propose un script de rattrapage complet, des conseils de stockage et de validation, ainsi qu'un graphique de l'or avec le ratio or/argent.

Cas d'usage d'une API du cours de l'argent

Négociants en métaux précieux et en pièces. Les négociants vendent au-dessus du spot et rachètent en dessous. Un prix de vente typique correspond au prix spot par once troy multiplié par la teneur en argent fin, plus une prime produit et des frais fixes par article. Stockez la prime par produit, rafraîchissez le spot à l'intervalle de mise à jour de votre plan et indiquez aux clients quand le prix a été mis à jour pour la dernière fois. À partir du plan Standard, ajoutez XAG-BID et XAG-ASK à currencies pour coter les deux côtés à partir du spread du marché lui-même. Spot, bid et ask expliqués montre comment les négociants transforment ces chiffres en prix d'achat et de vente.

Argenterie, bijoux et rachat de vieil argent. Les objets en argent sont évalués selon leur poids et leur titre, la part d'argent pur exprimée en millièmes. Les titres courants sont 999 (argent fin), 958 (Britannia), 925 (sterling) et 800, que l'on trouve dans l'argenterie ancienne d'Europe continentale. La valeur de fonte est égale au poids en grammes × le titre × le prix au gramme. Au prix d'exemple de 1,7342 dollar le gramme, un plateau de 500 grammes en argent sterling contient 462,5 grammes d'argent, d'une valeur d'environ 802,07 dollars. Les acheteurs de vieil argent paient un pourcentage de la valeur de fonte : faites donc de ce pourcentage un paramètre plutôt qu'une constante.

L'endpoint de carats de MetalAPI, /carat, ne couvre que l'or : le titre de l'argent se calcule donc de votre côté :

const GRAMS_PER_TROY_OZ = 31.1034768;

/** Valeur de fonte d'un objet en argent : poids en grammes × titre (p. ex. 0.925) × prix au gramme. */
export function meltValue(grams, fineness, pricePerTroyOz) {
  return grams * fineness * (pricePerTroyOz / GRAMS_PER_TROY_OZ);
}

meltValue(500, 0.925, 53.94); // 802.07…  plateau en argent sterling au prix d'exemple
meltValue(1000, 0.999, 53.94); // 1732.48… lingot d'un kilogramme d'argent 999

Applications d'investissement et de suivi de portefeuille. Les utilisateurs détiennent des pièces, des médailles et des lingots d'un kilo, et veulent en connaître la valeur dans leur propre devise. Stockez les avoirs en onces troy en interne, convertissez l'unité saisie une seule fois et valorisez le portefeuille avec la devise de l'utilisateur comme base. /change renvoie la variation en pourcentage entre deux dates pour des lignes comme « l'argent ce mois-ci », et les clôtures quotidiennes stockées à partir de /timeframe alimentent les graphiques.

Alertes de prix. Si vous avez seulement besoin de réagir quand l'argent franchit un seuil, les alertes de prix peuvent surveiller XAG dans n'importe quelle devise et vous prévenir par e-mail à partir du plan Lite, ou par webhook signé à partir du plan Advanced, sans aucun polling de votre côté.

Fraîcheur, quotas et plans

La fraîcheur du cours de l'argent dépend du plan. Interroger l'API plus souvent que l'intervalle de mise à jour de votre plan ne renvoie que les mêmes chiffres :

• Mettez en cache au moins pendant votre intervalle de mise à jour. Sur Free, une requête par jour suffit pour les prix actuels.
• Demandez tous les métaux en un seul appel. currencies=XAU,XAG,XPT,XPD coûte une requête ; quatre appels séparés en coûtent quatre.
• Gardez la clé sur le serveur. Servez des prix en cache à vos pages au lieu d'appeler l'API depuis le navigateur de chaque visiteur.
• Consultez votre consommation gratuitement. /usage et /symbols ne sont jamais décomptés du quota, et chaque réponse contient un bloc rate_limit.

Prêt à vous lancer ? Créez un compte gratuit pour obtenir une clé API en une minute, sans carte bancaire. Comparez les intervalles de mise à jour et les quotas sur la page des tarifs, et utilisez la documentation de l'API comme référence pour chaque endpoint et paramètre.

Questions fréquentes

Quel est le symbole de l'argent dans une API de prix ?

XAG, le code ISO 4217 d'une once troy d'argent. Dans MetalAPI, le prix de l'argent dans votre devise de base est la clé qui réunit les deux codes, comme USDXAG pour des dollars par once ou EURXAG pour des euros par once.

Existe-t-il une API gratuite du cours de l'argent ?

Oui. Le plan Free de MetalAPI inclut l'argent, tous les autres symboles et tout l'historique, avec 100 requêtes par mois et des prix mis à jour quotidiennement, sans carte bancaire. Les plans payants commencent à 4,99 $ par mois pour des mises à jour toutes les 30 minutes et 1 000 requêtes.

Comment obtenir le prix de l'argent au gramme ?

Passez unit=gram, ou divisez le prix par once troy par 31,1034768. Ne divisez pas par 28,35 : c'est l'once avoirdupois, qui surestime le prix au gramme d'environ 9,7 %.

Jusqu'où remontent les cours historiques de l'argent ?

Les prix quotidiens de l'argent sont disponibles à partir de 2000 sur tous les plans. Une seule requête sur une période couvre jusqu'à 30 jours sur Free et jusqu'à 365 jours sur les plans payants.

Pourquoi le prix de l'argent d'un négociant diffère-t-il du prix de l'API ?

L'API renvoie le prix spot mid du marché de gros. Les négociants ajoutent des primes pour la frappe, la distribution et leur marge lorsqu'ils vendent, et paient moins que le spot lorsqu'ils rachètent : les prix de détail des pièces et des lingots se situent donc au-dessus du spot, et les prix de rachat en dessous.