| Name | mercados JSON |
| Version |
0.1.0
JSON |
| download |
| home_page | https://github.com/PythonicCafe/mercados/ |
| Summary | Scrapers para acessar dados do mercado financeiro brasileiro de diversos órgãos (CVM, BCB, B3), como Selic, CDI, IPCA, cadastro de fundos, CRAs, CRIs, debêntures, negociação bolsa e balcão etc. |
| upload_time | 2024-12-09 23:36:40 |
| maintainer | None |
| docs_url | None |
| author | Álvaro Justen |
| requires_python | >=3.7 |
| license | GNU Lesser General Public License v3 (LGPLv3) |
| keywords |
finance
market
data
cvm
bcb
b3
fii
fi-infra
fi-agro
fip
selic
cdi
ipca
igp-m
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
lxml
requests
xmltodict
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# 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.
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:
```shell
pip install mercados
```
O código da `mercados` está licenciado sob [LGPL versão 3](https://www.gnu.org/licenses/lgpl-3.0.pt-br.html). 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. A biblioteca está dividida em módulos, onde cada módulo é responsável por
coletar as informações de um órgão/sistema, por exemplo: `mercados.cvm` coleta dados disponibilizados pela CVM. Veja
a seção [Dados disponíveis](#dados-disponiveis) para mais detalhes. Para exemplos da interface de linha de comando,
veja o script `scripts/smoke-tests.sh`.
> **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*](https://semver.org/).
Caso queira contribuir com o projeto, veja [CONTRIBUTING.md](CONTRIBUTING.md).
## Licença
`mercados` tem como licença a [Licença Pública Geral Menor GNU versão 3 (LGPL
v3)](https://www.gnu.org/licenses/lgpl-3.0.pt-br.html). 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](https://www.gov.br/cvm/pt-br):
- [Notícias](https://www.gov.br/cvm/pt-br/assuntos/noticias)
- [FundosNET](https://fnet.bmfbovespa.com.br/fnet/publico/abrirGerenciadorDocumentosCVM): documentos publicados,
incluindo a extração de alguns tipos de XML
- [RAD](https://www.rad.cvm.gov.br/ENET/frmConsultaExternaCVM.aspx): lista de companhias abertas
- [RAD](https://www.rad.cvm.gov.br/ENET/frmConsultaExternaCVM.aspx): busca por documentos publicados
- [Portal de Dados Abertos](https://dados.cvm.gov.br/): informe diário de fundos de investimento
- [BCB](https://www.bcb.gov.br/):
- Sistema NovoSelic: Ajuste de valor pela Selic por dia ou mês
- [Sistema Gerenciador de Séries
Temporais](https://www3.bcb.gov.br/sgspub/localizarseries/localizarSeries.do?method=prepararTelaLocalizarSeries):
milhares de séries temporais, incluindo Selic, CDI e também publicadas por outros órgãos, como IPCA e IGP-M
- [B3](https://www.b3.com.br/pt_br/para-voce):
- 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
- 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
## Links úteis
### FundosNet
- [Fundos (FIP, FIDC, FII etc.)](https://fnet.bmfbovespa.com.br/fnet/publico/abrirGerenciadorDocumentosCVM)
- [CRA/CRI](https://fnet.bmfbovespa.com.br/fnet/publico/pesquisarGerenciadorDocumentosCertificadosCVM)
- [Manual do sistema](https://www.b3.com.br/data/files/CD/E1/F3/6B/D0CA2810F9BC5928AC094EA8/Manual%20do%20Sistema%20FundosNet%20-%2008.2022-a.pdf)
### B3
- [CRAs listados](https://www.b3.com.br/pt_br/produtos-e-servicos/negociacao/renda-fixa/cra/cras-listados/)
- [CRIs listados](https://www.b3.com.br/pt_br/produtos-e-servicos/negociacao/renda-fixa/cri/cris-listados/)
- [Cotações (2)](https://www.b3.com.br/pt_br/market-data-e-indices/servicos-de-dados/market-data/cotacoes/cotacoes/)
- [Cotações renda fixa](https://www.b3.com.br/pt_br/market-data-e-indices/servicos-de-dados/market-data/cotacoes/renda-fixa/)
- [Cotações](https://www.b3.com.br/pt_br/market-data-e-indices/servicos-de-dados/market-data/cotacoes/)
- [Código ISIN](https://www.b3.com.br/pt_br/market-data-e-indices/servicos-de-dados/market-data/consultas/mercado-a-vista/codigo-isin/pesquisa/)
- [Dados públicos de produtos listados (bolsa e balcão)](https://www.b3.com.br/pt_br/market-data-e-indices/servicos-de-dados/market-data/consultas/boletim-diario/dados-publicos-de-produtos-listados-e-de-balcao/)
- [ETFs listados](https://www.b3.com.br/pt_br/produtos-e-servicos/negociacao/renda-variavel/etf/renda-fixa/etfs-listados/)
- [FIDC histórico fatos relevantes balcão](https://www.b3.com.br/pt_br/produtos-e-servicos/negociacao/renda-variavel/fundos-de-investimentos/fidc/historico-fatos-relevantes-balcao/)
- [FIIs listados](https://www.b3.com.br/pt_br/produtos-e-servicos/negociacao/renda-variavel/fundos-de-investimentos/fii/fiis-listados/)
- [Formador de mercado renda variável](https://www.b3.com.br/pt_br/produtos-e-servicos/negociacao/formador-de-mercado/renda-variavel/)
- [Histórico por pregão](https://www.b3.com.br/pt_br/market-data-e-indices/servicos-de-dados/market-data/historico/boletins-diarios/pesquisa-por-pregao/pesquisa-por-pregao/)
- [Ofertas públicas em andamento](https://www.b3.com.br/pt_br/produtos-e-servicos/solucoes-para-emissores/ofertas-publicas/ofertas-em-andamento/empresas/publicacao-de-ofertas-publicas/)
- [Ofertas públicas encerradas](https://www.b3.com.br/pt_br/produtos-e-servicos/solucoes-para-emissores/ofertas-publicas/ofertas-encerradas/)
- [Plantão de notícias](https://sistemasweb.b3.com.br/PlantaoNoticias/Noticias/Index?agencia=18&SociedadeEmissora=LAVF)
- [Debêntures](https://www.debenture.com.br/exploreosnd/consultaadados/emissoesdedebentures/puhistorico_r.asp)
- [Instrumentos litados](https://arquivos.b3.com.br/tabelas/InstrumentsConsolidated/2024-06-24?lang=pt)
### CETIP
- [Dados](http://estatisticas.cetip.com.br/astec/series_v05/paginas/lum_web_v04_10_03_consulta.asp)
- [Séries históricas](http://estatisticas.cetip.com.br/astec/series_v05/paginas/web_v05_series_introducao.asp?str_Modulo=Ativo&int_Idioma=1&int_Titulo=6&int_NivelBD=2%3E)
### Anbima
- [Debêntures](http://www.debentures.com.br/)
Raw data
{
"_id": null,
"home_page": "https://github.com/PythonicCafe/mercados/",
"name": "mercados",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "finance market data CVM BCB B3 FII FI-Infra FI-Agro FIP Selic CDI IPCA IGP-M",
"author": "\u00c1lvaro Justen",
"author_email": "alvarojusten@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/23/16/66d3fbcc8ff4d78d0e241f5ee5e198dbd0e92de693f3598ba2eb8137e834/mercados-0.1.0.tar.gz",
"platform": null,
"description": "# mercados\n\n`mercados` \u00e9 uma biblioteca em Python e uma interface de linha de comando (CLI) para baixar, extrair e limpar dados do\nmercado financeiro brasileiro de diversas organiza\u00e7\u00f5es, como Comiss\u00e3o de Valores Mobili\u00e1rios (CVM), Bolsa, Brasil e\nBalc\u00e3o (B3) e Banco Central do Brasil (BCB). A biblioteca foi desenvolvida ao longo dos \u00faltimos anos, j\u00e1 \u00e9 utilizada em\nsistemas que est\u00e3o em produ\u00e7\u00e3o e tem como objetivo ser a melhor, mais robusta e f\u00e1cil op\u00e7\u00e3o para acessar dados do\nmercado financeiro e macroecon\u00f4micos de maneira program\u00e1tica.\n\nA biblioteca \u00e9 desenvolvida e testada em sistema Debian GNU/Linux com Python 3.11. \u00c9 poss\u00edvel que funcione em vers\u00f5es\nmais recentes e em algumas anteriores sem problemas; como ela \u00e9 feita totalmente em Python, tamb\u00e9m deve funcionar sem\nproblemas em outros sistemas, como Windows e Mac OS X. Instale-a executando:\n\n```shell\npip install mercados\n```\n\nO c\u00f3digo da `mercados` est\u00e1 licenciado sob [LGPL vers\u00e3o 3](https://www.gnu.org/licenses/lgpl-3.0.pt-br.html). Voc\u00ea s\u00f3\ndeve utiliz\u00e1-la se aceitar os termos da licen\u00e7a (veja mais detalhes na se\u00e7\u00e3o abaixo).\n\nA documenta\u00e7\u00e3o ainda est\u00e1 em desenvolvimento. A biblioteca est\u00e1 dividida em m\u00f3dulos, onde cada m\u00f3dulo \u00e9 respons\u00e1vel por\ncoletar as informa\u00e7\u00f5es de um \u00f3rg\u00e3o/sistema, por exemplo: `mercados.cvm` coleta dados disponibilizados pela CVM. Veja\na se\u00e7\u00e3o [Dados dispon\u00edveis](#dados-disponiveis) para mais detalhes. Para exemplos da interface de linha de comando,\nveja o script `scripts/smoke-tests.sh`.\n\n> **Aten\u00e7\u00e3o**: apesar de todo o c\u00f3digo funcionar e de ter sido testado em diversos sistemas em produ\u00e7\u00e3o que o utilizam,\n> algumas mudan\u00e7as poder\u00e3o acontecer na interface da biblioteca at\u00e9 que ela atinja a vers\u00e3o `1.0.0`, ou seja, atente-se\n> a atualiza\u00e7\u00f5es. Veja mais detalhes sobre o versionamento adotado em [*semantic versioning*](https://semver.org/).\n\nCaso queira contribuir com o projeto, veja [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## Licen\u00e7a\n\n`mercados` tem como licen\u00e7a a [Licen\u00e7a P\u00fablica Geral Menor GNU vers\u00e3o 3 (LGPL\nv3)](https://www.gnu.org/licenses/lgpl-3.0.pt-br.html). Em resumo:\n\n**\u2705 O que voc\u00ea pode fazer:**\n- Usar a biblioteca em projetos propriet\u00e1rios ou livres\n- Modificar o c\u00f3digo-fonte da biblioteca\n- Distribuir a biblioteca original ou modificada em conjunto com um outro programa, desde que:\n - Notifique seu usu\u00e1rio de que a biblioteca \u00e9 usada no seu programa e est\u00e1 licenciada sob LGPL v3\n - Forne\u00e7a uma c\u00f3pia da LGPL v3 junto com a distribui\u00e7\u00e3o do seu programa\n\n**\ud83d\udeab O que voc\u00ea n\u00e3o pode fazer:**\n- Restringir a liberdade do usu\u00e1rio do seu programa de modificar a biblioteca\n- Distribuir a biblioteca (original ou modificada) sem fornecer o c\u00f3digo-fonte\n- Incorporar partes significativas da biblioteca no seu c\u00f3digo sem informar e fornecer a licen\u00e7a\n\n## Dados dispon\u00edveis\n\n- [CVM](https://www.gov.br/cvm/pt-br):\n - [Not\u00edcias](https://www.gov.br/cvm/pt-br/assuntos/noticias)\n - [FundosNET](https://fnet.bmfbovespa.com.br/fnet/publico/abrirGerenciadorDocumentosCVM): documentos publicados,\n incluindo a extra\u00e7\u00e3o de alguns tipos de XML\n - [RAD](https://www.rad.cvm.gov.br/ENET/frmConsultaExternaCVM.aspx): lista de companhias abertas\n - [RAD](https://www.rad.cvm.gov.br/ENET/frmConsultaExternaCVM.aspx): busca por documentos publicados\n - [Portal de Dados Abertos](https://dados.cvm.gov.br/): informe di\u00e1rio de fundos de investimento\n- [BCB](https://www.bcb.gov.br/):\n - Sistema NovoSelic: Ajuste de valor pela Selic por dia ou m\u00eas\n - [Sistema Gerenciador de S\u00e9ries\n Temporais](https://www3.bcb.gov.br/sgspub/localizarseries/localizarSeries.do?method=prepararTelaLocalizarSeries):\n milhares de s\u00e9ries temporais, incluindo Selic, CDI e tamb\u00e9m publicadas por outros \u00f3rg\u00e3os, como IPCA e IGP-M\n- [B3](https://www.b3.com.br/pt_br/para-voce):\n - Cota\u00e7\u00e3o di\u00e1ria da negocia\u00e7\u00e3o em bolsa (um registro por ativo)\n - Micro-dados de negocia\u00e7\u00e3o em bolsa (*intraday*, um registro por negocia\u00e7\u00e3o)\n - Cota\u00e7\u00e3o di\u00e1ria da negocia\u00e7\u00e3o em balc\u00e3o\n - Cadastro de fundos listados\n - Cadastro de deb\u00eantures ativas\n - Informa\u00e7\u00f5es cadastrais sobre CRAs, CRIs, FIIs, FI-Infras, FI-Agros e FIPs listados\n - Documentos de CRAs, CRIs, FIIs, FI-Infras, FI-Agros e FIPs listados\n - Dividendos de FI-Infras e FI-Agros\n\n\n## Links \u00fateis\n\n### FundosNet\n\n- [Fundos (FIP, FIDC, FII etc.)](https://fnet.bmfbovespa.com.br/fnet/publico/abrirGerenciadorDocumentosCVM)\n- [CRA/CRI](https://fnet.bmfbovespa.com.br/fnet/publico/pesquisarGerenciadorDocumentosCertificadosCVM)\n- [Manual do sistema](https://www.b3.com.br/data/files/CD/E1/F3/6B/D0CA2810F9BC5928AC094EA8/Manual%20do%20Sistema%20FundosNet%20-%2008.2022-a.pdf)\n\n### B3\n\n- [CRAs listados](https://www.b3.com.br/pt_br/produtos-e-servicos/negociacao/renda-fixa/cra/cras-listados/)\n- [CRIs listados](https://www.b3.com.br/pt_br/produtos-e-servicos/negociacao/renda-fixa/cri/cris-listados/)\n- [Cota\u00e7\u00f5es (2)](https://www.b3.com.br/pt_br/market-data-e-indices/servicos-de-dados/market-data/cotacoes/cotacoes/)\n- [Cota\u00e7\u00f5es renda fixa](https://www.b3.com.br/pt_br/market-data-e-indices/servicos-de-dados/market-data/cotacoes/renda-fixa/)\n- [Cota\u00e7\u00f5es](https://www.b3.com.br/pt_br/market-data-e-indices/servicos-de-dados/market-data/cotacoes/)\n- [C\u00f3digo ISIN](https://www.b3.com.br/pt_br/market-data-e-indices/servicos-de-dados/market-data/consultas/mercado-a-vista/codigo-isin/pesquisa/)\n- [Dados p\u00fablicos de produtos listados (bolsa e balc\u00e3o)](https://www.b3.com.br/pt_br/market-data-e-indices/servicos-de-dados/market-data/consultas/boletim-diario/dados-publicos-de-produtos-listados-e-de-balcao/)\n- [ETFs listados](https://www.b3.com.br/pt_br/produtos-e-servicos/negociacao/renda-variavel/etf/renda-fixa/etfs-listados/)\n- [FIDC hist\u00f3rico fatos relevantes balc\u00e3o](https://www.b3.com.br/pt_br/produtos-e-servicos/negociacao/renda-variavel/fundos-de-investimentos/fidc/historico-fatos-relevantes-balcao/)\n- [FIIs listados](https://www.b3.com.br/pt_br/produtos-e-servicos/negociacao/renda-variavel/fundos-de-investimentos/fii/fiis-listados/)\n- [Formador de mercado renda vari\u00e1vel](https://www.b3.com.br/pt_br/produtos-e-servicos/negociacao/formador-de-mercado/renda-variavel/)\n- [Hist\u00f3rico por preg\u00e3o](https://www.b3.com.br/pt_br/market-data-e-indices/servicos-de-dados/market-data/historico/boletins-diarios/pesquisa-por-pregao/pesquisa-por-pregao/)\n- [Ofertas p\u00fablicas em andamento](https://www.b3.com.br/pt_br/produtos-e-servicos/solucoes-para-emissores/ofertas-publicas/ofertas-em-andamento/empresas/publicacao-de-ofertas-publicas/)\n- [Ofertas p\u00fablicas encerradas](https://www.b3.com.br/pt_br/produtos-e-servicos/solucoes-para-emissores/ofertas-publicas/ofertas-encerradas/)\n- [Plant\u00e3o de not\u00edcias](https://sistemasweb.b3.com.br/PlantaoNoticias/Noticias/Index?agencia=18&SociedadeEmissora=LAVF)\n- [Deb\u00eantures](https://www.debenture.com.br/exploreosnd/consultaadados/emissoesdedebentures/puhistorico_r.asp)\n- [Instrumentos litados](https://arquivos.b3.com.br/tabelas/InstrumentsConsolidated/2024-06-24?lang=pt)\n\n### CETIP\n\n- [Dados](http://estatisticas.cetip.com.br/astec/series_v05/paginas/lum_web_v04_10_03_consulta.asp)\n- [S\u00e9ries hist\u00f3ricas](http://estatisticas.cetip.com.br/astec/series_v05/paginas/web_v05_series_introducao.asp?str_Modulo=Ativo&int_Idioma=1&int_Titulo=6&int_NivelBD=2%3E)\n\n### Anbima\n\n- [Deb\u00eantures](http://www.debentures.com.br/)\n",
"bugtrack_url": null,
"license": "GNU Lesser General Public License v3 (LGPLv3)",
"summary": "Scrapers para acessar dados do mercado financeiro brasileiro de diversos \u00f3rg\u00e3os (CVM, BCB, B3), como Selic, CDI, IPCA, cadastro de fundos, CRAs, CRIs, deb\u00eantures, negocia\u00e7\u00e3o bolsa e balc\u00e3o etc.",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/PythonicCafe/mercados/"
},
"split_keywords": [
"finance",
"market",
"data",
"cvm",
"bcb",
"b3",
"fii",
"fi-infra",
"fi-agro",
"fip",
"selic",
"cdi",
"ipca",
"igp-m"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "400c1b2aa76defce4c567562360e4a844a6e4177168f210f918f1822ad0a7038",
"md5": "68b993acb077711bc8f44b7baad5e041",
"sha256": "1196ac247b39ea31249208ab8351382362ee66e6f5a7a1a194307d09fe740e58"
},
"downloads": -1,
"filename": "mercados-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "68b993acb077711bc8f44b7baad5e041",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 45392,
"upload_time": "2024-12-09T23:36:38",
"upload_time_iso_8601": "2024-12-09T23:36:38.040466Z",
"url": "https://files.pythonhosted.org/packages/40/0c/1b2aa76defce4c567562360e4a844a6e4177168f210f918f1822ad0a7038/mercados-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "231666d3fbcc8ff4d78d0e241f5ee5e198dbd0e92de693f3598ba2eb8137e834",
"md5": "71953e6fb9702544e9bbf59618e1927d",
"sha256": "12231902d67fef2f7e34ab71349cb6761c74ea64e2d7c7d309440b46a4ee4618"
},
"downloads": -1,
"filename": "mercados-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "71953e6fb9702544e9bbf59618e1927d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 45912,
"upload_time": "2024-12-09T23:36:40",
"upload_time_iso_8601": "2024-12-09T23:36:40.868341Z",
"url": "https://files.pythonhosted.org/packages/23/16/66d3fbcc8ff4d78d0e241f5ee5e198dbd0e92de693f3598ba2eb8137e834/mercados-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-09 23:36:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "PythonicCafe",
"github_project": "mercados",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "lxml",
"specs": [
[
"<",
"6.0.0"
],
[
">=",
"5.2.1"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.31.0"
],
[
"<",
"3.0.0"
]
]
},
{
"name": "xmltodict",
"specs": [
[
"==",
"0.13.0"
]
]
}
],
"lcname": "mercados"
}
