API de precio del oro en Reddit: las preguntas de desarrolladores, respondidas

Busca una API de precio del oro en Reddit y el hilo siempre tiene la misma forma. Alguien está construyendo un panel de datos, una alerta de precio, un bot de trading o una tienda que cotiza metales preciosos, y necesita un precio del oro en tiempo real que pueda consultar desde código. Antes de integrar nada, hacen las mismas preguntas en r/algotrading, r/webdev y r/golang: ¿hay nivel gratuito?, ¿qué tan fresco es el dato?, ¿cuáles son los límites?, ¿puedo usarlo comercialmente?, ¿puedo confiar en los datos?

Este artículo responde esas preguntas directamente, usando goldprice.dev como ejemplo práctico. No hace falta registrarse para leerlo, y la primera llamada a la API que aparece abajo funciona sin clave.

Qué es goldprice.dev y qué no es

Es una API de precios de materias primas para desarrolladores: oro, plata y cobre, a través de un único endpoint REST autenticado en https://api.goldprice.dev. Cada respuesta incluye un indicador validado de obsolescencia cruzada, y puedes pedir precios por fuente con sus marcas temporales o una cifra de divergencia con ?include=, para que tu código sepa cuándo una fuente se está rezagando en lugar de fallar silenciosamente. El servidor MCP está disponible en todos los planes, incluyendo el gratuito.

No es una correduría ni un feed de liquidación. Los precios son datos de referencia indicativos, publicados para visualización, análisis y alertas. Si necesitas una cotización ejecutable para liquidar una operación, ninguna API pública de precio del oro es la herramienta adecuada, esta incluida.

¿Hay nivel gratuito?

Sí, sin tarjeta. Free ofrece 5.000 llamadas al mes a 10 peticiones por minuto y spot de oro, plata y cobre con 15 minutos de retraso. Los planes de pago añaden precios en vivo, precios de distribuidores y límites mayores:

¿Con qué frecuencia se actualiza el precio?

El spot usa datos primarios de mercado con licencia. Los planes de pago reciben precios en vivo; Free, las llamadas anónimas y esta web los reciben con 15 minutos de retraso. Cada respuesta incluye computed_at y activa is_stale si el valor supera su ventana de actualización. ?include=sources da las marcas temporales por fuente para comprobar la frescura.

¿Cuáles son los límites de tasa?

Free permite 10 peticiones por minuto; Basic 60, Plus 120 y Pro 300. Cada respuesta devuelve la cabecera estándar X-RateLimit-Remaining, por lo que el patrón correcto es leer esa cabecera y reducir la velocidad cuando se acerca a cero, en lugar de hacer polling ciego y recibir errores 429. Para la mayoría de las aplicaciones, una caché del lado del cliente con TTL ajustado a la frecuencia real de cambio del valor subyacente es suficiente para mantenerse bien dentro del plan gratuito.

¿Cómo me autentico?

Con un token bearer. Las claves tienen el prefijo ga_live_ y van en la cabecera Authorization. También existe una superficie anónima, limitada por IP a 30 peticiones/minuto, 100/hora y 1.000/mes, que devuelve precio, marcas de tiempo y obsolescencia. Bid/ask son opcionales, solo de pago y requieren una cotización coherente de ambos lados. Autenticarse desbloquea ?include=stats con apertura, máximo, mínimo, cierre anterior, variación y los campos de divergencia entre fuentes, ?include=sources e ?include=karat están disponibles en ambos casos.

¿Puedo ver de dónde viene el número?

Sí, y esta es la parte que la mayoría de las APIs ocultan. Añade ?include=sources y la respuesta incluye un array sources[], una fila por fuente upstream, cada una con su propio precio y marca temporal. Cuando las fuentes no coinciden, ?include=stats (autenticado) incluye divergence_bps y un divergence_flag, para que puedas definir tu propia tolerancia en lugar de confiar en un número combinado sin procedencia. Si estás construyendo algo donde un precio incorrecto tiene coste, esa visibilidad es la razón para usar una API estructurada en lugar de hacer scraping de una página web.

¿Puedo usarlo comercialmente?

Todos los planes permiten uso comercial. Ningún plan requiere enlace de atribución. Redistribuir o revender los datos requiere un acuerdo aparte: hello@goldprice.dev.

¿Puede usarlo mi agente LLM?

Sí. El servidor MCP está incluido en todos los planes, incluido el gratuito. Añades un bloque de configuración a Claude, Cursor o cualquier runtime compatible con MCP y el agente obtiene el precio en vivo directamente, sin código de herramienta escrito a mano. Los datos son los mismos que sirve la API REST. Hay una guía completa del MCP si quieres los detalles de configuración.

La llamada más corta

Sin clave, sin dependencias:

curl https://api.goldprice.dev/v1/prices?symbol=XAU-USD-SPOT

Recibes JSON con precio e indicador de obsolescencia, con 15 minutos de retraso. Bid/ask son opcionales, solo de pago y requieren una cotización coherente de ambos lados. Añade ?include=karat para un desglose por gramo según quilate o ?include=sources para las fuentes contribuyentes. Cuando quieras la respuesta completa y límites más altos, una clave gratuita tarda un minuto.

Para la versión específica por lenguaje, Fetch live gold prices in JavaScript cubre el camino REST de extremo a extremo, y Caching gold prices and staying inside rate limits cubre cómo hacerlo a escala.