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 originais/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). Ela é implementada de maneira a usar o mínimo de dependências possível (sem pandas, por exemplo) e da maneira mais Pythônica (idiomática) possível, em Português.

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

Para acessar dados do IBGE, é necessário instalar mais dependências. Instale-as com:

pip install mercados[ibge]

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

• IBGE:
  • Séries históricas de Índices (IPCA, IPCA-15 e INPC)
• 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
  • Balancete de fundos de investimento e estruturados
• 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
• Secretaria do Tesouro Nacional:
  • Histórico de preços de títulos
• B3:
  • Valor histórico de diversos índices
  • Cotação diária da negociação em bolsa (um registro por ativo)
  • Preços a cada 5 minutos do último pregão por ativo (com atraso de 15min)
  • Negociações intradiárias em bolsa (um registro por negociação)
  • Cotação diária da negociação em balcão
  • Cadastro de fundos listados (FII, FI-Infra, FI-Agro, FIP, FIDC e ETF)
  • Cadastro de debêntures ativas
  • Cadastro de BDRs listados
  • Informações cadastrais sobre CRAs e CRIs
  • 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

Outras bibliotecas e projetos

Aqui listamos outras bibliotecas concorrentes e/ou que complementam os dados e funcionalidades disponíveis na mercados e que podem ser úteis em análises.

Captura de dados

Existem diversas bibliotecas Python que capturam dados do mercado financeiro brasileiro. Alguns projetos estão abandonados, já outros não são aderentes ao objetivo da mercados, mas talvez possam ser úteis em casos específicos:

• brFinance
• pycvm, pybov e pyibr
• FinLogic e PYield
• stpstone
• cvmpy
• py_financas
• cvm-sqlite
• getDataCVM
• pydemonstrativos
• fundosbr
• fundspy
• anbima_calendar
• pyettj, tesouro_direto_br e comparar_fundos_br
• tradingcomdados (sem repositório Git?)

Análise de dados

• magicformulabr
• stocks-52week-rank
• pytrendseries
• ta-lib
• quantstats
• backtesting.py
• VectorBT

APIs

• Dados de Mercado
• MFinance (repositórios no Github)
• brapi.dev