# Limites de Taxa

Limites são contados **por endpoint, por IP, por minuto** — não por conta ou por chave da API, então cada servidor atrás do mesmo IP de saída compartilha um orçamento. Cada limite é independente: esgotar `POST /auth` não afeta `GET /transactions`. Onde um limite abrange dois endpoints, solicitações a qualquer um contam contra ele.

## Limites

| Endpoint | Solicitações por minuto por IP |
| --- | --- |
| `POST /auth` | 360 |
| `GET /accounts`, `GET /accounts/{id}` | 360 |
| `GET /transactions`, `GET /transactions/{id}` | 360 |
| `GET /investments`, `GET /investments/{id}` | 360 |
| `GET /investments/{id}/transactions` | 360 |
| `GET /v2/items` | 360 |
| `GET /items/{id}/resources` | 360 |
| `GET /consents`, `GET /consents/{id}` | 360 |
| `PATCH /items/{id}` | 20 |

`PATCH /items/{id}` é dimensionado para atualizações acionadas pelo usuário. Atualizações diárias pertencem ao [auto-sync](/docs/connections/item#auto-sync), não a um loop de chamadas `PATCH`.

## A resposta 429

```json
{
  "code": 429,
  "message": "Muitas solicitações. Por favor, tente novamente mais tarde (veja o cabeçalho Retry-After em segundos)"
}
```

Solicitações adicionais para esse endpoint continuarão falhando até que a janela de um minuto seja redefinida. Três cabeçalhos informam quanto tempo:

| Cabeçalho | Significado |
| --- | --- |
| `RateLimit-Limit` | O limite para este endpoint, por minuto. |
| `RateLimit-Reset` | Segundos até que o contador seja redefinido e o endpoint aceite solicitações novamente. |
| `Retry-After` | A dica padrão de retry. Sempre `60`. |

Aguarde `RateLimit-Reset` segundos e tente novamente. Clientes HTTP com comportamento padrão de retry (por exemplo, `got`) já respeitam `Retry-After` em um `429`.

## API de Enriquecimento

A API de Enriquecimento (`enrichment-api.pluggy.ai`) tem seu próprio limite, contado de forma diferente: **600 solicitações por minuto por aplicação** (`clientId`), compartilhado por `POST /categorize`, `POST /behavior-analysis` e `POST /recurring-payments`. Seu `429` carrega `Retry-After` (segundos até a janela ser redefinida), `X-RateLimit-Limit` e `X-RateLimit-Remaining`. Veja [Enriquecimento de Transações](/docs/intelligence/transaction-enrichment#rate-limits).

## Quando você continua atingindo um limite

- Reutilize a chave da API por suas 2 horas em vez de chamar `POST /auth` por solicitação — veja [Autenticação](/reference/authentication).
- Limite o paralelismo de trabalhos em lote contra um endpoint e espaçe as chamadas.
- Procure por solicitações duplicadas em operação normal.
- Se a aplicação realmente precisar de mais, entre em contato com o suporte com o caso de uso.

Leia o guia: [Limites de taxa](/docs/developer-tools/rate-limits).