Limites de Taxa

Limites de requisições por endpoint, a resposta 429 e os cabeçalhos que indicam quando tentar novamente.

Ver como Markdown

Limites são contados por endpoint, por IP, por minuto. Cada limite é independente: esgotar POST /auth não afeta GET /transactions. Quando um limite abrange dois endpoints, as solicitações para qualquer um contam contra ele.

Limites#

EndpointSolicitações por minuto por IP
POST /auth360
GET /transactions, GET /transactions/{id}360
GET /investments, GET /investments/{id}360
GET /investments/{id}/transactions360
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çalhoSignificado
RateLimit-LimitO limite para este endpoint, por minuto.
RateLimit-ResetSegundos até que o contador seja redefinido e o endpoint aceite solicitações novamente.
Retry-AfterA dica padrão de nova tentativa. Sempre 60.

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

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çã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.

Esta página foi útil?