Planes Guía

Límites del plan gratuito

Límites gratuitos y de pago, de la tabla de planes de la API

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.

FreeLímite
Precio al mes$0
Solicitudes por hora100
Precios spotEn directo
Metales5
Tipos de cambio y otras monedasSí
Historial diarioNo
Velas diarias OHLCNo
Cierre anterior y variación diariaNo
Uso comercialSí, 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.

Shell
curl -i "https://goldapi.dev/api/v1/price/XAU/USD" \  -H "X-API-Key: $API_KEY"
EstadoerrorCuándo
429rate_limit_exceededSe superaron las solicitudes por hora del plan
401api_key_requiredLa solicitud no tiene clave
401invalid_api_keyLa clave no es válida
403feature_requires_basicEl plan no incluye este endpoint
Respuesta
{ "error": "rate_limit_exceeded" }

Los planes de pago incluyen más solicitudes y más datos.

Plan Basic

BasicLímite
Precio al mes$8
Solicitudes por hora2,000
Precios spotEn directo
Metales5
Tipos de cambio y otras monedasSí
Historial diarioSí
Velas diarias OHLCNo
Cierre anterior y variación diariaNo
Uso comercialSí, sin necesidad de enlace

Plan Pro

ProLímite
Precio al mes$15
Solicitudes por horaSin límite
Precios spotEn directo
Metales5
Tipos de cambio y otras monedasSí
Historial diarioSí
Velas diarias OHLCSí
Cierre anterior y variación diariaSí
Uso comercialSí, 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.

Preguntas

¿Cuáles son los límites de solicitudes del plan gratuito?

100 solicitudes por hora, contando todas las claves de tu cuenta juntas.

¿Puedo usar la API sin clave?

No. Cada solicitud necesita tu clave en la cabecera X-API-Key. La clave gratuita no requiere tarjeta de crédito.

¿Qué respuesta recibo al alcanzar el límite?

429, con el error rate_limit_exceeded y una cabecera Retry-After en segundos.

¿Cuándo se reinicia el límite?

Al empezar la hora siguiente. La cabecera X-RateLimit-Reset indica el momento exacto.

¿Se permite el uso comercial en el plan gratuito?

Sí. La página que muestra los precios debe incluir un enlace visible a goldApi.dev. Los planes de pago no necesitan enlace.

Sigue leyendo

Empieza con una clave API gratis

100 solicitudes por hora en el plan gratuito. Sin tarjeta de crédito.

Obtén una clave gratis