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, não a um loop de chamadas PATCH.
A resposta 429#
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.
Quando você continua atingindo um limite#
- Reutilize a chave da API por suas 2 horas em vez de chamar
POST /authpor solicitação — veja AutenticaçãoAPI. - 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.
