Cómo elegir una API de precios de metales preciosos: 12 preguntas clave

Por qué ayuda una lista de comprobación

La mayoría de las API de precios de metales preciosos se parecen en sus páginas de inicio: oro y plata en tiempo real, muchas divisas, respuestas JSON y un plan gratuito. Las diferencias importantes aparecen más tarde, cuando un panel muestra un precio desactualizado durante un fin de semana, un cliente pregunta por qué tu precio por gramo no coincide con el de un comerciante, la cuota mensual se agota el día 20 o tu equipo legal pregunta si puedes mostrar esos datos a tus clientes.

Esta lista reúne doce preguntas que conviene responder antes de comprometerte. Sirven para cualquier proveedor y valen tanto para un proyecto de fin de semana como para un proceso formal de compras. Más abajo encontrarás una plantilla de comparación para copiar y una breve lista de pruebas prácticas. Como este artículo lo publica MetalAPI, la última sección recoge nuestras propias respuestas; todo lo anterior pretende ser útil sea cual sea el proveedor que elijas.

Datos: fuentes, actualidad e historial

1. ¿De dónde salen los precios? Los precios de los metales preciosos pueden proceder de varios tipos de fuente: cotizaciones de bancos y proveedores de liquidez en el mercado spot extrabursátil (OTC), futuros de bolsa como el oro de COMEX, referencias oficiales como los precios de la subasta de la LBMA u otro agregador. Ninguna es incorrecta, pero son números distintos. Pregunta qué fuente alimenta cada símbolo, si se combinan varias fuentes y cómo, y cómo se filtran los ticks claramente erróneos. Si un proveedor no sabe decir qué representa su precio del oro (precio medio spot, futuros o referencia), tú tampoco podrás explicárselo a tus usuarios.

2. ¿Qué tan recientes son los datos en el plan que realmente vas a pagar? El "tiempo real" de una página de inicio suele referirse al plan más alto. Comprueba el intervalo de actualización de cada plan y que cada respuesta incluya la marca de tiempo de los propios datos, no solo la de tu solicitud. Pregunta qué ocurre fuera del horario de mercado: los metales al contado dejan de cotizar desde el viernes por la tarde hasta el domingo por la tarde, hora de Nueva York, y una buena API deja claro que el precio del fin de semana es el cierre del viernes.

3. ¿Cuánto historial hay y de qué está hecho? Comprueba la fecha de inicio de cada clase de activo, si solo obtienes cierres diarios o apertura, máximo, mínimo y cierre, y cómo se define el "cierre" (qué zona horaria, qué fuente). Pregunta si el historial más antiguo procede de una fuente distinta a la de los precios actuales, como las liquidaciones de futuros antes de cierta fecha, porque eso puede crear pequeñas discontinuidades en un gráfico largo. Por último, comprueba cuántos días puede abarcar una sola solicitud de rango.

Encaje: unidades, divisas y bid/ask

4. ¿Qué unidades y divisas se admiten? Los metales preciosos cotizan por onza troy, pero tus usuarios pueden pensar en gramos o kilogramos, y en su propia moneda. Un parámetro de unidad te evita hacer cada conversión por tu cuenta; fíjate en cómo nombra la API las unidades, porque la onza troy (31,103 g) y la onza avoirdupois (28,35 g) difieren en casi un 10 %. Si necesitas tipos cruzados, como el oro en liras turcas o la plata en yenes, comprueba que se calculan a partir de una misma instantánea coherente. Los casos de uso de joyería también pueden necesitar precios por quilate.

5. ¿Necesitas bid y ask, o basta con un precio medio? Los gráficos y las valoraciones suelen usar el precio medio. Las tiendas de comerciantes, las calculadoras de recompra y las herramientas de trading suelen necesitar ambos lados de la cotización. Pregunta si se ofrecen bid y ask, para qué símbolos y en qué planes, y si proceden de la misma instantánea que el precio medio. Si estos términos son nuevos para ti, nuestro artículo sobre spot, bid, ask y spread los explica.

Operación: fiabilidad, límites y errores

6. ¿Qué tan fiable es y cómo lo sabrías? Busca una página de estado pública que cubra tanto las fuentes de datos como la API, y algún historial de incidencias. Pregunta qué ocurre cuando falla una fuente: ¿el proveedor recurre a otra fuente, marca los datos como desactualizados o sigue sirviendo el último precio sin decir nada? Si la disponibilidad te importa contractualmente, comprueba qué planes incluyen un acuerdo de nivel de servicio (SLA) y qué cubre exactamente.

7. ¿Cuáles son los límites y las cuotas, y qué cuenta? La mayoría de los proveedores combinan una cuota mensual de solicitudes con un límite por minuto o por segundo. Los detalles cambian la economía más que las cifras de portada. ¿Una solicitud de veinte símbolos cuenta como una llamada o como veinte? ¿Se facturan las solicitudes fallidas? ¿Hay endpoints gratuitos? ¿Qué pasa al llegar al límite: un bloqueo total hasta el siguiente periodo, cargos automáticos por exceso o limitación de velocidad? Contrasta tu uso real con cada plan; una solicitud por minuto, las 24 horas, son unas 43.200 solicitudes al mes.

8. ¿Cómo se comunican los errores? Una buena API devuelve un estado HTTP significativo junto con un código de error legible por máquinas y un mensaje legible por personas, documenta cada código y te dice cuándo reintentar, por ejemplo con una cabecera Retry-After en los límites de velocidad. Comprueba que el formato de error es el mismo en todos los endpoints y que hay una especificación legible por máquinas, como OpenAPI, para generar clientes y pruebas.

Aspectos comerciales: precio, seguridad y condiciones

9. ¿El modelo de precios se ajusta a tu uso? Compara planes mensuales fijos, pago por llamada y contratos a medida con tu propio volumen previsto, no con los ejemplos del proveedor. Comprueba qué incluye realmente el plan gratuito (intervalo de actualización, endpoints), si la facturación anual cambia el precio, si se añaden impuestos y cómo funciona la cancelación. Los saltos grandes entre planes importan si tu uso está cerca de un límite.

10. ¿Cómo se protegen las claves API? Pregunta si las claves se pueden enviar en una cabecera y no solo en la URL, ya que las URL acaban en los logs. Comprueba si puedes tener varias claves y rotarlas sin interrupciones, y si el proveedor guarda las claves con hash. Si necesitas precios en un navegador, busca claves restringidas por dominio o un widget integrable que evite exponer cualquier clave: cualquiera puede copiar una clave que esté en JavaScript público.

11. ¿Qué permiten las condiciones? Lee la licencia de datos antes de desarrollar. ¿Puedes mostrar los precios a tus propios clientes? ¿Puedes guardar el historial en tu base de datos? ¿Se permite la redistribución, como ofrecer los datos a través de tu propia API, y si no, existe una licencia para ello? ¿Se exige atribución? Las referencias oficiales como los precios de la LBMA las gestionan administradores de índices de referencia y suelen licenciarse por separado, así que pregunta si un feed contiene datos de referencia y qué implica eso para ti. Revisa también el descargo de responsabilidad: los datos de precios suelen ofrecerse como información, no como una oferta para operar.

Preparado para el futuro: IA y compatibilidad con MCP

12. ¿Pueden usarla los asistentes y agentes de IA? Cada vez más análisis se hace en asistentes de chat y agentes de programación. El Model Context Protocol (MCP) es un estándar abierto para conectarlos a herramientas y datos, y un proveedor con un servidor MCP permite que un asistente obtenga precios reales en lugar de adivinarlos a partir de sus datos de entrenamiento. Preguntas que conviene hacer:

• ¿Hay un servidor MCP alojado y qué transportes y clientes admite?
• ¿Cómo se autentica: inicio de sesión OAuth para apps de chat, una clave API para herramientas de desarrollo, o ambas?
• ¿Qué herramientas son de solo lectura, y las que cambian algo piden confirmación antes?
• ¿Las llamadas del asistente cuentan para la misma cuota, y puede el servidor llegar a cobrarte algo por sí solo?
• ¿Hay documentación escrita para modelos de lenguaje, como un archivo llms.txt o una especificación OpenAPI, para que un asistente de programación pueda escribir tu integración correctamente?

Aunque hoy no uses herramientas de IA, las respuestas dicen algo sobre lo actual y lo bien documentada que está una API.

Una plantilla de comparación para rellenar

Copia esta tabla en una hoja de cálculo o un documento y rellena una columna por proveedor. Anota de dónde sale cada respuesta (página de documentación, respuesta del soporte o tu propia prueba) para poder comprobarla más adelante.

Las respuestas sobre el papel son un comienzo, pero una breve prueba práctica resuelve la mayoría. Con una clave gratuita o de prueba de cada candidato:

1. Solicita los mismos símbolos en el mismo momento a cada proveedor y compara valores, marcas de tiempo y unidades.
2. Repite la solicitud un sábado y observa cómo representa cada API un mercado cerrado.
3. Provoca errores a propósito (una clave incorrecta, un símbolo desconocido, una fecha futura) y comprueba los códigos de estado y los mensajes.
4. Solicita un año de historial diario y busca huecos, picos y un cambio de nivel visible donde podría haber cambiado la fuente.
5. Mide la latencia desde donde se ejecutan tus servidores, no desde tu portátil.

Este pequeño script ayuda con el primer y el último punto. Ajusta la URL, la cabecera de autenticación y el campo de la marca de tiempo según la documentación de cada proveedor, y recuerda que cada llamada consume cuota:

// Llama a un endpoint varias veces y registra el estado HTTP, la latencia y la antigüedad de los datos.
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;

  // Muchas API devuelven segundos Unix; adapta esta línea al campo del proveedor.
  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));
}

Cómo responde MetalAPI a estas preguntas

Para completar, estas son nuestras propias respuestas, limitadas a hechos que puedes comprobar en nuestra documentación. Exígenos el mismo nivel que a los demás.

1. Fuentes: metales preciosos al contado y divisas principales a partir de feeds interbancarios de bid/ask; metales industriales y energía a partir de futuros del mes más cercano de COMEX, NYMEX e ICE; criptomonedas de Kraken y Binance; tipos de referencia del Banco Central Europeo para las divisas. Las distintas fuentes se combinan mediante la mediana y se revisan para descartar ticks erróneos.
2. Actualidad: a diario en Free, cada 30 minutos en Lite, cada 10 minutos en Standard, cada minuto en Advanced y Pro, cada 15 segundos en Ultra y Business y cada 5 segundos en Enterprise. Cada respuesta incluye el timestamp de los datos; durante el fin de semana, los precios de metales, divisas y futuros se mantienen en el cierre del viernes.
3. Historial: apertura, máximo, mínimo y cierre diarios para divisas desde 1999, metales y energía desde 2000 y criptomonedas desde 2014. El historial de metales anterior a octubre de 2026 se basa en las liquidaciones de los futuros del mes más cercano. Una solicitud de rango abarca hasta 30 días en Free y 365 días en los planes de pago.
4. Unidades y divisas: siete unidades de masa, del gramo a la tonelada corta, 57 divisas y cualquier símbolo como base, con tipos cruzados calculados a partir de una misma instantánea. Precios del oro por quilate en los planes de pago.
5. Bid/ask: símbolos del tipo XAU-BID y XAU-ASK en Standard y superiores, para metales preciosos y divisas principales, de la misma instantánea que el precio medio.
6. Fiabilidad: una página de estado pública que muestra las fuentes de datos, la latencia y el volumen de la API, también cuando se usan fuentes de respaldo; un SLA de disponibilidad en los planes Business y Enterprise.
7. Límites: una cuota mensual más un límite por minuto en todos los planes. Una solicitud cuenta una sola vez, devuelva los símbolos que devuelva; /symbols y /usage son gratuitos; las solicitudes rechazadas por límites de velocidad, restricciones del plan, comprobaciones de origen o errores del servidor no se facturan. Al agotar la cuota, las solicitudes devuelven el error 105 hasta el día 1 del mes (UTC) o hasta que cambies de plan; no hay cargos automáticos por exceso.
8. Errores: un estado HTTP más un code numérico, un type y un mensaje info en JSON, Retry-After en los límites de velocidad, una lista documentada de códigos y una especificación OpenAPI 3.1.
9. Precio: planes fijos desde Free (0 USD, 100 solicitudes al mes), pasando por Lite (4,99 USD), Standard (11,99 USD), Advanced (24,99 USD), Pro (49,99 USD), Ultra (99,99 USD) y Business (149,99 USD), hasta Enterprise (299,99 USD, 1,5 millones de solicitudes), con facturación mensual o anual y cancelables desde la página de facturación. Más detalles en la página de precios.
10. Seguridad: las claves solo se almacenan como hash y pueden enviarse en una cabecera; según el plan, puedes tener varias claves, rotarlas o revocarlas y restringirlas a tus propios dominios. Los widgets integrables muestran precios sin exponer ninguna clave.
11. Condiciones: puedes usar los datos en tus propios sitios web, apps, sistemas internos e informes, incluido mostrar precios a tus usuarios; redistribuir el feed sin procesar, por ejemplo como tu propia API, requiere un acuerdo escrito aparte. Los datos se ofrecen a título informativo y no constituyen asesoramiento de inversión. Consulta las condiciones.
12. IA y MCP: un servidor MCP alojado en https://metalapi.com/mcp (Streamable HTTP, OAuth 2.1 o clave API) con 13 herramientas, 11 de ellas de solo lectura; las dos que cambian algo preguntan antes, y el servidor nunca cobra nada. Figura en el registro oficial de MCP (MCP Registry), y publicamos llms.txt y la especificación OpenAPI. Consulta IA y MCP.

Elijas el proveedor que elijas, haz las pruebas prácticas anteriores con tus propios símbolos y tu patrón de uso. Si MetalAPI está en tu lista, una cuenta gratuita basta para la mayoría de ellas, y la documentación de la API cubre el resto.