Cinco etapas, uma trilha de conferência
O mesmo pipeline Python é usado para o case e para cada novo envio.
- 01
Receber
Preservar o CSV e conferir o formato da extração.
- 02
Tratar
Padronizar datas, códigos e números; registrar inconsistências.
- 03
Confirmar
Consultar evidências da B3 nas datas utilizadas.
- 04
Calcular
Selecionar a semana, calcular retornos e ordenar as ações.
- 05
Apresentar
Publicar o resultado junto às exclusões e arquivos derivados.
Economatica · preços
Fornece os fechamentos ajustados e as demais observações da extração. Os retornos usam exclusivamente esses preços.
B3 · classificação
Confirma a espécie do instrumento com arquivos datados. Os preços da B3 não substituem os da Economatica.
O que significa “última semana”?
A data de referência determina a semana-calendário anterior, de segunda a domingo.
Semana completa PRINCIPAL
Do último fechamento antes da semana ao último fechamento dentro dela. Inclui a variação do primeiro pregão.
Dentro da semana ALTERNATIVA
Do primeiro ao último fechamento dentro da semana. Mostra quanto a interpretação do período muda o resultado.
As datas exatas vêm da extração. O processo verifica a cobertura das pontas e exige revisão quando a semana termina antes da sexta-feira; feriados e preços ausentes não são preenchidos.
Quem entra — e por que alguns ficam fora
As contagens abaixo se referem à janela principal.
Ações elegíveis
Entram ações ordinárias (ON) e preferenciais (PN) confirmadas, com fechamento positivo válido nas duas pontas. ON é a espécie com direito a voto; PN tem as preferências definidas para essa espécie.
Limites do universo
Units, BDRs e outros instrumentos ficam fora da definição adotada. Não há filtro de liquidez: uma grande alta pode pertencer a uma ação pouco negociada. A amostra não representa todo o mercado.
Motivos de ausência de duas pontas
Uma classificação sem confirmação não é convertida em ação por suposição. Se impedir a definição segura do universo, a execução falha com um motivo explícito.
Como uma ação recebe seu retorno
Exemplo real desta execução, usando a primeira ação do ranking principal.
Ordenação e média
Os retornos são calculados sem arredondamento, ordenados do maior para o menor e desempates usam o ticker. A média do top 20 é a soma dos retornos dessas ações dividida pela quantidade de ações do top.
Gráficos diários
O retorno diário compara fechamentos ajustados de datas consecutivas da extração. Se faltar um dos preços, a comparação fica ausente. A série diária não altera o ranking semanal.
O arredondamento ocorre na exibição. Somar percentuais diários não reproduz o retorno semanal: retornos sucessivos se acumulam por multiplicação.
Alertas não são correções silenciosas
Os registros permanecem rastreáveis; cada ocorrência informa o código, a data, o campo e o motivo.
Estrutura e leitura
Nove colunas na ordem documentada, vírgula como separador, Windows-1252 ou UTF-8. Mudança de esquema interrompe a leitura.
Datas e preços
Datas inválidas ou futuras, preços não positivos, campos ausentes e valores fora do intervalo mínimo–máximo são sinalizados.
Chaves e cobertura
A granularidade é ativo × data. Duplicatas são registradas; uma queda acentuada de cobertura exige atenção nas pontas do cálculo.
Preservação
Ausência não vira zero nem último preço conhecido. Cada nova extração gera uma versão independente, pois preços ajustados podem ser revistos.
Ocorrências nos ativos do top 20 principal
Um alerta em preço médio não implica erro no fechamento usado no retorno. A ocorrência permanece visível para conferência; o contexto completo está no arquivo de alertas.
Confira os números e reproduza a execução
Escolha o arquivo conforme a pergunta que quer verificar.
Identificação do arquivo e versão do código
A assinatura SHA-256 identifica o conteúdo recebido. Um arquivo com conteúdo diferente tem outra assinatura. Ela permite conferir a origem sem publicar o CSV bruto.
O README do GitHub documenta o comando Python, os parâmetros, os arquivos oficiais da B3 e as saídas. Para comparar execuções, use a mesma entrada, data de referência, referências B3 e versão do código.
Abrir instruções de reprodução ↗