El plan gratuito incluye 100 solicitudes por hora, precios en directo de 5 metales y tipos de cambio. Cada solicitud necesita una clave de API.
Qué incluye el plan gratuito
El límite cuenta todas las claves de tu cuenta juntas. El plan gratuito permite el uso comercial si la página que muestra los precios incluye un enlace visible a goldApi.dev.
| Free | Límite |
|---|---|
| Precio al mes | $0 |
| Solicitudes por hora | 100 |
| Precios spot | En directo |
| Metales | 5 |
| Tipos de cambio y otras monedas | Sí |
| Historial diario | No |
| Velas diarias OHLC | No |
| Cierre anterior y variación diaria | No |
| Uso comercial | Sí, con un enlace visible a goldApi.dev junto a los precios |
Cuando alcanzas un límite
Usa las cabeceras de respuesta X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset para reducir las solicitudes antes de llegar al límite. Al superarlo, la API devuelve 429, un JSON breve y una cabecera Retry-After en segundos. Las solicitudes vuelven a funcionar al empezar la hora siguiente.
curl -i "https://goldapi.dev/api/v1/price/XAU/USD" \ -H "X-API-Key: $API_KEY"| Estado | error | Cuándo |
|---|---|---|
| 429 | rate_limit_exceeded | Se superaron las solicitudes por hora del plan |
| 401 | api_key_required | La solicitud no tiene clave |
| 401 | invalid_api_key | La clave no es válida |
| 403 | feature_requires_basic | El plan no incluye este endpoint |
{ "error": "rate_limit_exceeded" }Límites de los planes de pago
Los planes de pago incluyen más solicitudes y más datos.
Plan Basic
| Basic | Límite |
|---|---|
| Precio al mes | $8 |
| Solicitudes por hora | 2,000 |
| Precios spot | En directo |
| Metales | 5 |
| Tipos de cambio y otras monedas | Sí |
| Historial diario | Sí |
| Velas diarias OHLC | No |
| Cierre anterior y variación diaria | No |
| Uso comercial | Sí, sin necesidad de enlace |
Plan Pro
| Pro | Límite |
|---|---|
| Precio al mes | $15 |
| Solicitudes por hora | Sin límite |
| Precios spot | En directo |
| Metales | 5 |
| Tipos de cambio y otras monedas | Sí |
| Historial diario | Sí |
| Velas diarias OHLC | Sí |
| Cierre anterior y variación diaria | Sí |
| Uso comercial | Sí, sin necesidad de enlace |
Elegir un plan
El plan gratuito sirve para prototipos, paneles internos y sitios personales. Elige un plan de pago si necesitas más de 100 solicitudes por hora, historial diario o velas diarias.