Limites de taxa e cotas

Cada chave de API do finlight está vinculada a um plano, e o plano define seus limites de uso e quais recursos você pode acessar. Os limites são aplicados por chave de API, em tempo real. Esta página explica cada limite e o que cada plano desbloqueia; para os números exatos do seu plano, consulte o painel do finlight ou a página de preços.

Os quatro limites de uso

Name
Cota mensal de requisições
Description
Cada requisição REST consome uma requisição da sua franquia mensal. O contador é reiniciado no início de cada período de cobrança. Excedê-lo retorna 429 com "Exceeded token limit of N for the current period."
Name
Taxa de pico
Description
Um limite de curto prazo sobre as requisições a cada 10 segundos, que suaviza os picos. Aplicado apenas nos planos que o definem. Excedê-lo retorna 429 com "Exceeded rate limit of N requests per 10 seconds." — recue ~10 s e tente novamente.
Name
Conexões WebSocket
Description
O número máximo de conexões WebSocket simultâneas para sua chave. Novas conexões além do limite são rejeitadas. Um limite separado restringe o número total de mensagens transmitidas por período. O WebSocket requer um plano pago.
Name
Cota de entrega de webhooks
Description
O número máximo de entregas de webhook por período de cobrança. Um limite complementar restringe quantos webhooks você pode criar. Quando a cota de entrega se esgota, as entregas são pausadas até o próximo período.

Recursos desbloqueados pelo seu plano

Além dos limites brutos, seu plano controla quais recursos estão disponíveis. Solicitar um recurso que seu plano não inclui retorna 403 (para REST) ou simplesmente omite os dados (para webhooks/WebSocket).

Name
Dados históricos
Description
Até onde você pode consultar no passado depende do seu plano. Os planos Free e Pro Light cobrem atualmente cerca do último mês de artigos; planos superiores desbloqueiam uma cobertura histórica mais profunda. Use os filtros de data from / to para consultar dentro da janela do seu plano — requisições para datas fora dela simplesmente não retornam resultados para esse intervalo. Consulte a página de preços para a janela histórica exata de cada plano.
Name
Análise de sentimento
Description
Inclui os campos sentiment e confidence nos artigos. Removidos das cargas quando não concedidos.
Name
Entidades de empresa
Description
Inclui o array companies (tickers resolvidos por IA, ISIN, bolsa, etc.) e habilita includeEntities. Removido quando não concedido.
Name
Fontes personalizadas
Description
Fontes de notícias privadas ou específicas do cliente adicionadas ao seu conjunto padrão. Disponível em planos superiores / enterprise.

Como a aplicação funciona

Por chave, em tempo real. Cada requisição incrementa seus contadores; assim que um limite é ultrapassado, a API retorna 429 imediatamente.
O uso do painel não é ao vivo. O uso exibido no painel do finlight é agregado cerca de uma vez por dia e reflete a atividade até o dia anterior — não é um contador em tempo real. A aplicação é ao vivo, então sua cota restante real para hoje pode diferir do que o painel mostra.
Os contadores mensais são reiniciados no início do seu período de cobrança — um 429 de cota é limpo automaticamente.
Sem cabeçalhos de limite de taxa. O finlight atualmente não envia cabeçalhos Retry-After ou X-RateLimit-*. Trate um 429 de pico como "aguarde ~10 segundos"; trate um 429 mensal como "cota atingida neste período". Consulte Erros e códigos de status.

Planos

Plano	Uso típico
Free	Avaliação e uso de baixo volume. Apenas REST (sem WebSocket).
Pro (Light / Standard / Scale)	Cargas de trabalho de produção com cotas crescentes, WebSocket, webhooks e enriquecimento mais completo.
Enterprise	Alto volume, fontes personalizadas e limites sob medida.

Os limites numéricos exatos (tokens mensais, taxa de pico, conexões WebSocket, cota de webhooks) e o conjunto de recursos por plano fazem parte dos preços e podem mudar. Sempre verifique os limites do seu plano atual no painel do finlight, ou compare planos na página de preços. Precisa de limites maiores ou fontes personalizadas? Fale conosco.

Quando você atinge um limite

429 de pico → pause ~10 segundos e continue.
429 de cota mensal → você usou as requisições do período; faça upgrade ou aguarde o reinício.
Conexão WebSocket rejeitada → você está no teto de conexões simultâneas; feche uma conexão ociosa (consulte a opção takeover em Início rápido do WebSocket).
Entregas de webhook pausadas → sua cota de entrega do período se esgotou; ela é retomada no próximo período.
403 em um recurso → essa capacidade não está no seu plano; consulte a tabela acima.

Para os corpos de erro exatos, consulte Erros e códigos de status.