Menú

Inicio rápido

Obtén el precio XAU/USD en directo en unos minutos.

Antes de empezar

Necesitas curl o cualquier cliente HTTP y una clave de API gratuita. Regístrate, confirma tu correo y copia la clave desde tu cuenta. El plan gratuito incluye 100 solicitudes por hora.

Obtén una clave gratis

Tu primera solicitud

Envía tu clave en la cabecera X-API-Key. Guárdala en tu servidor, no en código que vean los visitantes.

curl --fail-with-body --max-time 10 "https://goldapi.dev/api/v1/price/XAU/USD" \  -H "X-API-Key: $API_KEY"

Leer la respuesta

price es el precio por la unidad de la respuesta: una onza troy, o una libra para el cobre. gram es el precio de un gramo en los quilates de la respuesta, y updatedAt es cuándo se generó.

Respuesta 200

{
    "symbol": "XAU",
    "name": "Gold",
    "currency": "USD",
    "unit": "oz",
    "price": 4072.1,
    "gram": 130.921,
    "karat": 24,
    "updatedAt": "2026-11-07T02:39:39+02:00"
}

Cuando algo falla

Los errores son JSON con un campo error. Los primeros suelen ser 401 api_key_required si falta la cabecera, 401 invalid_api_key si la clave es incorrecta y 403 email_not_verified hasta confirmar el correo. Al superar el límite recibes 429 rate_limit_exceeded con una cabecera Retry-After.

Siguientes pasos