CIRVA é um sistema automatizado de análise quantitativa que processa demonstrativos financeiros públicos da CVM (Comissão de Valores Mobiliários) — incluindo DRE, Balanço Patrimonial e Capital Social — e gera um Score proprietário para ranquear empresas listadas na B3.
Este repositĂłrio nĂŁo contĂ©m o motor de análise, que Ă© mantido como propriedade intelectual privada. Aqui vocĂŞ encontrará apenas a saĂda processada do pipeline, disponibilizada em arquivos .csv. O objetivo deste repositĂłrio Ă© servir como portfĂłlio tĂ©cnico de dados, demonstrando capacidade de estruturação, limpeza e análise de dados financeiros complexos.
🔠Roadmap: uma interface web simples para visualização dos rankings está planejada para versões futuras.
| Fonte | Descrição |
|---|---|
| CVM | Dados brutos extraĂdos diretamente do portal da CVM, limpos e normalizados internamente pelo pipeline. |
| yfinance | Preços de mercado atualizados, consumidos via API do yfinance. |
Destaque metodológico: o cruzamento entre o CNPJ das empresas (padrão CVM) e o Ticker de negociação (padrão B3) foi realizado por meio de mapeamento manual e minucioso, feito diretamente pelo autor — processo que garante maior confiabilidade na junção das duas fontes, dada a inexistência de um identificador público unificado entre elas.
O sistema fechado (nĂŁo incluso neste repositĂłrio) foi construĂdo em Python 3.13.7, utilizando as seguintes bibliotecas principais para engenharia de dados:
pandas— manipulação e transformação de dados tabularesnumpy— operações numéricas e vetorizadasyfinance— coleta de preços e dados de mercadorequests— requisições HTTP para coleta de dados da CVMbeautifulsoup4— parsing e extração de dados HTMLpeewee— ORM leve para persistência de dados estruturados
O resultado final é um CSV ranqueando as empresas por suas respectivas pontuações, mas há uma intenção de se gerar um site futuramente para auxiliar a visualização
.
├── dados/
├── historico/
└── scripts/
Contém arquivos CSV com o desempenho das diferentes carteiras utilizadas no projeto, sejam elas baseadas em dados reais ou em simulações hipotéticas. Esses arquivos servem como base para a geração dos gráficos e das métricas apresentadas no repositório.
Contém arquivos CSV com o histórico detalhado de cada portfólio, incluindo a composição da carteira ao longo do tempo, a distribuição dos ativos e o ranking das empresas avaliadas. Por questões de confidencialidade, algumas informações presentes nas análises originais foram removidas ou ocultadas.
Reúne os scripts responsáveis pela geração automática dos gráficos e demais artefatos do projeto. Esses scripts são executados por meio do GitHub Actions, mantendo os resultados do repositório sempre atualizados.
Os gráficos abaixo ilustram a simulação de desemepenho hipotético de diferentes carteiras ao longo do tempo.
dolar: 100% dolardow_jones: Índice Dow Jonesfrankfurt: Índice Frankfurtibovespa: Índice Bovesparesultados_completos: Carteira CIRVA considerando os preços do yfinance (teste automático), que é corrigido por eventos (grupamentos, desdobramentos) e bonificações (dividendos)resultados_especulativos: Carteira CIRVA considerando os preços do Investing.com/TradingView (teste manual), que é corrigido por eventos (grupamentos, desdobramentos) sem considerar bonificaçõess&p500: Índice S&P500selic: Taxa SELIC
O gráfico abaixo faz uma comparação entre o CIRVA e bolsas globais
O gráfico abaixo faz uma comparação entre o CIRVA e Ăndices brasileiros
O gráfico abaixo faz uma comparação entre o CIRVA e Ăndices macroeconĂ´micos
O gráfico abaixo faz uma comparação completa de todos os Ăndices
Este gráfico especĂfico se propõe a acompanhar o desempenho da carteira na realidade, ou seja, o dono deste repositĂłrio irá operar seguindo exatamente esta estratĂ©gia e reportará os dados.
Este repositório não constitui, sob nenhuma hipótese, recomendação de investimento.
O autor não é assessor de investimentos licenciado pela CVM, nem Analista CNPI (Certificação Nacional do Profissional de Investimento). Todo o conteúdo aqui publicado tem finalidade estritamente educacional e de demonstração técnica de portfólio de engenharia e análise de dados.
Os dados, scores, rankings e gráficos disponibilizados não representam sugestão de compra, venda ou manutenção de qualquer ativo financeiro. Decisões de investimento são de inteira responsabilidade do leitor, que deve consultar um profissional devidamente licenciado antes de tomar qualquer decisão financeira.
Delay intencional: para reforçar o caráter nĂŁo-consultivo deste material e evitar qualquer interpretação como "dica de mercado" em tempo real, todos os relatĂłrios, gráficos e rankings publicados possuem um atraso mĂnimo de 1 (um) mĂŞs em relação Ă data de cálculo. Exemplo: um cálculo realizado em novembro sĂł Ă© publicado em dezembro.
CIRVA(Capital and Performance Indicators for Stock Valuation, in english) is an automated quantitative analysis system that processes public financial statements from CVM (Brazil's Securities and Exchange Commission) — including income statements, balance sheets, and share capital data — to generate a proprietary Score ranking companies listed on B3 (the Brazilian stock exchange).
This repository does not contain the analysis engine, which is maintained as private intellectual property. What you'll find here is the processed output of the pipeline, published as .csv files. The purpose of this repository is to serve as a technical data portfolio, showcasing the ability to structure, clean, and analyze complex financial data.
đź” Roadmap: a simple web interface for visualizing rankings is planned for future releases.
| Source | Description |
|---|---|
| CVM | Raw data extracted directly from CVM's public portal, cleaned and normalized internally by the pipeline. |
| yfinance | Updated market prices, consumed via the yfinance API. |
Methodological highlight: the mapping between company CNPJ (CVM standard identifier) and trading Ticker (B3 standard) was performed through careful, manual mapping by the author — a process that ensures higher reliability when joining both data sources, given the lack of a unified public identifier between them.
The closed-source system (not included in this repository) was built in Python 3.13.7, using the following core libraries for data engineering:
pandas— tabular data manipulation and transformationnumpy— numerical and vectorized operationsyfinance— market price and data collectionrequests— HTTP requests for CVM data collectionbeautifulsoup4— HTML parsing and data extractionpeewee— lightweight ORM for structured data persistence
The final result is a CSV file ranking companies by their respective scores, but there are plans to create a website in the future to facilitate visualization.
.
├── dados/
├── historico/
└── scripts/
Contains CSV files with the performance of different portfolios used in the project, based on either real-world data or hypothetical simulations. These files are used as the source for generating the charts and performance metrics presented in this repository.
Contains CSV files with the detailed history of each portfolio, including portfolio composition over time, asset allocation, and the ranking of evaluated companies. For confidentiality reasons, some information from the original analysis files has been removed or anonymized.
Contains the scripts responsible for automatically generating the project's charts and other artifacts. These scripts are executed through GitHub Actions, keeping the repository's results up to date.
The graphs below illustrate the hypothetical performance simulation of different portfolios over time.
dolar: Dolar Indexdow_jones: Dow Jones Indexfrankfurt: Frankfurt Indexibovespa: Bovespa Indexresultados_completos: CIRVA portfolio based on yfinance prices (automated test), adjusted for corporate events (reverse splits, stock splits) and distributions (dividends).resultados_especulativos: CIRVA portfolio based on Investing.com/TradingView prices (manual test) — adjusted for corporate actions (reverse splits, stock splits) but excluding stock dividends/bonus shares.s&p500: S&P500 Indexselic: The benchmark interest rate in Brazil
The graph below compares CIRVA with global stock markets.
The graph below compares CIRVA with Brazilian indexes.
The graph below compares CIRVA with macroeconomic indexes.
The graph below provides a comprehensive comparison of all the indexes.
This specific chart aims to track the portfolio's actual performance; in other words, the owner of this repository will trade using this exact strategy and report the data.
This repository does not, under any circumstances, constitute investment advice.
The author is not a licensed investment advisor registered with CVM, nor a CNPI-certified analyst (Brazilian National Investment Professional Certification). All content published here is intended strictly for educational purposes and technical portfolio demonstration of data engineering and analysis skills.
The data, scores, rankings, and charts provided do not represent a recommendation to buy, sell, or hold any financial asset. Investment decisions are the sole responsibility of the reader, who should consult a duly licensed professional before making any financial decision.
Intentional delay: to reinforce the non-advisory nature of this material and avoid any interpretation as real-time "market tips," all reports, charts, and rankings published carry a minimum delay of 1 (one) month relative to the calculation date. Example: a calculation performed on November is only published in December.
© 2026 — CIRVA Project. Distributed for portfolio and educational demonstration purposes only.
