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

# Rate Limiting

> Limites de requisição por token e por IP, e como lidar com o 429.

A API limita a frequência de requisições para manter o serviço estável para todos. Os limites variam por rota:

| Rota                      | Limite                |
| ------------------------- | --------------------- |
| Autenticadas (`/api/*`)   | 120 req/min por token |
| Upsell Widget — consultas | 300 req/min por IP    |
| Upsell Widget — ações     | 10 req/min por IP     |

<Note>
  Ao estourar o limite, a API responde `429 Too Many Requests` e informa no header `Retry-After` quantos segundos esperar antes de tentar de novo.
</Note>

<Tip>
  Ao receber um `429`, aplique **backoff exponencial** respeitando o `Retry-After`. Isso espaça as tentativas e evita novos bloqueios.
</Tip>