Sobre

cvm é uma biblioteca Python cuja função é extrair os dados de companhias de capital aberto fornecidos pela CVM, assim possibilitando o seu uso em sistemas automatizados. A biblioteca foi projetada para fazer parte de um software para análise de companhias abertas, embora ela possa ser utilizada por conta própria para outros fins.

O que é a CVM?

CVM é a sigla para Comissão de Valores Mobiliários, que é o orgão governamental que define os regulamentos para as companhias de capital aberto. Além de regular e supervisionar tais companhias, a CVM também disponibiliza os seus dados para acesso público.

Documentos da CVM

O Portal de Dados da CVM disponibiliza os seguintes tipos de documentos de companhias abertas:

• Formulário Cadastral (FCA)
• Demonstrações Financeiras Padronizadas (DFP)
• Informações Trimestrais (ITR)
• Formulário de Referência (FRE)
• Informes Periódicos e Eventuais (IPE)
• Informação Cadastral (CAD)

Atualmente, esta biblioteca suporta os documentos FCA, FRE (parcial), DFP e ITR.

Uso

import cvm

with cvm.FCAFile('caminho/para/fca.zip') as file:
    for fca in file:
        print(fca.company_name, 'entregou o documento FCA em', fca.receipt_date)

with cvm.DFPITRFile('caminho/para/dfp_ou_itr.zip') as file:
    for dfpitr in file:
        print(dfpitr.company_name, 'entregou o documento', dfpitr.type.name, 'em', dfpitr.receipt_date)

Note que a biblioteca não foi testada por completo e sua API ainda está instável.

Exemplos mais elaborados de uso estão no diretório samples:

> python -m samples.dfp.print_accounts 'caminho/para/dfp_ou_itr.zip'
> python -m samples.dfp.print_balances 'caminho/para/dfp_ou_itr.zip'