Comment choisir une API de prix des métaux précieux : 12 questions à poser

Pourquoi une checklist est utile

La plupart des API de prix des métaux précieux se ressemblent sur leur page d'accueil : or et argent en temps réel, de nombreuses devises, des réponses JSON et une offre gratuite. Les différences qui comptent apparaissent plus tard : quand un tableau de bord affiche un prix périmé pendant un week-end, quand un client demande pourquoi votre prix au gramme diffère de celui d'un négociant, quand le quota mensuel est épuisé dès le 20 du mois, ou quand votre service juridique demande si vous avez seulement le droit de montrer ces données à vos clients.

Cette checklist rassemble douze questions auxquelles il vaut la peine de répondre avant de vous engager. Elles s'appliquent à n'importe quel fournisseur et conviennent aussi bien à un projet du week-end qu'à un appel d'offres formel. Vous trouverez plus bas un modèle de comparaison à copier et une courte liste de tests pratiques. Cet article étant publié par MetalAPI, la dernière section donne nos propres réponses ; tout ce qui précède se veut utile quel que soit le fournisseur que vous choisirez.

Données : sources, fraîcheur et historique

1. D'où viennent les prix ? Les prix des métaux précieux peuvent provenir de plusieurs types de sources : cotations de banques et de fournisseurs de liquidité sur le marché au comptant de gré à gré, contrats à terme cotés en bourse comme l'or du COMEX, prix de référence officiels comme ceux des enchères de la LBMA, ou encore un autre agrégateur. Aucune de ces sources n'est fausse, mais elles donnent des chiffres différents. Demandez quelle source alimente chaque symbole, si plusieurs sources sont combinées et comment, et comment les cotations manifestement aberrantes sont filtrées. Si un fournisseur ne sait pas dire ce que représente son prix de l'or (cours moyen au comptant, contrat à terme ou prix de référence), vous ne pourrez pas non plus l'expliquer à vos propres utilisateurs.

2. Quelle est la fraîcheur des données sur le plan que vous paierez réellement ? Le « temps réel » annoncé en page d'accueil décrit souvent l'offre la plus chère. Vérifiez l'intervalle de mise à jour de chaque plan, et vérifiez que chaque réponse porte l'horodatage des données elles-mêmes, et pas seulement celui de votre requête. Demandez ce qui se passe en dehors des heures de marché : les métaux au comptant cessent de s'échanger du vendredi soir au dimanche soir, heure de New York, et une bonne API indique clairement qu'un prix affiché le week-end est la clôture du vendredi.

3. Quelle est la profondeur de l'historique, et de quoi est-il fait ? Vérifiez la date de début pour chaque classe d'actifs, si vous n'obtenez que les clôtures quotidiennes ou aussi l'ouverture, le plus haut, le plus bas et la clôture, et comment la « clôture » est définie (quel fuseau horaire, quelle source). Demandez si l'historique ancien provient d'une autre source que les prix actuels, par exemple des cours de règlement de contrats à terme avant une certaine date, car cela peut créer de petites discontinuités sur un graphique de longue période. Enfin, vérifiez combien de jours une seule requête de plage peut couvrir.

Adéquation : unités, devises et bid/ask

4. Quelles unités et quelles devises sont prises en charge ? Les métaux précieux s'échangent à l'once troy, mais vos utilisateurs raisonnent peut-être en grammes ou en kilogrammes, et dans leur propre devise. Un paramètre d'unité vous évite de faire chaque conversion vous-même ; vérifiez comment l'API nomme les unités, car l'once troy (31,103 g) et l'once avoirdupois (28,35 g) diffèrent de près de 10 %. Si vous avez besoin de taux croisés, comme l'or en livres turques ou l'argent en yens, vérifiez qu'ils sont calculés à partir d'un même instantané cohérent. Les usages en bijouterie peuvent aussi nécessiter des prix par carat.

5. Avez-vous besoin du bid et de l'ask, ou un prix moyen suffit-il ? Les graphiques et les valorisations utilisent normalement le prix moyen. Les boutiques de négociants, les calculateurs de rachat et les outils de trading ont généralement besoin des deux côtés de la cotation. Demandez si le bid et l'ask sont proposés, pour quels symboles et sur quels plans, et s'ils proviennent du même instantané que le prix moyen. Si ces termes sont nouveaux pour vous, notre article sur le spot, le bid, l'ask et le spread les explique.

Exploitation : fiabilité, limites et erreurs

6. Quelle est sa fiabilité, et comment le sauriez-vous ? Cherchez une page de statut publique qui couvre les sources de données autant que l'API, ainsi qu'un historique des incidents. Demandez ce qui se passe quand une source en amont tombe en panne : le fournisseur bascule-t-il sur une autre source, signale-t-il les données comme périmées, ou continue-t-il de servir le dernier prix sans le dire ? Si la disponibilité compte pour vous sur le plan contractuel, vérifiez quels plans incluent un accord de niveau de service (SLA) et ce qu'il couvre exactement.

7. Quelles sont les limites de débit et les quotas, et qu'est-ce qui est décompté ? La plupart des fournisseurs combinent un quota mensuel de requêtes avec une limite par minute ou par seconde. Les détails pèsent davantage sur le coût que les chiffres mis en avant. Une requête portant sur vingt symboles compte-t-elle pour un appel ou pour vingt ? Les requêtes en échec sont-elles facturées ? Certains endpoints sont-ils gratuits ? Que se passe-t-il à la limite : blocage jusqu'à la période suivante, frais de dépassement automatiques ou ralentissement ? Confrontez votre consommation réelle à chaque plan ; une requête par minute, 24 h/24, représente environ 43 200 requêtes par mois.

8. Comment les erreurs sont-elles signalées ? Une bonne API renvoie un statut HTTP pertinent accompagné d'un code d'erreur lisible par une machine et d'un message lisible par un humain, documente chaque code et vous indique quand réessayer, par exemple avec un en-tête Retry-After sur les limites de débit. Vérifiez que le format des erreurs est le même d'un endpoint à l'autre et qu'une spécification lisible par machine, comme OpenAPI, est disponible pour générer des clients et des tests.

Aspects commerciaux : tarifs, sécurité et conditions

9. Le modèle tarifaire correspond-il à votre usage ? Comparez les forfaits mensuels, la facturation à l'appel et les contrats sur mesure en partant de votre propre volume prévu, et non des exemples du fournisseur. Vérifiez ce que comprend réellement l'offre gratuite (intervalle de mise à jour, endpoints), si la facturation annuelle change le prix, si des taxes s'ajoutent et comment fonctionne la résiliation. Les gros écarts entre paliers comptent si votre usage se situe près d'un seuil.

10. Comment les clés API sont-elles protégées ? Demandez si les clés peuvent être envoyées dans un en-tête plutôt qu'uniquement dans l'URL, car les URL finissent dans les logs. Vérifiez si vous pouvez détenir plusieurs clés et les renouveler sans interruption de service, et si le fournisseur stocke les clés sous forme hachée. Si vous avez besoin des prix dans un navigateur, cherchez des clés restreintes par domaine ou un widget intégrable qui évite complètement d'exposer une clé : une clé placée dans du JavaScript public peut être copiée par n'importe qui.

11. Que permettent les conditions d'utilisation ? Lisez la licence des données avant de développer. Pouvez-vous afficher les prix à vos propres clients ? Pouvez-vous stocker l'historique dans votre base de données ? La redistribution, par exemple via votre propre API, est-elle autorisée, et sinon, une licence est-elle disponible pour cela ? Une mention de la source est-elle exigée ? Les prix de référence officiels comme ceux de la LBMA sont gérés par des administrateurs d'indices de référence et font généralement l'objet de licences distinctes : demandez donc si un flux contient des données de référence et ce que cela implique pour vous. Vérifiez aussi l'avertissement : les données de prix sont normalement fournies à titre d'information, et non comme une offre de transaction.

Pérennité : prise en charge de l'IA et du MCP

12. Les assistants et agents IA peuvent-ils l'utiliser ? Une part croissante de l'analyse se fait désormais dans des assistants conversationnels et des agents de code. Le Model Context Protocol (MCP) est un standard ouvert qui permet de les connecter à des outils et à des données, et un fournisseur doté d'un serveur MCP permet à un assistant de récupérer de vrais prix au lieu de les deviner à partir de ses données d'entraînement. Questions à poser :

• Existe-t-il un serveur MCP hébergé, et quels transports et clients prend-il en charge ?
• Comment s'authentifie-t-on : connexion OAuth pour les applications de chat, clé API pour les outils de développement, ou les deux ?
• Quels outils sont en lecture seule, et ceux qui modifient quelque chose demandent-ils d'abord une confirmation ?
• Les appels de l'assistant sont-ils décomptés du même quota, et le serveur peut-il vous facturer quoi que ce soit de lui-même ?
• Existe-t-il une documentation écrite pour les modèles de langage, comme un fichier llms.txt ou une spécification OpenAPI, afin qu'un assistant de code puisse écrire correctement votre intégration ?

Même si vous n'utilisez pas d'outils d'IA aujourd'hui, les réponses en disent long sur la modernité d'une API et la qualité de sa documentation.

Un modèle de comparaison à remplir

Copiez ce tableau dans un tableur ou un document et remplissez une colonne par fournisseur. Notez la provenance de chaque réponse (page de documentation, réponse du support ou votre propre test) pour pouvoir la revérifier plus tard.

Les réponses sur le papier sont un début, mais un court test pratique tranche la plupart des questions. Avec une clé gratuite ou d'essai pour chaque candidat :

1. Demandez les mêmes symboles au même moment à chaque fournisseur et comparez les valeurs, les horodatages et les unités.
2. Répétez la requête un samedi et observez comment chaque API représente un marché fermé.
3. Provoquez volontairement des erreurs (une mauvaise clé, un symbole inconnu, une date future) et vérifiez les codes de statut et les messages.
4. Demandez un an d'historique quotidien et cherchez les trous, les pics et un changement de niveau visible là où une source a pu changer.
5. Mesurez la latence depuis l'endroit où tournent vos serveurs, et non depuis votre ordinateur portable.

Ce petit script aide pour le premier et le dernier point. Adaptez l'URL, l'en-tête d'authentification et le champ d'horodatage à la documentation de chaque fournisseur, et n'oubliez pas que chaque appel consomme du quota :

// Appelle un endpoint plusieurs fois et relève le statut HTTP, la latence et l'âge des données.
const TARGET = process.env.PRICE_API_URL;
const HEADERS = { Authorization: "Bearer " + process.env.PRICE_API_KEY };

for (let i = 0; i < 5; i++) {
  const started = Date.now();
  const res = await fetch(TARGET, { headers: HEADERS });
  const body = await res.json().catch(() => ({}));
  const latencyMs = Date.now() - started;

  // Beaucoup d'API renvoient des secondes Unix ; adaptez cette ligne au champ du fournisseur.
  const dataTime = typeof body.timestamp === "number" ? body.timestamp * 1000 : null;
  const dataAgeSeconds = dataTime ? Math.round((Date.now() - dataTime) / 1000) : "n/a";

  console.log({ status: res.status, latencyMs, dataAgeSeconds });
  await new Promise((resolve) => setTimeout(resolve, 2000));
}

Les réponses de MetalAPI à ces questions

Par souci d'exhaustivité, voici nos propres réponses, limitées à des faits que vous pouvez vérifier dans notre documentation. Soyez aussi exigeant avec nous qu'avec les autres.

1. Sources : métaux précieux au comptant et principales devises issus de flux interbancaires bid/ask ; métaux industriels et énergie issus des contrats à terme de première échéance du COMEX, du NYMEX et de l'ICE ; cryptomonnaies issues de Kraken et Binance ; taux de référence de la Banque centrale européenne pour les devises. Les sources multiples sont combinées par la médiane et contrôlées pour écarter les cotations aberrantes.
2. Fraîcheur : quotidienne sur Free, toutes les 30 minutes sur Lite, 10 minutes sur Standard, 1 minute sur Advanced et Pro, 15 secondes sur Ultra et Business et 5 secondes sur Enterprise. Chaque réponse porte le timestamp des données ; le week-end, les prix des métaux, des devises et des contrats à terme restent à la clôture du vendredi.
3. Historique : ouverture, plus haut, plus bas et clôture quotidiens pour les devises depuis 1999, les métaux et l'énergie depuis 2000 et les cryptomonnaies depuis 2014. L'historique des métaux antérieur à octobre 2026 repose sur les cours de règlement des contrats à terme de première échéance. Une requête de plage couvre jusqu'à 30 jours sur Free et 365 jours sur les plans payants.
4. Unités et devises : sept unités de masse, du gramme à la tonne courte (short ton), 57 devises et n'importe quel symbole comme base, avec des taux croisés issus d'un même instantané. Prix de l'or par carat sur les plans payants.
5. Bid/ask : symboles du type XAU-BID et XAU-ASK à partir du plan Standard, pour les métaux précieux et les principales devises, issus du même instantané que le prix moyen.
6. Fiabilité : une page de statut publique qui montre les sources de données, la latence et le volume de l'API, y compris lorsque des sources de secours sont utilisées ; un SLA de disponibilité sur les plans Business et Enterprise.
7. Limites : un quota mensuel et une limite par minute sur chaque plan. Une requête compte une seule fois, quel que soit le nombre de symboles renvoyés ; /symbols et /usage sont gratuits ; les requêtes rejetées pour cause de limite de débit, de restriction de plan, de contrôle d'origine ou d'erreur serveur ne sont pas facturées. Une fois le quota atteint, les requêtes renvoient l'erreur 105 jusqu'au 1er du mois (UTC) ou jusqu'à un passage à un plan supérieur ; il n'y a aucuns frais de dépassement automatiques.
8. Erreurs : un statut HTTP accompagné d'un code numérique, d'un type et d'un message info en JSON, Retry-After sur les limites de débit, une liste documentée des codes et une spécification OpenAPI 3.1.
9. Tarifs : des forfaits allant de Free (0 $, 100 requêtes par mois) à Enterprise (299,99 $, 1,5 million de requêtes), en passant par Lite (4,99 $), Standard (11,99 $), Advanced (24,99 $), Pro (49,99 $), Ultra (99,99 $) et Business (149,99 $), facturés mensuellement ou annuellement et résiliables depuis la page de facturation. Détails sur la page des tarifs.
10. Sécurité : les clés ne sont stockées que sous forme de hash et peuvent être envoyées dans un en-tête ; selon le plan, vous pouvez détenir plusieurs clés, les renouveler ou les révoquer, et les restreindre à vos propres domaines. Les widgets intégrables affichent les prix sans exposer de clé.
11. Conditions : vous pouvez utiliser les données dans vos propres sites web, applications, systèmes internes et rapports, y compris pour afficher les prix à vos utilisateurs ; redistribuer le flux brut, par exemple sous la forme de votre propre API, nécessite un accord écrit distinct. Les données sont fournies à titre d'information et ne constituent pas un conseil en investissement. Consultez les conditions d'utilisation.
12. IA et MCP : un serveur MCP hébergé à l'adresse https://metalapi.com/mcp (Streamable HTTP, OAuth 2.1 ou clé API) avec 13 outils, dont 11 en lecture seule ; les deux qui modifient quelque chose demandent d'abord confirmation, et le serveur ne facture jamais rien. Il est référencé dans le MCP Registry officiel, et llms.txt ainsi que la spécification OpenAPI sont publiés. Voir IA & MCP.

Quel que soit le fournisseur choisi, faites les tests pratiques ci-dessus avec vos propres symboles et votre propre profil d'utilisation. Si MetalAPI figure sur votre liste, un compte gratuit suffit pour la plupart d'entre eux, et la documentation de l'API couvre le reste.