brasil-data

Fontes de dados do mercado financeiro brasileiro

Instalação

pip install brasil-data

Como usar

Após a instalação você pode importar a biblioteca diretamente para seu código:

import brdata

O que brdata faz?

brdata.b3: Extrai índices da B3.
- b3.list_indexes(): Lista os índices da B3 disponíveis.
- b3.download_index(valid_index, path=None, theoretical=True): Retorna os dados de um índice ou salva o JSON quando path é informado. Use theoretical=False para a carteira do dia.
- b3.download_indexes(index_list: list[str], path=None, theoretical=True): Retorna os dados de uma lista de índices válidos ou salva os JSONs quando path é informado. Use theoretical=False para a carteira do dia.
brdata.cvm: Download de formulários da CVM (DFP, ITR, FRE, FCA, VLMO) .
- cvm.dataset(year, dataset_type): Baixa um dataset baseado no ano.
- cvm.datasets_in_range(dataset_type, start_year, last_year): Baixa uma série de datasets dentro de um range de anos.
brdata.bacen: Extrai dados do bacen (Taxa Selic Meta e Diária, Boletim Focus).
- bacen.selic.fetch_selic(category, start_date, end_date, path): Retorna os dados da selic meta ou diária, de acordo com o que é passado em category, ou salva o JSON quando path é informado.
- bacen.copom.fetch_copom_table(path): retorna a tabela de histórico taxas de juros, ou salva o JSON quando path é informado.
- bacen.currency.currency_price(currency, price_data, end_price_date, top, path): Retorna os boletins diários com Paridade de venda, Cotação da compra e a Cotação da venda para a data ou período da moeda consultada, ou salva o JSON quando path é informado. top corresponde ao limite de registros.
- bacen.currency.list_available_currencies(): Lista as moedas disponiveis para consulta.
- bacen.boletim_focus: Retorna dados do boletim focus de acordo com o endpoint passado, ou salva o JSON quando path é informado. Como usar:
```
from brdata.bacen.boletim_focus import BoletimFocus

focus = BoletimFocus()
focus.expectativas_mensais(
    indicador = "IPCA",
    start_date = "2024-01-01",
    end_date = "2025-01-01",
    top = 10000,
    path = "data/boletim_focus"
) 
```

Colaboradores

_{Gabriel Guarisa}

_{Davi Guarisa}

Metadata

Release files for brasil-data 5.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for brasil-data 5.0.1
File	Size	Uploaded	Provenance
brasil_data-5.0.1.tar.gz	90.0 kB	Sep 3, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for brasil-data 5.0.1
File	Interpreter	ABI	Platform	Reset
brasil_data-5.0.1-py3-none-any.whl 13.6 kB Sep 3, 2026 Without provenance	Python 3	none	any	Details

Total release size: 103.7 kB

Release files / brasil_data-5.0.1.tar.gz

Download URL	brasil_data-5.0.1.tar.gz
Size	90.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`9b2385d8d9ff02cd3afc78f319a9b865a1898c5fe1850eb1d32436fca39767a1`
BLAKE2b-256 checksum How to use checksums	`9d25e704df4ff5c2247b46b0d65da9398f369e90bdc521afef5e54c97a8c0f94`
Upload date	Sep 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / brasil_data-5.0.1-py3-none-any.whl

Download URL	brasil_data-5.0.1-py3-none-any.whl
Size	13.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`fea9b96fc802c1aa9e140ed7c9d4a9970417f35f6f7757a3653668196dfe7614`
BLAKE2b-256 checksum How to use checksums	`2b0db78fb95fc4a26c8fc6d2fdc247e379c3a0c4a4194d98e1c3e18b92ba46c4`
Upload date	Sep 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Security for brasil-data 5.0.1

Report project as malware

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.