Bien démarrer avec MetalAPI

Introduction

MetalAPI est une API REST JSON pour les métaux précieux au comptant, les métaux industriels, l'énergie, environ 55 devises et 13 cryptomonnaies. Elle fournit des cotations en temps réel, un historique quotidien remontant à 1999, des conversions, des barres OHLC et les prix de l'or par carat.

Chaque endpoint est une simple requête HTTPS GET sous https://metalapi.com/api/v1 : il fonctionne donc avec n'importe quel langage ou client HTTP. Ce guide vous accompagne de l'inscription à votre première réponse en quelques minutes.

Obtenir votre clé API

Créez un compte gratuit avec votre adresse e-mail. Aucune carte bancaire n'est requise. Le plan Free comprend 100 requêtes par mois avec des prix mis à jour quotidiennement, ce qui suffit pour essayer l'API.

Ouvrez API keys dans le tableau de bord et créez une clé. Les clés commencent par mk_live_, suivi de 32 caractères. Nous ne conservons qu'un hash de chaque clé : la clé complète n'est donc affichée qu'une seule fois. Copiez-la immédiatement dans votre gestionnaire de mots de passe ou dans vos variables d'environnement.

Envoyer votre première requête

Demandez les derniers prix des quatre métaux précieux en dollars américains. Remplacez YOUR_API_KEY par votre clé :

curl "https://metalapi.com/api/v1/latest?api_key=YOUR_API_KEY&base=USD&currencies=XAU,XAG,XPT,XPD"

Comprendre la réponse

base est la devise dans laquelle les prix sont exprimés (USD par défaut). currencies limite la réponse aux symboles dont vous avez besoin. Omettez-le pour recevoir tous les symboles en une seule réponse. Un appel réussi renvoie un JSON de ce type :

{
  "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
  },
  "rate_limit": {
    "limit": 100,
    "remaining": 99,
    "reset": 1793491200,
    "used": 1,
    "plan": "Free",
    "reset_date": "2026-11-01T00:00:00.000Z"
  }
}

Chaque symbole apparaît deux fois. USDXAU est le prix d'une once troy d'or dans la devise de base : c'est généralement la valeur à afficher. XAU en est l'inverse, c'est-à-dire le nombre d'onces troy qu'achète un dollar américain. Le guide des formats de données explique les deux sens en détail.

Le bloc rate_limit, également envoyé dans les en-têtes X-RateLimit-*, indique la part restante de votre quota mensuel et la date de sa réinitialisation.

L'appeler depuis votre code

Voici la même requête en JavaScript (Node.js 18+, Deno ou Bun). Cette fois, la clé est envoyée dans un en-tête plutôt que dans l'URL :

const res = await fetch("https://metalapi.com/api/v1/latest?currencies=XAU,XAG", {
  headers: { Authorization: `Bearer ${process.env.METALAPI_KEY}` },
});
const data = await res.json();

if (!data.success) throw new Error(`${data.error.code}: ${data.error.info}`);
console.log("Gold, USD per troy ounce:", data.rates.USDXAU);

Étapes suivantes

• Authentification : clés envoyées dans un en-tête et clés restreintes par domaine pour une utilisation dans le navigateur.
• Endpoints disponibles : taux historiques, conversion, séries temporelles, OHLC et prix par carat.
• Limites de débit et plans : quotas, limites par minute et intervalles de mise à jour.
• Gestion des erreurs : codes d'erreur et stratégie raisonnable de nouvelles tentatives.