A API PTAX tem um formato específico para os parâmetros de data (inicial e final).

Os argumentos poderiam ser versáteis para aceitar str iso e datetime e Timestamp.
Estes seriam os formatos padrão de data da biblioteca e a partir deles a formatação correta seria realizada.

Olá, ao fazer uma consulta na Entity Expectativas eu não consigo filtrar pela DataReferencia. Veja:

from bcb import Expectativas
ep = em.get_endpoint("ExpectativaMercadoMensais")
dtest = (ep.query().filter(ep.DataReferencia <= '2022-01-01').collect())
dtest['DataReferencia'].max()
'12/2024'

A DataReferencia retornada é maior que a solicitada. Estou fazendo algo errado?

# Obs.: Para o campo `Data` funciona
dtest = (ep.query().filter(ep.Data <= '2010-01-01').collect())
dtest['Data'].max()
'2009-12-31'

DataFrame tidy é uma transformação interessante para obter variáveis ou invés de dimensões.
Dessa maneira seria interessante ter um argumento nas funções get para obter o DataFrame nesse formato.

O método describe das classes odata entregam resultados a prestação.

O método describe da classe mostra os endpoints e depois o usuário passa o endpoint para o describe para ver o que é retornado.

Quando há vários endpoints o trabalho é chato.

Uma alternativa é fazer o describe da classe retornar tudo de uma vez.

Podemos realizar consultas complexas com filter

ep.query()
     .filter(ep.Indicador == 'IPCA', ep.DataReferencia == 2023)
     .filter(ep.Data >= '2022-01-01')
     .filter(ep.tipoCalculo == 'C')

Todos estes filtros são and.
Talvez possamos implementar um or na consulta.

ep.query()
     .filter(ep.Indicador == 'IPCA' or ep.Indicador == 'IGP-M')
     .filter(ep.DataReferencia == 2023)
     .filter(ep.Data >= '2022-01-01')
     .filter(ep.tipoCalculo == 'C')

A API de Expectativas está retornando colunas numéricas ou object.
Pelo menos os campos de data poderiam já vir formatados com Timestamp.

Olá! Primeiro gostaria de parabenizar pelo pacote!

Tentei obter a expectativa de inflação mensal para os próximos 12 meses, mas ela retornou até Março somente:

from bcb import Expectativas
em = Expectativas()
ep = em.get_endpoint("ExpectativasMercadoInflacao12Meses")
print(ds_bacen['Data'].max())
2023-03-31

Está certo? Não deveria retornar até Março de 2024?

API Docs

Docs:

Colocar o pacote lxml como dependência no setup.cfg.

Olá, primeiramente obrigado por disponibilizar esta API.

Uma sugestão: adicionar um .name para a série baixada, por exemplo:

from bcb import sgs
xx = sgs.get(1)
xx.iloc[:, 0].name
# '1'
# 
# Eu esperaria algo como `' 1 - exchange rate - free - united states dollar (sale) - 1'`.
# Fonte: https://www3.bcb.gov.br/sgspub/consultarvalores/consultarValoresSeries.do?method=consultarSeries&series=1

Sei que a API permite um dicionário mas suponho que essa informação já venha junto à requisição.

Obrigado novamente.