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

# Uso justo

> Límites, caché recomendada y qué pasa si se abusa de la API gratuita.

La API es gratuita y abierta. Para que siga así, el consumo tiene que ser razonable.

## Límites

| | |
| - | - |
| **Cuota** | 120 solicitudes por hora, por IP |
| **Cabeceras** | `RateLimit-Limit` · `RateLimit-Remaining` · `RateLimit-Reset` (también `X-RateLimit-*`). `Reset` = segundos que faltan, no epoch |
| **Política** | `RateLimit-Policy: "hora";q=120;w=3600` · `RateLimit: "hora";r=<restantes>;t=<segundos>` |
| **Al pasarte** | `429` con `Retry-After` (segundos) |

## Caché recomendada

* El TC oficial cambia **una vez al día** (23:30, hora Bolivia). La UFV, también una vez al día.
* Respeta `Cache-Control: max-age`: hasta 1 hora, sin pasar la medianoche de Bolivia ni la próxima publicación.
* Revalida con `If-None-Match` y el `ETag` recibido: si no cambió, recibes `304` sin cuerpo.
* Una consulta por hora alcanza para cualquier integración.

## Abuso

30 respuestas `429` en una hora (por IP + User-Agent) se bloquean, de forma escalonada:

| Reincidencia | Bloqueo |
| - | - |
| 1.ª | 1 hora |
| 2.ª | 24 horas |
| 3.ª en adelante | 7 días |

Durante el bloqueo, la API responde `403` (`application/problem+json`, en español e inglés) con la fecha en
que se levanta y `Retry-After`. Los `403` no consumen cuota; la reincidencia se recuerda 30 días y los
reincidentes confirmados pasan a un bloqueo permanente.

## ¿Necesitas más?

Si tu caso requiere más consultas, escríbele al agente de CUCU por [WhatsApp](https://wa.me/59160522508).


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