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.
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 mercadosO 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.
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
- 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
- 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 litados