Endpoints disponibles

URL de base et paramètres communs

Tous les endpoints sont des requêtes GET sous https://metalapi.com/api/v1 et nécessitent une clé API (voir Authentification). La plupart acceptent les mêmes paramètres facultatifs :

• base : la devise dans laquelle les prix sont exprimés. USD par défaut ; tout symbole pris en charge est accepté.
• currencies, ou son alias symbols : une liste de symboles à renvoyer, séparés par des virgules, comme XAU,XAG,EUR. Omettez-le pour obtenir tous les symboles.
• unit : l'unité de masse des prix des métaux. L'une des valeurs troy_oz (par défaut), gram, kilogram, ounce, pound, metric_ton ou short_ton.

Les dates sont au format YYYY-MM-DD et interprétées en UTC.

Derniers taux : /latest

Prix actuels selon l'intervalle de mise à jour de votre plan, d'une fois par jour sur Free à toutes les 5 secondes sur Enterprise. À partir du plan Standard, ajoutez des symboles comme XAU-BID et XAU-ASK à currencies pour recevoir les prix bid et ask.

GET https://metalapi.com/api/v1/latest?api_key=YOUR_API_KEY&base=USD&currencies=XAU,XAG,EUR

Taux historiques : /{date}

Prix de clôture d'un jour passé. Trois formes sont acceptées : la date dans le chemin, /historical?date= ou /yesterday.

GET /api/v1/2026-10-01?api_key=YOUR_API_KEY&currencies=XAU,XAG
GET /api/v1/historical?date=2026-10-01&api_key=YOUR_API_KEY&currencies=XAU,XAG
GET /api/v1/yesterday?api_key=YOUR_API_KEY&currencies=XAU,XAG

Conversion : /convert

Convertit amount de from en to, par exemple des dollars en onces d'or, ou une quantité d'argent en euros. Ajoutez date pour convertir à un prix de clôture historique, et unit pour convertir des grammes ou des kilogrammes d'un métal.

GET /api/v1/convert?api_key=YOUR_API_KEY&from=USD&to=XAU&amount=1000

# 500 grammes d'argent en euros à la clôture du 1er octobre 2026
GET /api/v1/convert?api_key=YOUR_API_KEY&from=XAG&to=EUR&amount=500&unit=gram&date=2026-10-01

Période : /timeframe

Prix de clôture quotidiens pour chaque jour entre start_date et end_date. Une requête peut couvrir jusqu'à 30 jours sur le plan Free et 365 jours sur les plans payants. Les plages plus longues renvoient l'erreur 207. /timeseries est un alias conservé pour la compatibilité.

GET /api/v1/timeframe?api_key=YOUR_API_KEY&start_date=2026-09-01&end_date=2026-09-30&currencies=XAU

Variation : /change

Le taux de départ, le taux de fin, la variation absolue et la variation en pourcentage entre deux dates, pour chaque symbole. Pratique pour des affichages du type « l'or a pris 3,6 % ce mois-ci ». Les limites de plage sont les mêmes que pour /timeframe.

GET /api/v1/change?api_key=YOUR_API_KEY&start_date=2026-09-30&end_date=2026-10-23&currencies=XAU,XAG

OHLC : /ohlc

Ouverture, plus haut, plus bas et clôture pour un seul jour. Omettez date, ou passez latest, pour obtenir la barre du jour en cours.

GET /api/v1/ohlc?api_key=YOUR_API_KEY&date=2026-10-22&currencies=XAU,XAG

Or par carat : /carat

Prix de l'or aux titres utilisés en bijouterie, de 24 à 8 carats, dans n'importe quelle devise et unité. Passez carat=24 (par défaut), un seul carat comme 18, ou carat=all. Les carats pris en charge sont 24, 23, 22, 21, 20, 18, 16, 14, 12, 10, 9 et 8. Ajoutez date pour obtenir des prix par carat historiques.

Cet endpoint est disponible sur les plans payants. Les clés Free reçoivent l'erreur 106.

GET /api/v1/carat?api_key=YOUR_API_KEY&carat=all&base=EUR&unit=gram

Symboles : /symbols

La liste des symboles pris en charge et de leurs noms. Ajoutez details=1 pour inclure la catégorie et l'unité de chaque symbole. Cet endpoint n'est pas décompté de votre quota mensuel.

GET /api/v1/symbols?api_key=YOUR_API_KEY&details=1

Consommation : /usage

Les requêtes utilisées et restantes pour le mois de facturation en cours. Cet appel est lui aussi gratuit : vous pouvez donc l'utiliser depuis vos outils de supervision sans consommer de quota.

GET /api/v1/usage?api_key=YOUR_API_KEY

Flux en temps réel : /stream

Un flux Server-Sent Events qui transmet les mises à jour de prix dès qu'elles se produisent, sans que vous ayez à interroger /latest en boucle. Disponible à partir du plan Pro. La documentation du streaming décrit le format des événements.

curl -N "https://metalapi.com/api/v1/stream" \
  -H "Authorization: Bearer YOUR_API_KEY"