Limites de uso
Quantas chamadas a API aceita por minuto e por dia, quanto custa cada operação e o que acontece ao atingir o limite.
Os limites são consumidos em chamadas autenticadas através da chave de API, o que inclui a CLI, as skills e integrações diretas com a API. Eles são consumidos por conta, então todas as suas chaves compartilham as mesmas janelas. Os valores abaixo estão sujeitos a mudanças.
Janelas e tetos
| Janela | Requisições | Unidades |
|---|---|---|
| Por minuto | 30 | 60 |
| Por dia | 500 | 1.000 |
Cada chamada consome 1 requisição nas duas janelas. Além das requisições, cada operação tem um custo em unidades conforme o peso do processamento. Operações padrão custam 1 unidade e operações pesadas custam 10. A janela por minuto acompanha o relógio e reinicia a cada minuto cheio. A janela diária reinicia à meia-noite UTC, 21h no horário de Brasília.
Comandos operacionais da instalação local, como quantbrasil capabilities e quantbrasil profile show, não consultam a API e não consomem os limites.
Operações pesadas
As operações abaixo custam 10 unidades por chamada. Todas as demais operações da referência de comandos custam 1 unidade, incluindo as de alteração, como criar watchlists e carteiras.
| Comando | O que faz |
|---|---|
quantbrasil inspect | Inspeciona um ativo com dados, métricas, notícias e insights |
quantbrasil news analyze | Analisa notícias recentes por relevância e sentimento |
quantbrasil backtests run | Executa e salva um backtest |
quantbrasil rankings current | Consulta o topo atual de um ranking |
quantbrasil rankings return | Calcula o retorno histórico de um ranking do sistema |
quantbrasil screening run | Executa screening de indicadores em um universo |
quantbrasil cointegration pair | Calcula cointegração para análise de Long & Short |
quantbrasil holdings historical-return | Calcula o retorno histórico de uma carteira salva |
quantbrasil holdings beta | Calcula o beta da carteira contra o IBOV |
quantbrasil holdings var | Calcula o Value-at-Risk de um dia para a carteira |
Ao atingir o limite
Quando uma janela estoura, a API responde com HTTP 429 e a CLI encerra com o erro rate_limited, informando em quantos segundos vale tentar de novo. Com --json, o payload de erro inclui retry_after_seconds, o que permite programar a espera em scripts. Integrações diretas com a API também recebem os cabeçalhos Retry-After, X-RateLimit-Limit e X-RateLimit-Reset na resposta 429.
Em scripts e agentes, prefira o comando mais simples que responde à pergunta. Um preço pontual custa menos do que uma visão completa do ativo, e um relatório pesado irá consumir mais do limite.