Endpoints disponibles

URL base y parámetros comunes

Todos los endpoints son solicitudes GET bajo https://metalapi.com/api/v1 y requieren una clave API (consulta Autenticación). La mayoría aceptan los mismos parámetros opcionales:

• base: la divisa en la que se expresan los precios. Por defecto es USD; sirve cualquier símbolo admitido.
• currencies, o su alias symbols: una lista separada por comas de los símbolos que se devolverán, como XAU,XAG,EUR. Omítelo para obtener todos los símbolos.
• unit: la unidad de masa de los precios de los metales. Uno de troy_oz (por defecto), gram, kilogram, ounce, pound, metric_ton o short_ton.

Las fechas usan el formato YYYY-MM-DD y se interpretan en UTC.

Últimas cotizaciones: /latest

Precios actuales según el intervalo de actualización de tu plan, desde una vez al día en Free hasta cada 5 segundos en Enterprise. En el plan Standard y superiores, añade símbolos como XAU-BID y XAU-ASK a currencies para recibir los precios de compra y venta (bid/ask).

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

Cotizaciones históricas: /{date}

Precios de cierre de un día pasado. Se aceptan tres formas: la fecha como ruta, /historical?date= o /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

Conversión: /convert

Convierte amount de from a to, por ejemplo, dólares a onzas de oro o plata a euros. Añade date para convertir a un precio de cierre histórico, y unit para convertir gramos o kilogramos de un metal.

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

# 500 gramos de plata en euros al cierre del 1 de octubre de 2026
GET /api/v1/convert?api_key=YOUR_API_KEY&from=XAG&to=EUR&amount=500&unit=gram&date=2026-10-01

Periodo: /timeframe

Precios de cierre diarios de cada día entre start_date y end_date. Una solicitud puede abarcar hasta 30 días en el plan Free y 365 días en los planes de pago. Los rangos más largos devuelven el error 207. /timeseries es un alias que se mantiene por compatibilidad.

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

Variación: /change

La cotización inicial, la cotización final, la variación absoluta y la variación porcentual entre dos fechas para cada símbolo. Resulta útil para mensajes como “el oro sube un 3,6 % este mes”. Los límites de rango son los mismos que en /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

Apertura, máximo, mínimo y cierre de un solo día. Omite date, o pasa latest, para obtener la barra de hoy hasta el momento.

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

Oro por quilates: /carat

Precios del oro en las purezas de joyería, de 24K a 8K, en cualquier divisa y unidad. Pasa carat=24 (el valor por defecto), un único quilate como 18, o carat=all. Los quilates admitidos son 24, 23, 22, 21, 20, 18, 16, 14, 12, 10, 9 y 8. Añade date para obtener precios históricos por quilate.

Este endpoint está disponible en los planes de pago. Las claves del plan Free reciben el error 106.

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

Símbolos: /symbols

La lista de símbolos admitidos y sus nombres. Añade details=1 para incluir la categoría y la unidad de cada símbolo. Este endpoint no cuenta para tu cuota mensual.

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

Uso: /usage

Solicitudes usadas y restantes en el mes de facturación actual. También es gratuito, así que puedes llamarlo desde tu sistema de monitorización sin gastar cuota.

GET /api/v1/usage?api_key=YOUR_API_KEY

Stream en tiempo real: /stream

Un stream de Server-Sent Events que envía las actualizaciones de precios en cuanto se producen, para que no tengas que consultar /latest periódicamente. Disponible en el plan Pro y superiores. La documentación de streaming describe el formato de los eventos.

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