b3cotahist

Biblioteca Python para fetch e leitura do arquivo COTAHIST da B3.

Instalação

pip install b3cotahist

Uso

Fetch da B3

import datetime
import b3cotahist

# Fetch dos dados do pregão de 01/03/2024

date = datetime.date(2024, 3, 1)

df = b3cotahist.get(date)

# Caso tenha problemas com SSL da b3
df = b3cotahist.get(date, raise_ssl_error=False)

# A B3 também disponibiliza dados consolidados por ano
df = b3cotahist.get_year(2024)

Leitura de arquivos

df = b3cotahist.read_zip(path='COTAHIST_D20240301.ZIP')

df = b3cotahist.read_txt(path='COTAHIST_D20240301.TXT')

Leitura de bytes

# Lendo a partir de bytes
with open('COTAHIST_D20240301.TXT', 'rb') as f:
    dados = f.read()
df = b3cotahist.read_bytes(dados)

# Ou a partir de BytesIO
import io
bytes_io = io.BytesIO(dados)
df = b3cotahist.read_bytes(bytes_io)