Instituto de Pesquisa Econômica Aplicada

Obtendo séries

Seguem alguns exemplos para ilustrar o uso da função seriesbr.ipea.get_series().

Obtendo as séries de identificador “BM12_TJOVER12” (Taxa de juros - Over / Selic - acumulada no mês):

In [1]: from seriesbr import ipea

In [2]: ipea.get_series("BM12_TJOVER12")
Out[2]: 
            BM12_TJOVER12
Date                     
1974-01-01           1.46
1974-02-01           1.15
1974-03-01           1.16
1974-04-01           1.21
1974-05-01           1.24
...                   ...
2021-09-01           0.44
2021-10-01           0.49
2021-11-01           0.59
2021-12-01           0.77
2022-01-01           0.73

[577 rows x 1 columns]

Filtrando por data:

In [3]: ipea.get_series("BM12_TJOVER12", start="07-2015", end="07-2016")
Out[3]: 
            BM12_TJOVER12
Date                     
2015-07-01           1.18
2015-08-01           1.11
2015-09-01           1.11
2015-10-01           1.11
2015-11-01           1.06
2015-12-01           1.16
2016-01-01           1.06
2016-02-01           1.00
2016-03-01           1.16
2016-04-01           1.06
2016-05-01           1.11
2016-06-01           1.16
2016-07-01           1.11

Obtendo as últimas 12 observações:

In [4]: ipea.get_series("BM12_TJOVER12", last_n=12)
Out[4]: 
            BM12_TJOVER12
Date                     
2021-02-01           0.13
2021-03-01           0.20
2021-04-01           0.21
2021-05-01           0.27
2021-06-01           0.31
2021-07-01           0.36
2021-08-01           0.43
2021-09-01           0.44
2021-10-01           0.49
2021-11-01           0.59
2021-12-01           0.77
2022-01-01           0.73

Obtendo metadados

Para obter os metadados de uma série:

In [5]: ipea.get_metadata("BM12_TJOVER12")
Out[5]: 
{'SERCODIGO': 'BM12_TJOVER12',
 'SERNOME': 'Taxa de juros - Over / Selic - acumulada no mês',
 'SERCOMENTARIO': 'Receber uma quantia hoje ou no futuro não são evidentemente a mesma coisa. Em princípio, uma unidade monetária hoje é preferível à mesma unidade monetária disponível amanhã. Postergar uma entrada de caixa (recebimento) por certo tempo envolve um sacrifício, o qual deve ser pago mediante uma recompensa, definida pelos juros. A taxa de juro é o coeficiente que determina o valor do juro, isto é, a remuneração do fator capital utilizado durante certo período de tempoTaxa de juros acumulada mensal tendo como base a taxa Selic diária.A taxa  Selic  é  a  taxa  de  juros  média apurada no  Sistema  Especial  de  Liquidação  e  Custódia  (Selic), que  incide  sobre  operações de financiamento por  um  dia  útil  (overnight),  lastreadas  por títulos  públicos  registrados  no Sistema. É utilizada como instrumento  primário  de  política  monetária  do  Comitê de Política Monetária (Copom), visando ao cumprimento da meta para inflação. O  Copom estabelece  a  meta  para  a taxa  Selic,  e  cabe  à  mesa  de  operações  do  mercado  aberto  do Banco Central do Brasil (BCB) manter a taxa Selic diária próxima à meta.Mais informações: <a href="../doc/manualfinpublp.pdf">Manual de Finanças Públicas</a>; Neto, Matemática Financeira e suas Aplicações. 12ª edição,2012 e SGS- Sistema de Gerenciamento de Séries Temporais, Banco Central.',
 'SERATUALIZACAO': '2022-02-01T05:06:00.45-03:00',
 'BASNOME': 'Macroeconômico',
 'FNTID': 1333430857,
 'FNTSIGLA': 'Bacen/Boletim/M. Finan.',
 'FNTNOME': 'Banco Central do Brasil, Boletim, Seção mercado financeiro e de capitais (Bacen/Boletim/M. Finan.)',
 'FNTURL': 'http://www.bcb.gov.br',
 'PERNOME': 'Mensal',
 'UNINOME': '(% a.m.)',
 'MULNOME': None,
 'SERSTATUS': 'A',
 'TEMCODIGO': 39,
 'TEMNOME': 'Financeiras',
 'TEMCODIGOPAI': None,
 'PAICODIGO': 'BRA',
 'SERNUMERICA': True,
 'SERTEMBR': None,
 'SERTEMEST': None,
 'SERTEMMUN': None,
 'SERTEMAMC': None,
 'SERTEMMET': None,
 'SERMINDATA': '1974-01-01T00:00:00-02:00',
 'SERMAXDATA': '2022-01-01T00:00:00-03:00',
 'FNTEXTURL': None,
 'SERPROGRAMAGERADOR': None,
 'SERDECIMAIS': 4,
 'SERQNT': 577}

Para entender o que significa cada campo exatamente, consulte a documentação do Ipeadata.