Recibe alertas del precio del oro desde tu cuenta con Plus o Pro. Con Free o Basic, programa consultas a la API y conecta tu herramienta de notificaciones. La cotización es 3.875,25 US$ por onza troy a 30 oct 2026, 21:08 UTC. Los precios gratuitos llevan quince minutos de retraso.
- Plus y Pro incluyen cinco alertas de precio cada uno.
- Las alertas integradas consultan precios en vivo y envían solicitudes POST firmadas a tu URL.
- Con Free y Basic, programa consultas y guarda el último estado.
Crea una alerta integrada
Plus y Pro incluyen cinco alertas de precio cada uno. Free y Basic no las incluyen. Compara los planes, inicia sesión y abre las alertas de tu cuenta para crear una. Cada alerta sigue un metal: oro, plata o cobre.
Elige una regla: cruce de un nivel hacia arriba, hacia abajo o ambos; variación porcentual en una hora o veinticuatro horas; o cierre diario. Las alertas consultan precios en vivo. Cada una envía como máximo una notificación de nivel o porcentaje por hora, o una de cierre diario por día UTC.
Programa consultas con Free o Basic
Con Free y Basic, ejecuta la solicitud siguiente cada quince minutos. Consulta el precio del oro por onza troy en /v1/spot/XAU-USD-SPOT. Elige tu nivel en la misma moneda y unidad. Las solicitudes sin clave no requieren registro, así que puedes empezar sin cuenta.
Esta frecuencia genera cuatro solicitudes por hora, noventa y seis al día y unas dos mil novecientas al mes. Respeta los límites sin clave de diez solicitudes por minuto y cien por hora por IP, y las cinco mil llamadas mensuales de la clave gratuita.
curl "https://api.goldprice.dev/v1/spot/XAU-USD-SPOT"Comprueba la entrega y la firma
Una alerta integrada envía una solicitud POST firmada con cuerpo JSON a tu URL. Usa https en el puerto 443 con un nombre de host público. Se rechazan direcciones privadas o locales. Incluye event, alert_id, kind, symbol, direction, price y observed_at. Los campos de regla son level; percent, window y reference_price; o date y close.
El encabezado Webhook-Signature tiene el formato t=<unix time>,v1=<HMAC SHA-256 of "<t>.<body>" with your signing secret>. Guarda el secreto de firma al crear la alerta, porque solo se muestra una vez. Verifica la firma con el cuerpo recibido y rechaza las firmas de más de cinco minutos.
Envía una prueba desde la página de alertas para comprobar tu URL receptora. goldprice.dev no envía correos ni SMS. El POST llega a una URL que controlas, como un webhook entrante de una herramienta de chat o un servidor pequeño.
Guarda el estado de las consultas programadas
En una consulta programada, revisa is_stale y computed_at antes de comparar el precio. Los precios gratuitos llevan quince minutos de retraso. Usa la primera lectura válida para determinar si el precio está por encima o por debajo de tu nivel y guarda ese estado.
Notifica cuando una lectura válida posterior cruce tu nivel. En un cruce ascendente, pasa de estar por debajo a igualarlo o superarlo. Invierte la comparación para un cruce descendente. Las lecturas del mismo lado no deben repetir alertas. Las consultas periódicas pueden omitir un cruce si el precio vuelve antes de la siguiente consulta.
Sigue un tutorial de configuración
El tutorial de alertas de precio incluye un script que consulta la cotización, guarda el último estado y envía un mensaje al webhook entrante de un servicio de chat. Síguelo para conectar una solicitud programada con una notificación.
Para configurar sin escribir un script, sigue el tutorial de flujos programados o el . Comprueba siempre la vigencia del precio, la coincidencia de unidades y el estado guardado. La notificación se envía mediante la herramienta que elijas.