Quais são os limites da API da brapi?

A brapi aplica limites mensais, limites de requisições simultâneas e limites de tickers por requisição. Eles variam conforme o plano e ajudam a dimensionar o volume do seu projeto.

Os limites mensais representam a quantidade disponível na janela do plano. Para um ciclo mensal, a cota reinicia na data de renovação indicada no dashboard de cobrança, não necessariamente no primeiro dia do mês. Se o dashboard mostrar 21/09, esse é o dia do reset.

As requisições simultâneas são o número de chamadas que podem ficar em execução ao mesmo tempo na sua conta. O limite vale para a conta inteira, não para cada token. Quando ele é atingido, a API responde HTTP 429 com o cabeçalho X-Brapi-Concurrency-Limit. Aguarde uma chamada terminar antes de repetir.

A brapi não tem limite de requisições por segundo ou por minuto nesses planos: nesse ponto o limite é ilimitado. O que existe é a cota mensal do plano e o limite de requisições simultâneas. O HTTP 429 pode vir de qualquer um dos dois. O sandbox sem token tem um limite próprio de 20 requisições por minuto por IP.

Os endpoints também podem ter regras próprias, como máximo de símbolos, paginação ou acesso condicionado a uma funcionalidade do plano. Confira a documentação do endpoint antes de implementar uma chamada em produção.

Como estimar o consumo mensal

Uma tela que consulta 10 vezes por hora, durante 12 horas por dia e 30 dias, consome aproximadamente 3.600 requisições por mês:

10 chamadas/hora × 12 horas/dia × 30 dias = 3.600 chamadas

Consultar vários tickers na mesma requisição, quando o plano permite, costuma ser mais eficiente do que fazer uma chamada por ativo.

Como acompanhar o uso

O dashboard mostra o consumo e o limite do plano. Trate respostas de limite na aplicação, use cache quando fizer sentido e evite repetir chamadas se o dado ainda está dentro do delay contratado.

Veja os recursos e preços atuais na comparação de planos.