> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cotizave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cuotas y límites

> Cuota mensual compartida por cuenta, velocidad por clave y tratamiento de 429.

La **cuota mensual es por cuenta**, compartida entre sus claves. La limitación de velocidad se aplica por API Key.

<span id="cuotas" />

## Planes y ciclos

| Plan / código | Consultas por ciclo | RPS sostenido | Ráfaga | Precio mensual USD |
| - | - | - | - | - |
| Gratis / `free` | 1.500 | 1 | 3 | 0 |
| Inicio / `lite` | 3.500 | 2 | 4 | 3 |
| Esencial / `hobby` | 20.000 | 3 | 5 | 7 |
| Profesional / `indie` | 60.000 | 4 | 7 | 15 |
| Escala / `pro` | 150.000 | 7 | 13 | 29 |

Los nombres comerciales se conservan en ambos idiomas. El ciclo se vincula a la activación del plan (en Gratis, a la creación de la cuenta), no necesariamente al día 1. Usa `X-RateLimit-Reset` para conocer el siguiente reinicio y consulta los [precios vigentes](https://cotizave.com/precios).

<span id="como-cuenta" />

## Qué consume cuota

En las rutas medidas, cuentan las respuestas exitosas y errores de validación o recurso como `400`, `404`, `406` y `422`. No cuentan `401`, `402`, `403`, `429` ni `5xx`. Una llamada a bulk consume una unidad, aunque incluya 50 montos. Los avisos de webhooks tienen un contador separado.

<span id="headers" />

## Cabeceras

| Cabecera | Significado |
| - | - |
| `X-RateLimit-Limit` | Cuota mensual del plan. |
| `X-RateLimit-Remaining` | Consultas restantes. |
| `X-RateLimit-Reset` | Siguiente reinicio, ISO 8601. |
| `X-RateLimit-Scope` | En rechazos del limitador principal: `burst` o `monthly`. |
| `Retry-After` | Espera indicada; este limitador usa segundos enteros. |
| `X-RateLimit-Retry-After-Ms` | Espera precisa en milisegundos para `burst`. |
| `X-RateLimit-Limit-Second`, `X-RateLimit-Burst` | Velocidad y capacidad de ráfaga cuando se informan. |

No todas las respuestas pasan por el limitador: tolera cabeceras ausentes, especialmente en rechazos de autenticación o errores del proxy. HTTP también permite fechas en `Retry-After`; un cliente genérico debe poder interpretarlas.

<span id="excedido" />

## Tratar 429 según su alcance

* **`burst`:** espera al menos el plazo indicado, añade jitter y limita intentos y tiempo total. Reduce la concurrencia.
* **`monthly`:** detén las llamadas hasta el reinicio o un cambio confirmado de cuota. Un reintento inmediato no resuelve el agotamiento.
* **Sin scope:** puede ser una protección por IP o el límite horario de bulk. Respeta `Retry-After` y evita reintentos automáticos indiscriminados.

<span id="abuso" />

## Presupuesto de consultas

Cuenta el consumo agregado de procesos, usuarios y reintentos. Un polling cada 30 segundos durante 30 días consume 86.400 consultas por proceso, antes de cualquier otra llamada. Usa caché compartida y evita que cada visitante consulte Cotizave por separado.

<span id="mas" />

## Cambios de plan y créditos

Gestiona el plan desde el [dashboard](https://app.cotizave.com) y comprueba cuándo se activa el cambio. Cotizave no ofrece SLA contractual; los créditos se evalúan caso por caso y no son compensaciones automáticas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.