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
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
Anbima
Metadata
Release files for mercados 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mercados-0.2.0.tar.gz | 50.4 kB | Without provenance | Details for mercados-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mercados-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for mercados-0.2.0-py3-none-any.whl |
Total release size: 100.2 kB
Release files / mercados-0.2.0.tar.gz
| Download URL | mercados-0.2.0.tar.gz |
|---|---|
| Size | 50.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6ee9d99720c5b6a1975776d831011da9cb01a23f4458ad65aee522b62037a351
|
|
BLAKE2b-256 checksum How to use checksums |
12b07682a9f9c08c33cc8930ac0489ae8e63621ce87a16a2c44a16c0f63eb3d1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.0.1 CPython/3.11.10
|
Release files / mercados-0.2.0-py3-none-any.whl
| Download URL | mercados-0.2.0-py3-none-any.whl |
|---|---|
| Size | 49.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ad012363133032aed4db97f192ca2428eb11d320a8a28aa845a3f49d3e5171aa
|
|
BLAKE2b-256 checksum How to use checksums |
c012f7edc7cf803342b1c20e452aa88cc388f2b811e7d958ff0d4b15bd0fdc99
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.0.1 CPython/3.11.10
|
Security for mercados 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.