Para automatizar precios del oro en tiempo real en n8n, importa el JSON de goldprice.dev sin credenciales. Crea una credencial Header Auth llamada X-API-Key y asígnala al nodo HTTP Request v4.2.
El flujo inactivo consulta api.goldprice.dev/v1/spot/XAU-USD-SPOT cada hora mediante Schedule Trigger v1.2: unas 720 llamadas en un mes de 30 días, dentro de las 5.000 llamadas/mes de Free. Publícalo tras una ejecución manual correcta.
Obtén tu clave de API de goldprice.dev
Crea una cuenta gratuita en goldprice.dev/onboarding. En tu panel verás una clave que empieza por ga_live_. En el siguiente paso la guardarás en las credenciales de n8n. Nunca la pegues directamente en un nodo.
El plan gratuito incluye 5.000 consultas/mes y precios al contado del oro en 31 monedas. No necesitas tarjeta.
Importa el flujo sin credenciales
**Descarga el JSON del flujo horario de n8n** y elige Importar desde archivo en n8n. Contiene nodos Schedule Trigger v1.2 y HTTP Request v4.2, está inactivo por defecto y no incluye claves de API ni credenciales asignadas.
Crea y asigna la credencial Header Auth
Crea una credencial Header Auth en n8n. En Nombre, escribe X-API-Key; en Valor, tu clave de goldprice.dev. Abre Obtener precio del oro, elige Tipo de credencial genérico → Header Auth y selecciona la credencial. Guardar el secreto en las credenciales de n8n evita que aparezca en el JSON exportado.
{ "parameters": { "url": "https://api.goldprice.dev/v1/spot/XAU-USD-SPOT", "authentication": "genericCredentialType", "genericAuthType": "httpHeaderAuth", "options": { "response": { "response": { "neverError": false, "responseFormat": "autodetect" } }, "timeout": 5000 } }, "type": "n8n-nodes-base.httpRequest", "typeVersion": 4.2, "retryOnFail": true, "maxTries": 3, "waitBetweenTries": 2000, "onError": "continueErrorOutput"}Ejecuta el flujo y revisa la salida
Haz clic en Ejecutar flujo. Comprueba que Obtener precio del oro devuelve el precio, computed_at e is_stale. Los precios de compra y venta solo están disponibles en planes de pago y pueden faltar. Corrige los errores de credenciales. Tras una ejecución manual correcta, publica el flujo para activar la programación horaria.
Cambia de moneda o metal
Edita el último segmento de la URL en Obtener precio del oro. Los símbolos usan METAL-CURRENCY-SPOT. Para consultar varios símbolos, crea elementos de entrada y usa https://api.goldprice.dev/v1/spot/{{ $json.symbol }} en el nodo HTTP Request.
[ { "symbol": "XAU-USD-SPOT" }, { "symbol": "XAU-INR-SPOT" }, { "symbol": "XAU-EUR-SPOT" }, { "symbol": "XAG-USD-SPOT" }]Resultado esperado
{ "symbol": "XAU", "quote_currency": "USD", "unit": "troy_ounce", "contract_type": "spot", "price": "4012.75", "is_stale": false, "computed_at": "2026-08-18T08:00:00Z"}El panel de salida del nodo HTTP Request muestra el JSON completo. Los nodos siguientes pueden acceder a cualquier campo con expresiones como {{ $json.price }} o {{ $json.computed_at }}.
Errores comunes
| Código | Qué ves | Solución |
|---|---|---|
| 401 | El nodo HTTP Request falla con 401 Unauthorized | Falta la clave de API o no es válida. Abre Credenciales → X-API-Key y pega una clave nueva desde tu panel. Comprueba que esté seleccionada en el desplegable Autenticación del nodo HTTP Request: Tipo de credencial genérico → Header Auth. |
| 429 | Aparece 429 Too Many Requests ocasionalmente en la salida de errores | El intervalo es demasiado corto o varios flujos comparten el plan. Consultar cada hora supone unas 720 llamadas en 30 días; cada 15 minutos, 2.880. Reduce la frecuencia y espera según las indicaciones de la API antes de reintentar. Los fallos persistentes aparecen en la salida de errores del nodo. |
| N/A | El JSON exportado contiene la clave de API en texto sin cifrar | Pegaste la clave en la URL o una cabecera. Bórrala, crea una credencial Header Auth como en el paso 3 y selecciónala en el desplegable Autenticación. n8n no exporta los valores de las credenciales, pero sí los escritos directamente. |
| N/A | La ejecución manual funciona, pero el flujo horario nunca se ejecuta | El flujo importado está inactivo por diseño. Publícalo tras comprobar las credenciales con una ejecución manual correcta. Schedule Trigger solo se activa cuando el flujo está publicado. |
Más opciones
- Añade un nodo Postgres después de HTTP Request para insertar filas
{symbol, price, computed_at}y analizar series temporales - Usa un nodo IF con
price > thresholdpara enviar una alerta a Slack/Discord cuando se cumpla la condición - Recorre varios elementos de entrada para seguir el oro, la plata y el cobre en un mismo flujo
- Conecta la salida de errores a un canal de Slack para recibir alertas de los errores 429