semvec/pypi-packages huggingface dataset:
pybov 0.1.2
Python library for processing data from B3
License: MIT
Requires Python: >=3.7
Keywords: investment,finances

# About

`b3` is a Python library that allows extracting data provided by B3.
The library was designed to be part of a software for analysis of public
companies, although it can be used on its own for other purposes.

# What is B3?

B3 is the Brazilian stock exchange. Among its responsibilities is buying
and selling securities, such as stocks and stock options.

Note that, as B3 is concerned with market data, it is beyond its scope to
store or provide financial data from publicly-held companies, such as the
balance sheet and the income statement. Such financial data is the responsibility
of CVM, and its automated handling is possible with the library [cvm][repo-pycvm].

# Usage

To retrieve online information of companies:

```py
>>> import b3
>>> co = b3.company_detail('1023')
>>> co.company_name
'BCO BRASIL S.A.'
>>> co.cnpj
'00000000000191'
>>> co.company_code
'BBAS'
```

To extract historical quotes:

```py
import b3

with b3.historical_quotes_reader('path/to/COTAHIST.txt') as reader:
    for bulletin in reader:
        print(bulletin)
```

# Disclaimer

`b3` is an open-source library that has no connection or affiliation with
B3. The library uses the public API from B3's website and was created solely
for educational purposes. Read B3's [Terms of Use][b3-terms-of-use] for
details about your rights to use their information.

  [repo-pycvm]: <https://github.com/callmegiorgio/pycvm>
  [b3-terms-of-use]: <https://www.b3.com.br/en_us/terms-of-use-and-data-protection/terms-of-use/>
pycvm 0.4.1
Python library for processing data from CVM
License: MIT
Requires Python: >=3.7
Keywords: investment,finances

# About

`cvm` is a Python library whose job is to extract data from publicly-held companies
provided by CVM, thus allowing its use in automated systems. The library was designed
to be part of a software for analysis of public companies, although it may be used on
its own for other purposes.

# What is the CVM?

CVM is the acronym for "Comissão de Valores Mobiliários" ("Securities and Exchange Commission"),
which is the government agency that defines the rules for publicly-held companies.
In addition to regulating such companies, CVM also makes their data available for
public access.

# CVM Documents

The [CVM's Data Portal][cvm-data-portal-co] provides the following types
of documents from publicly-held companies:
- Registration Form ("Formulário Cadastral" or "FCA")
- Standardized Financial Statements ("Demonstrações Financeiras Padronizadas" or "DFP")
- Quarterly Information ("Informações Trimestrais" or "ITR")
- Reference Form ("Formulário de Referência" or "FRE")
- Eventual and Periodical Reports ("Informes Periódicos e Eventuais" or "IPE")
- Registration Information ("Informação Cadastral" or "CAD")

Currently, this library supports the documents FCA, FRE (partial), DFP, and ITR.

# Usage

```py
import cvm

with cvm.FCAFile('path/to/fca.zip') as file:
    for fca in file:
        print(fca.company_name, 'sent an FCA document on', fca.receipt_date)

with cvm.DFPITRFile('path/to/dfp_or_itr.zip') as file:
    for dfpitr in file:
        print(dfpitr.company_name, 'sent a', dfpitr.type.name, 'document on', dfpitr.receipt_date)
```

Note that this library has not been thoroughly tested and its API is still unstable.

More elaborated examples are in the directory `samples`:

```sh
> python -m samples.dfp.print_accounts 'path/to/dfp_or_itr.zip'
> python -m samples.dfp.print_balances 'path/to/dfp_or_itr.zip'
```

  [cvm-data-portal-co]: <https://dados.cvm.gov.br/dataset/?groups=companhias>