mercados

mercados é uma biblioteca em Python e uma interface de linha de comando (CLI) para baixar, extrair e limpar dados do mercado financeiro brasileiro de diversas organizações, como Comissão de Valores Mobiliários (CVM), Bolsa, Brasil e Balcão (B3) e Banco Central do Brasil (BCB). A biblioteca foi desenvolvida ao longo dos últimos anos, já é utilizada em sistemas que estão em produção e tem como objetivo ser a melhor, mais robusta e fácil opção para acessar dados do mercado financeiro e macroeconômicos de maneira programática. O foco da biblioteca é coletar e tratar as informações nas fontes oficiais e apenas de dados que sejam abertos/gratuitos. Por isso, não possui dados que são vendidos (como os que são em tempo real).

A biblioteca é desenvolvida e testada em sistema Debian GNU/Linux com Python 3.11. É possível que funcione em versões mais recentes e em algumas anteriores sem problemas; como ela é feita totalmente em Python, também deve funcionar sem problemas em outros sistemas, como Windows e Mac OS X. Instale-a executando:

pip install mercados

O código da mercados está licenciado sob LGPL versão 3. Você só deve utilizá-la se aceitar os termos da licença (veja mais detalhes na seção abaixo).

A documentação ainda está em desenvolvimento (veja o material em construção em docs/tutorial.md).

Atenção: apesar de todo o código funcionar e de ter sido testado em diversos sistemas em produção que o utilizam, algumas mudanças poderão acontecer na interface da biblioteca até que ela atinja a versão 1.0.0, ou seja, atente-se a atualizações. Veja mais detalhes sobre o versionamento adotado em semantic versioning.

Caso queira contribuir com o projeto, veja CONTRIBUTING.md.

Licença

mercados tem como licença a Licença Pública Geral Menor GNU versão 3 (LGPL v3). Em resumo:

✅ O que você pode fazer:

• Usar a biblioteca em projetos proprietários ou livres
• Modificar o código-fonte da biblioteca
• Distribuir a biblioteca original ou modificada em conjunto com um outro programa, desde que:
  • Notifique seu usuário de que a biblioteca é usada no seu programa e está licenciada sob LGPL v3
  • Forneça uma cópia da LGPL v3 junto com a distribuição do seu programa

🚫 O que você não pode fazer:

• Restringir a liberdade do usuário do seu programa de modificar a biblioteca
• Distribuir a biblioteca (original ou modificada) sem fornecer o código-fonte
• Incorporar partes significativas da biblioteca no seu código sem informar e fornecer a licença

Dados disponíveis

• CVM:
  • Notícias
  • FundosNET: documentos publicados, incluindo a extração de alguns tipos de XML
  • RAD: lista de companhias abertas
  • RAD: busca por documentos publicados
  • Portal de Dados Abertos: informe diário de fundos de investimento
• BCB:
  • Sistema NovoSelic: Ajuste de valor pela Selic por dia ou mês
  • Sistema Gerenciador de Séries Temporais: milhares de séries temporais, incluindo Selic, CDI e também publicadas por outros órgãos, como IPCA e IGP-M
• B3:
  • Cotação diária da negociação em bolsa (um registro por ativo)
  • Micro-dados de negociação em bolsa (intraday, um registro por negociação)
  • Cotação diária da negociação em balcão
  • Cadastro de fundos listados
  • Cadastro de debêntures ativas
  • Cadastro de BDRs listadas
  • Informações cadastrais sobre CRAs, CRIs, FIIs, FI-Infras, FI-Agros e FIPs listados
  • Documentos de CRAs, CRIs, FIIs, FI-Infras, FI-Agros e FIPs listados
  • Dividendos de FI-Infras e FI-Agros
  • Clearing (diversas informações)

Links úteis

FundosNet

• Fundos (FIP, FIDC, FII etc.)
• CRA/CRI
• Manual do sistema

B3

• CRAs listados
• CRIs listados
• Cotações (2)
• Cotações renda fixa
• Cotações
• Código ISIN
• Dados públicos de produtos listados (bolsa e balcão)
• ETFs listados
• FIDC histórico fatos relevantes balcão
• FIIs listados
• Formador de mercado renda variável
• Histórico por pregão
• Ofertas públicas em andamento
• Ofertas públicas encerradas
• Plantão de notícias
• Debêntures
• Instrumentos listados

CETIP

• Dados
• Séries históricas

Anbima

• Debêntures