Cada fuente, visible

Transmisión directa, por fuente

La mayoría de las API de metales recopilan precios de varios flujos de datos, calculan una mediana ponderada, descartan los datos de entrada y te entregan un número. La mezcla es opaca. Cuando los precios difieren entre bolsas (algo que ocurre a diario durante las renovaciones de contratos, las liquidaciones y cada cierre de mercado), no puedes saber si el número de la API refleja la realidad o su ponderación interna.

Los precios spot se transmiten directamente desde una única fuente principal con licencia, sin mezclas ni promedios. Durante las interrupciones, una fuente de respaldo con licencia proporciona oro y plata. El cobre no tiene respaldo. Añade ?include=sources para ver la fuente que produjo el precio, su precio, fetched_at y source_timestamp.

GET /v1/prices?symbol=XAU-USD-SPOT&include=sources

{
  "symbol": "XAU",
  "price": "4803.94",
  "is_stale": false,
  "computed_at": "2026-05-01T02:34:02Z",
  "sources": [
    { "source": "oracle.xau_usd", "display_name": "Live spot", "price": "4803.94", "fetched_at": "...", "source_timestamp": "..." }
  ]
}

Fuentes que incorporamos

Categorías de fuentes en cada nivel. La prueba, para cada llamada, de qué flujos de datos se utilizaron para un precio determinado está en tu respuesta de /v1/prices.

Los identificadores de las fuentes, las frecuencias de actualización y los detalles de los endpoints de los proveedores se documentan internamente y evolucionan con cada versión. Si necesitas este nivel de detalle para una evaluación legal, envía tu caso de uso a hello@goldprice.dev y te responderemos.

Los precios en monedas distintas de USD de las páginas de divisas son el precio spot del oro en USD multiplicado por los tipos de cambio en tiempo real de exchangerate.dev, nuestra API hermana de divisas. Las filas spot en monedas distintas de USD no usan tipos de cambio almacenados como respaldo. Si se interrumpen los tipos de cambio en tiempo real, /v1/convert y /v1/carat usan el tipo almacenado más reciente de hasta 3 días de antigüedad; las filas spot en monedas distintas de USD conservan un precio desactualizado.

Flujo de respaldo de precios spot

Los precios spot usan datos de mercado de una fuente principal con licencia. Los precios de compra y venta son opcionales y exclusivos de los planes de pago, y requieren una cotización coherente de ambos lados. Si la fuente principal se interrumpe, el oro y la plata pasan a una fuente de respaldo con licencia hasta que se restablece. El precio de respaldo puede tener unos dos minutos de retraso respecto al mercado. Mientras se utiliza, las respuestas no incluyen precios de compra ni de venta.

No usamos el respaldo cuando el mercado de metales está cerrado: a diario de 17:00 a 18:00 y desde el viernes a las 17:00 hasta el domingo a las 18:00, siempre en hora de Nueva York. El cobre no tiene respaldo. Si su flujo se interrumpe, el último precio del cobre se marca como desactualizado.

Divergencia entre fuentes

Las filas con al menos dos fuentes principales actualizadas incluyen divergence_bps: su diferencial en puntos básicos respecto a la media. Las filas spot usan una sola fuente y lo omiten. GET /v1/prices/divergence enumera los símbolos que superan un umbral de diferencial en todos los niveles.

divergence_flag permanece en false para XAU-USD-SPOT; el oro en monedas distintas de USD usa el precio spot en USD × los tipos de cambio en tiempo real de exchangerate.dev.

Sobre la fijación de la LBMA

Desactualización, por fuente

El campo is_stale de nivel superior pasa a true cuando la fuente que proporciona el precio supera su intervalo de actualización previsto. Añade ?include=sources para ver el precio de esa fuente, fetched_at y source_timestamp, y evaluar su actualidad por tu cuenta.

Perspectiva futura: curva de futuros

La trayectoria de precios futuros implícita en el mercado se proporciona mediante /v1/forward-view/{asset}. El desglose siguiente explica los cálculos, la fuente y la frecuencia de actualización.

Curva de futuros

Los próximos 5 contratos de futuros de oro. Los precios de liquidación tienen ~15 minutos de retraso y proceden de nuestra serie principal de datos diferidos, con un respaldo secundario. Los valores de futuros proceden de flujos de datos diferidos disponibles públicamente y no son datos en tiempo real con licencia. La línea discontinua conecta los 5 puntos de liquidación; aparecen huecos cuando fallan tanto el flujo principal como el de respaldo para un contrato. El interés abierto y el volumen se tratan bajo el criterio de mejor esfuerzo, tienen valor null y no se muestran en la respuesta.

Actualidad de los datos

Los precios de liquidación de futuros se actualizan los días laborables a las 20:30 UTC: un único horario durante todo el año, +2h tras la liquidación en EDT, +1h en EST, estable ante los cambios de horario de verano.

Lo que no hacemos

• Fijación de la LBMA Consulta lo anterior.
• Libros de órdenes L2 a nivel de tick Publicamos precios, no profundidad de mercado. Los libros de órdenes a nivel de tick quedan fuera de la cobertura de esta API.
• Garantías de latencia inferior a un segundo No publicamos un SLA de latencia numérico.
• Mezclas silenciosas El motivo de esta página.

Preguntas frecuentes

De dónde vienen nuestros precios y cómo funciona la cobertura de respaldo.

¿Quiénes son vuestros proveedores de datos principal y de respaldo?

Usamos un único proveedor principal de datos de mercado con licencia para oro, plata y cobre. Un proveedor de respaldo con licencia cubre el oro y la plata. No publicamos el nombre de ninguno de los dos.

¿Vuestro precio spot es un precio compuesto o la cotización de un solo contribuyente?

Transmitimos directamente el precio del proveedor principal, sin mezclas ni promedios. No es un índice de referencia oficial ni la fijación de la LBMA. ?include=sources devuelve sources[] con fetched_at y source_timestamp.

¿Qué ocurre si se interrumpe vuestro flujo principal?

Un respaldo con licencia proporciona oro y plata mientras la fuente principal no está disponible. Puede tener unos dos minutos de retraso y no incluye precios de compra ni de venta. El cobre no tiene respaldo. is_stale pasa a true cuando la fuente utilizada supera su intervalo de actualización previsto.

Historial de cambios de la metodología

Para los lanzamientos de endpoints de la API, niveles y productos más allá de las revisiones de la metodología, consulta el historial de cambios del producto.

¿Preguntas sobre la API? Lee la documentación.