Banco Central do Brasil

Obtendo séries

Para consultar as séries de código 20786 (spread bancário) e 4189 (Selic), use a função seriesbr.bcb.get_series():

In [1]: from seriesbr import bcb

In [2]: bcb.get_series(20786)
Out[2]: 
            20786
Date             
2011-03-01  25.93
2011-04-01  26.62
2011-05-01  26.46
2011-06-01  26.34
2011-07-01  26.54
...           ...
2021-08-01  21.60
2021-09-01  21.58
2021-10-01  22.69
2021-11-01  23.00
2021-12-01  23.76

[130 rows x 1 columns]

É possível filtrar por período com os argumentos start_date e end_date:

In [3]: bcb.get_series(20786, start="2011", end="07-2012")
Out[3]: 
            20786
Date             
2011-03-01  25.93
2011-04-01  26.62
2011-05-01  26.46
2011-06-01  26.34
2011-07-01  26.54
2011-08-01  26.11
2011-09-01  27.01
2011-10-01  27.70
2011-11-01  27.20
2011-12-01  25.20
2012-01-01  26.46
2012-02-01  27.28
2012-03-01  27.04
2012-04-01  26.49
2012-05-01  24.84
2012-06-01  24.06
2012-07-01  23.83

Ou obter as últimas 5 observações com o argumento last_n:

In [4]: bcb.get_series(20786, last_n=5)
Out[4]: 
            20786
Date             
2021-08-01  21.60
2021-09-01  21.58
2021-10-01  22.69
2021-11-01  23.00
2021-12-01  23.76

Obtendo metadados

Para obter os metadados de uma série:

In [5]: bcb.get_metadata(20786)
Out[5]: 
{'referencias': '<P><A href="http://www.bcb.gov.br/estatisticas/estatisticasmonetariascredito">www.bcb.gov.br/estatisticas/estatisticasmonetariascredito</A></P> <P><A href="http://www3.bcb.gov.br/sgspub/">www3.bcb.gov.br/sgspub/</A></P>',
 'license_title': 'Licença Aberta para Bases de Dados (ODbL) do Open Data Commons',
 'maintainer': 'Banco Central do Brasil/Departamento Econômico',
 'relationships_as_object': [],
 'vcge': 'Política Econômica [http://vocab.e.gov.br/2011/03/vcge#politica-economica], Sistema Financeiro [http://vocab.e.gov.br/2011/03/vcge#sistema-financeiro], Informações Estatísticas [http://vocab.e.gov.br/2011/03/vcge#informacoes-estatisticas]',
 'private': False,
 'maintainer_email': None,
 'num_tags': 1,
 'id': '20786-spread-medio-das-operacoes-de-credito-com-recursos-livres---total',
 'metadata_created': '2017-07-31T23:03:31.926459',
 'metadata_modified': '2019-06-25T17:50:55.887596',
 'author': 'Banco Central do Brasil/Departamento Econômico',
 'author_email': None,
 'codigo_sgs': '20786',
 'state': 'active',
 'version': None,
 'unidade_medida': 'Pontos percentuais',
 'license_id': 'odc-odbl',
 'inicio_periodo': '01-03-2011',
 'resources': [{'mimetype': None,
   'cache_url': None,
   'hash': '',
   'description': 'Interface json do serviço BCData/SGS - Sistema Gerenciador de Séries Temporais. \n \n Para acessar o serviço é necessário utilizar o endereço padrão e informar os seguintes parâmetros: \n \n Endereço padrão:**http://api.bcb.gov.br/dados/serie/bcdata.sgs.*{codigo_serie}*/dados?formato=*json*&dataInicial=*{dataInicial}*&dataFinal=*{dataFinal}* ** \n \n Parâmetros: \n \n * codigo_Serie (obrigatório): parâmetro numérico que representa o código da série a ser consultada. \n \n * dataInicial (opcional): parâmetro textual que representa a data de início da consulta, no formato dd/MM/aaaa. \n \n * dataFinal (opcional): parâmetro textual que representa a data final da consulta, no formato dd/MM/aaaa. \n \n O serviço permite também recuperar os N últimos valores de uma determinada série: \n \n **http://api.bcb.gov.br/dados/serie/bcdata.sgs.*{codigo_serie}*/dados/ultimos/*{N}*?formato=*json* ** \n \n Alguns exemplos de URLs: \n \n * [http://api.bcb.gov.br/dados/serie/bcdata.sgs.20786/dados?formato=json&dataInicial=01/01/2010&dataFinal=31/12/2016](http://api.bcb.gov.br/dados/serie/bcdata.sgs.20786/dados?formato=json&dataInicial=01/01/2010&dataFinal=31/12/2016) \n \n * [http://api.bcb.gov.br/dados/serie/bcdata.sgs.20786/dados?formato=json](http://api.bcb.gov.br/dados/serie/bcdata.sgs.20786/dados?formato=json) \n \n * [http://api.bcb.gov.br/dados/serie/bcdata.sgs.20786/dados/ultimos/10?formato=json](http://api.bcb.gov.br/dados/serie/bcdata.sgs.20786/dados/ultimos/10?formato=json)',
   'name': 'json_serie-sgs-20786',
   'format': 'JSON',
   'url': 'http://api.bcb.gov.br/dados/serie/bcdata.sgs.20786/dados?formato=json',
   'cache_last_updated': None,
   'package_id': '20786-spread-medio-das-operacoes-de-credito-com-recursos-livres---total',
   'created': '2017-07-31T20:03:31.949798',
   'state': 'active',
   'mimetype_inner': None,
   'webstore_last_updated': None,
   'last_modified': None,
   'position': 0,
   'revision_id': '80dcc222-4b1b-4185-80d1-f5a5503ff7c5',
   'webstore_url': None,
   'url_type': None,
   'id': 'c4c5607e-b908-4e4e-9ccd-c49c78190ba9',
   'resource_type': None,
   'size': None},
  {'mimetype': None,
   'cache_url': None,
   'hash': '',
   'description': 'Interface csv do serviço BCData/SGS - Sistema Gerenciador de Séries Temporais. \n \n Para acessar o serviço é necessário utilizar o endereço padrão e informar os seguintes parâmetros: \n \n Endereço padrão:**http://api.bcb.gov.br/dados/serie/bcdata.sgs.*{codigo_serie}*/dados?formato=*csv*&dataInicial=*{dataInicial}*&dataFinal=*{dataFinal}* ** \n \n Parâmetros: \n \n * codigo_Serie (obrigatório): parâmetro numérico que representa o código da série a ser consultada. \n \n * dataInicial (opcional): parâmetro textual que representa a data de início da consulta, no formato dd/MM/aaaa. \n \n * dataFinal (opcional): parâmetro textual que representa a data final da consulta, no formato dd/MM/aaaa. \n \n O serviço permite também recuperar os N últimos valores de uma determinada série: \n \n **http://api.bcb.gov.br/dados/serie/bcdata.sgs.*{codigo_serie}*/dados/ultimos/*{N}*?formato=*csv* ** \n \n Alguns exemplos de URLs: \n \n * [http://api.bcb.gov.br/dados/serie/bcdata.sgs.20786/dados?formato=csv&dataInicial=01/01/2010&dataFinal=31/12/2016](http://api.bcb.gov.br/dados/serie/bcdata.sgs.20786/dados?formato=csv&dataInicial=01/01/2010&dataFinal=31/12/2016) \n \n * [http://api.bcb.gov.br/dados/serie/bcdata.sgs.20786/dados?formato=csv](http://api.bcb.gov.br/dados/serie/bcdata.sgs.20786/dados?formato=csv) \n \n * [http://api.bcb.gov.br/dados/serie/bcdata.sgs.20786/dados/ultimos/10?formato=csv](http://api.bcb.gov.br/dados/serie/bcdata.sgs.20786/dados/ultimos/10?formato=csv)',
   'name': 'csv_serie-sgs-20786',
   'format': 'CSV',
   'url': 'http://api.bcb.gov.br/dados/serie/bcdata.sgs.20786/dados?formato=csv',
   'cache_last_updated': None,
   'package_id': '20786-spread-medio-das-operacoes-de-credito-com-recursos-livres---total',
   'created': '2017-07-31T20:03:31.949808',
   'state': 'active',
   'mimetype_inner': None,
   'webstore_last_updated': None,
   'last_modified': None,
   'position': 1,
   'revision_id': '80dcc222-4b1b-4185-80d1-f5a5503ff7c5',
   'webstore_url': None,
   'url_type': None,
   'id': 'a5cd4da5-f86c-4fa9-adc3-35ccb82aa8a6',
   'resource_type': None,
   'size': None},
  {'cache_last_updated': None,
   'package_id': '20786-spread-medio-das-operacoes-de-credito-com-recursos-livres---total',
   'webstore_last_updated': None,
   'id': '42b13b91-64f9-4b5f-8e36-0e422c40c584',
   'size': None,
   'state': 'active',
   'hash': '',
   'description': 'Interface SOAP do Sistema Gerenciador de Séries Temporais - SGS.\n \n As definições (WSDL) dos serviços estão disponíveis no seguinte endereço: **[https://www3.bcb.gov.br/sgspub/JSP/sgsgeral/FachadaWSSGS.wsdl](https://www3.bcb.gov.br/sgspub/JSP/sgsgeral/FachadaWSSGS.wsdl)** \n \n Para maiores informações, acesse o menu de ajuda selecionando a opção "Ajuda do sistema" e clicando no link Serviços automatizados (webservices). Basicamente, será necessário desenvolver um aplicativo cliente para "consumir" o webservice. \n \n Para "consumir" o serviço, é necessário ainda importar a cadeia de certificados do Banco Central, que pode ser encontrada na página **[http://www.bcb.gov.br/estabilidadefinanceira/certificacaodigital](http://www.bcb.gov.br/estabilidadefinanceira/certificacaodigital)**',
   'format': 'wsdl',
   'last_modified': None,
   'url_type': None,
   'alterado': 'True',
   'mimetype': None,
   'cache_url': None,
   'name': 'wsdl_serie-sgs-20786',
   'created': '2017-07-31T20:03:31.949812',
   'url': 'https://www3.bcb.gov.br/sgspub/JSP/sgsgeral/FachadaWSSGS.wsdl',
   'webstore_url': None,
   'mimetype_inner': None,
   'position': 2,
   'revision_id': '2e126791-3a72-4396-99fe-705e07b87987',
   'resource_type': None},
  {'mimetype': None,
   'cache_url': None,
   'hash': '',
   'description': 'Acesso à visualização gráfica da série temporal no Sistema Gerenciador de Séries Temporais - SGS.',
   'name': 'html_serie-sgs-20786',
   'format': 'HTML',
   'url': 'https://www3.bcb.gov.br/sgspub/consultarvalores/consultarValoresSeries.do?method=consultarGraficoPorId&hdOidSeriesSelecionadas=20786',
   'cache_last_updated': None,
   'package_id': '20786-spread-medio-das-operacoes-de-credito-com-recursos-livres---total',
   'created': '2017-07-31T20:03:31.949815',
   'state': 'active',
   'mimetype_inner': None,
   'webstore_last_updated': None,
   'last_modified': None,
   'position': 3,
   'revision_id': '80dcc222-4b1b-4185-80d1-f5a5503ff7c5',
   'webstore_url': None,
   'url_type': None,
   'id': '43d0082e-98f2-4eb0-9964-93fcde12573d',
   'resource_type': None,
   'size': None}],
 'num_resources': 4,
 'tags': [{'vocabulary_id': None,
   'state': 'active',
   'display_name': 'indicadores de crédito',
   'id': '0583968d-51f0-4ce4-96c4-e1525a7126f6',
   'name': 'indicadores de crédito'}],
 'periodicidade': 'mensal',
 'tipo_serie': 'Série temporal mensal',
 'groups': [{'display_name': 'Economia e Finanças',
   'description': 'Economia e Finanças',
   'image_display_url': '',
   'title': 'Economia e Finanças',
   'id': '7d9e6025-582d-4a27-b270-1778d7bfdb3c',
   'name': 'economia-e-financas'}],
 'creator_user_id': '10991c15-125d-4d2c-9459-dfc5326bc4e4',
 'relationships_as_subject': [],
 'organization': {'description': 'Departamento Econômico',
  'created': '2017-07-31T19:44:34.848067',
  'title': 'BCB/Depec',
  'name': 'depec',
  'is_organization': True,
  'state': 'active',
  'image_url': '',
  'revision_id': 'f39045bd-18be-4d50-a670-ebe865032320',
  'type': 'organization',
  'id': 'e14cab40-1ba5-43ff-98ea-3be9d5352a2e',
  'approval_status': 'approved'},
 'name': '20786-spread-medio-das-operacoes-de-credito-com-recursos-livres---total',
 'isopen': True,
 'url': 'https://www3.bcb.gov.br/sgspub/consultarvalores/consultarValoresSeries.do?method=consultarGraficoPorId&hdOidSeriesSelecionadas=20786',
 'type': 'dataset',
 'notes': '\n\n Conceito: Diferença entre a taxa média de juros das novas operações de crédito livre contratadas no período de referência e o custo de captação referencial médio. Não inclui operações referenciadas em taxas regulamentadas, operações vinculadas a recursos do Banco Nacional de Desenvolvimento Econômico e Social (BNDES) ou quaisquer outras lastreadas em recursos compulsórios ou governamentais.\n\n Fonte: Banco Central do Brasil – Departamento de Estatísticas\r\n\r\n__Para mais informações sobre a série, clique no link abaixo:__\r\n\r\nhttps://www3.bcb.gov.br/sgspub/consultarmetadados/consultarMetadadosSeries.do?method=consultarMetadadosSeriesInternet&hdOidSerieSelecionada=20786',
 'owner_org': 'e14cab40-1ba5-43ff-98ea-3be9d5352a2e',
 'license_url': 'http://www.opendefinition.org/licenses/odc-odbl',
 'title': 'Spread médio das operações de crédito com recursos livres - Total',
 'revision_id': 'ce15dafa-41b5-4fb6-aa74-cf58ba6bba25',
 'fim_periodo': ''}