Primeros pasos con MetalAPI

Introducción

MetalAPI es una API REST JSON de metales preciosos al contado (spot), metales industriales, energía, unas 55 divisas y 13 criptomonedas. Ofrece cotizaciones en tiempo real, historial diario desde 1999, conversiones, barras OHLC y precios del oro por quilate.

Cada endpoint es una simple solicitud HTTPS GET bajo https://metalapi.com/api/v1, así que funciona desde cualquier lenguaje o cliente HTTP. Esta guía te lleva del registro a tu primera respuesta en pocos minutos.

Obtén tu clave API

Crea una cuenta gratuita con tu dirección de correo electrónico. No se necesita tarjeta de crédito. El plan Free incluye 100 solicitudes al mes con actualización diaria de precios, suficiente para probar la API.

Abre API keys en el panel y crea una clave. Las claves empiezan por mk_live_ seguido de 32 caracteres. Solo guardamos un hash de cada clave, por lo que la clave completa se muestra una sola vez. Cópiala de inmediato en tu gestor de contraseñas o en tus variables de entorno.

Haz tu primera solicitud

Solicita los últimos precios de los cuatro metales preciosos en dólares estadounidenses. Sustituye YOUR_API_KEY por tu clave:

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

Entiende la respuesta

base es la divisa en la que se expresan los precios (por defecto, USD). currencies limita la respuesta a los símbolos que necesitas. Si lo omites, recibirás todos los símbolos en una sola respuesta. Una llamada correcta devuelve un JSON como este:

{
  "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"
  }
}

Cada símbolo aparece dos veces. USDXAU es el precio de una onza troy de oro en la divisa base, que suele ser el número que quieres mostrar. XAU es el inverso: cuántas onzas troy se compran con un dólar estadounidense. La guía de formatos de datos explica ambas direcciones en detalle.

El bloque rate_limit, que también se envía en las cabeceras X-RateLimit-*, muestra cuánto te queda de tu cuota mensual y cuándo se restablece.

Llámala desde tu código

Esta es la misma solicitud desde JavaScript (Node.js 18+, Deno o Bun). Esta vez la clave se envía en una cabecera en lugar de en la 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);

Próximos pasos

• Autenticación: claves enviadas en cabeceras y claves restringidas por dominio para usarlas en el navegador.
• Endpoints disponibles: cotizaciones históricas, conversión, series temporales, OHLC y precios por quilate.
• Límites de solicitudes y planes: cuotas, límites por minuto e intervalos de actualización.
• Manejo de errores: códigos de error y una estrategia de reintentos sensata.