Límites de solicitudes y planes

Dos tipos de límites

Cada plan tiene una cuota mensual, el número de solicitudes facturables en cada mes del calendario, y un límite por minuto que protege la API de las ráfagas. Las cuotas se restablecen a las 00:00 UTC del día 1 de cada mes.

Los planes también difieren en el intervalo de actualización, es decir, en lo recientes que son los precios. Consultar con más frecuencia que tu intervalo devuelve los mismos precios y solo consume cuota.

Los planes de un vistazo

• Free: 100 solicitudes/mes, actualización diaria, 10 solicitudes/minuto
• Lite: 1000 solicitudes/mes, actualización cada 30 minutos, 30 solicitudes/minuto
• Standard: 10.000 solicitudes/mes, actualización cada 10 minutos, 60 solicitudes/minuto
• Advanced: 50.000 solicitudes/mes, actualización cada 60 segundos, 120 solicitudes/minuto
• Pro: 100.000 solicitudes/mes, actualización cada 60 segundos, 300 solicitudes/minuto
• Ultra: 500.000 solicitudes/mes, actualización cada 15 segundos, 600 solicitudes/minuto
• Business: 500.000 solicitudes/mes, actualización cada 15 segundos, 600 solicitudes/minuto, además de un SLA de disponibilidad
• Enterprise: 1.500.000 solicitudes/mes, actualización cada 5 segundos, 1200 solicitudes/minuto

Las funciones también crecen con el plan. Los precios por quilate requieren un plan de pago, los precios bid/ask empiezan en Standard, las alertas por webhook en Advanced y el stream en tiempo real en Pro. Consulta los precios actuales.

Qué cuenta como solicitud

• Cada llamada correcta a un endpoint de datos cuenta como una solicitud, sin importar cuántos símbolos devuelva.
• /symbols y /usage son gratuitos y nunca cuentan.
• Las solicitudes rechazadas con 104 (límite por minuto), 106 (no incluido en tu plan), 107 (origen no permitido) o con un error del servidor (500, 503) no se facturan.
• Las solicitudes que fallan por la propia consulta sí cuentan. Eso incluye los errores de validación 201 a 210 y 300 (sin resultados), así que valida las fechas y los símbolos antes de enviarlos.

Seguimiento de tu uso

Cada respuesta autenticada informa de tu cuota en las cabeceras:

X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9876
X-RateLimit-Used: 124
X-RateLimit-Reset: 1793491200
X-RateLimit-Reset-Date: 2026-11-01T00:00:00.000Z
X-RateLimit-Plan: Standard
X-RateLimit-Minute-Limit: 60
X-RateLimit-Minute-Remaining: 59

Los mismos números aparecen en el objeto rate_limit del cuerpo JSON. reset es una marca de tiempo Unix y reset_date es el mismo momento en ISO 8601: el inicio del mes siguiente en UTC.

Consultar el uso sin gastar cuota

Llama a /usage desde tus paneles o tu sistema de monitorización. Es gratuito:

{
  "success": true,
  "usage": {
    "requests_made": 124,
    "requests_quota": 10000,
    "requests_remaining": 9876,
    "plan": "standard",
    "period_start": "2026-10-01T00:00:00.000Z",
    "period_end": "2026-11-01T00:00:00.000Z"
  },
  "result": { "plan": "Standard", "used": 124, "total": 10000, "remaining": 9876 },
  "rate_limit": {
    "limit": 10000,
    "remaining": 9876,
    "reset": 1793491200,
    "used": 124,
    "plan": "Standard",
    "reset_date": "2026-11-01T00:00:00.000Z"
  }
}

Cuando alcanzas un límite

Ambos límites responden con el código de estado HTTP 429 y un cuerpo de error:

• 104 too_many_requests: demasiadas solicitudes en el minuto actual. La respuesta incluye una cabecera Retry-After con el número de segundos que debes esperar. Reduce el ritmo y vuelve a intentarlo.
• 105 quota_exceeded: se ha agotado la cuota mensual. Las solicitudes seguirán fallando hasta que la cuota se restablezca el día 1 (UTC). Cambiar a un plan superior surte efecto de inmediato.

{
  "success": false,
  "error": {
    "code": 105,
    "type": "quota_exceeded",
    "info": "User has reached or exceeded his subscription plan's monthly API request allowance"
  }
}

Cómo no superar tu cuota

• Almacena las respuestas en caché durante al menos el intervalo de actualización de tu plan.
• Solicita todos los símbolos que necesites en una sola llamada en lugar de hacer una llamada por símbolo.
• Consultar cada 10 minutos consume unas 4500 solicitudes al mes. Consultar cada minuto consume unas 45.000. Elige el plan que se ajuste a tu frecuencia de consulta.
• En Pro y superiores, usa el stream en tiempo real en lugar de consultar periódicamente, y usa las alertas de precio para reaccionar a los umbrales.

Encontrarás más consejos en Buenas prácticas.