Pesquisando o que mais dava para automatizar com Python, fui parar nas séries temporais do Banco Central. Eu já usava a API dele para puxar o dólar e a Selic, como contei em outros posts — mas, dessa vez, percebi que cada série guarda o histórico completo do indicador, não só o valor do dia. É isso que permite enxergar um padrão ao longo do tempo, não um número solto.
A API SGS do Banco Central é gratuita, não pede chave de acesso e devolve qualquer uma das suas mais de 18 mil séries históricas em JSON ou CSV, só trocando um número na URL. Neste guia, você vai ver como montar essa URL, a tabela de séries que separei fora do que já está nos outros dois posts (poupança, euro, endividamento das famílias, inadimplência), e como puxar cada uma pelo Google Sheets ou por Python.
- Como Funciona a API SGS do Banco Central
- A Tabela de Códigos Que Vale a Pena Guardar
- Como Puxar as Séries no Google Sheets
- Como Puxar as Séries em Python
- Erros Comuns ao Consultar a API do SGS
- Séries Pouco Conhecidas Que Valem a Pena Acompanhar
- O Que Fazer com os Dados Depois de Puxar
- FAQ — Perguntas Frequentes Sobre a API do Banco Central
Como Funciona a API SGS do Banco Central
O Banco Central guarda praticamente toda informação econômica oficial no Sistema Gerenciador de Séries Temporais (SGS), e cada uma delas tem um número próprio. A URL sempre segue o mesmo padrão, e o único pedaço que muda de uma série para outra é o código:
https://api.bcb.gov.br/dados/serie/bcdata.sgs.{codigo}/dados?formato=json&dataInicial=DD/MM/AAAA&dataFinal=DD/MM/AAAATrocar formato=json por formato=csv devolve o mesmo conteúdo já separado por ponto e vírgula, pronto para abrir numa planilha. E, se você só quer os valores mais recentes sem se preocupar com datas, existe um caminho mais curto:
https://api.bcb.gov.br/dados/serie/bcdata.sgs.{codigo}/dados/ultimos/30?formato=csvAtenção: O Banco Central exige filtro de data em todas as séries diárias — sem
dataInicialedataFinal, ou sem o caminho/ultimos/, a consulta pode voltar vazia ou dar erro. E o intervalo entre as duas datas não pode passar de 10 anos numa mesma chamada.
A Tabela de Códigos Que Vale a Pena Guardar
Já contei como puxar APIs Públicas Gratuitas e a Cotação do Dólar no Google Sheets em outros dois posts, e os dois já cobrem CDI, IPCA e o dólar comercial. Separei aqui o que fica de fora deles — séries que também respondem pela mesma API, mas que ninguém costuma puxar.
| Série | Código | O Que Mede | Unidade e Periodicidade |
|---|---|---|---|
| Selic diária (over) | 11 | Taxa média das operações de 1 dia útil garantidas por títulos públicos | % ao dia, diária |
| Selic meta (Copom) | 432 | Meta oficial de juros definida pelo Copom | % ao ano, diária |
| IGP-M | 189 | Índice da FGV, usado em contratos de aluguel | % ao mês, mensal |
| INPC | 188 | Variação do custo de vida de famílias de renda mais baixa | % ao mês, mensal |
| Poupança | 195 | Rentabilidade do período, pela regra vigente desde maio de 2012 | % ao mês, mensal |
| Euro (compra) | 21620 | Taxa PTAX de compra do euro | R$ por euro, diária |
| Euro (venda) | 21619 | Taxa PTAX de venda do euro | R$ por euro, diária |
| Endividamento das famílias | 29038 | Dívida com o sistema financeiro, sem crédito habitacional, em relação à renda dos últimos 12 meses | % da renda, mensal |
| Inadimplência da carteira de crédito | 21082 | Parcela da carteira de crédito com atraso superior a 90 dias | % da carteira, mensal |
Códigos confirmados na consulta oficial do SGS. O Banco Central cria séries novas e descontinua outras de tempos em tempos, então, se algum número parar de responder, vale checar de novo na consulta de séries do SGS.
Como Puxar as Séries no Google Sheets
Como a API já devolve CSV quando você pede, não precisa de Apps Script nem de nenhuma ferramenta extra: o próprio IMPORTDATA do Sheets lê o endereço direto. Para trazer os 30 valores mais recentes da Selic meta, por exemplo:
=IMPORTDATA("https://api.bcb.gov.br/dados/serie/bcdata.sgs.432/dados/ultimos/30?formato=csv")Para trocar de série, basta mudar o número depois de sgs. — o 432 vira 189 para o IGP-M, 195 para a poupança, e assim por diante, seguindo a tabela acima. O resultado chega em duas colunas, data e valor, prontas para um gráfico ou para alimentar outra aba com PROCV.
Dica: O
IMPORTDATAatualiza sozinho sempre que a planilha é aberta, mas o Google limita quantas vezes a mesma fórmula pode recarregar por hora. Se você for puxar várias séries na mesma planilha, prefira juntá-las numa aba única em vez de repetir a fórmula em cada aba.
Como Puxar as Séries em Python
Em Python, o caminho é pedir o formato json e deixar o pandas organizar a resposta numa tabela. Como todas as séries do SGS respondem no mesmo formato, uma única função serve para qualquer código da tabela — só muda o número que você passa para ela:
import requests
import pandas as pd
def puxar_serie_bcb(codigo, data_inicial, data_final):
url = f"https://api.bcb.gov.br/dados/serie/bcdata.sgs.{codigo}/dados"
params = {"formato": "json", "dataInicial": data_inicial, "dataFinal": data_final}
resposta = requests.get(url, params=params)
df = pd.DataFrame(resposta.json())
df["valor"] = df["valor"].astype(float)
df["data"] = pd.to_datetime(df["data"], format="%d/%m/%Y")
return dfComo a API limita o intervalo a 10 anos por chamada, o mais prático é calcular a data inicial a partir de hoje, em vez de digitar um ano fixo que o código vai arrastar para sempre:
from datetime import date
hoje = date.today()
dez_anos_atras = hoje.replace(year=hoje.year - 10)
igpm = puxar_serie_bcb(189, dez_anos_atras.strftime("%d/%m/%Y"), hoje.strftime("%d/%m/%Y"))Com o df pronto, dá para exportar para Excel, jogar direto numa planilha do Google ou plugar num painel do Power BI. No meu caso, é esse o fluxo que uso no controle financeiro: puxar os números com Python e deixar a visualização para outra ferramenta, como mostrei ao Conectar Power BI ao Google Sheets.

Erros Comuns ao Consultar a API do SGS
- Pedir um intervalo maior que 10 anos numa chamada só — a API recusa; divida a consulta em blocos.
- Esquecer o filtro de data numa série diária — sem
dataInicialedataFinal, a consulta pode voltar vazia. - Confundir
formato=jsoncomformato=csv— o Sheets só lê o CSV direto peloIMPORTDATA; o Python prefere o JSON. - Usar vírgula como separador decimal no código sem converter — o valor vem como texto (“5,25”), e o Python precisa trocar a vírgula por ponto antes de transformar em número, a depender da série.
Séries Pouco Conhecidas Que Valem a Pena Acompanhar
Duas séries da tabela acima raramente aparecem em tutorial, mas respondem a perguntas que costumam virar manchete sem explicar de onde vem o número.
Endividamento das Famílias (código 29038): Mostra quanto as famílias brasileiras devem ao sistema financeiro, sem contar financiamento de imóvel, em relação a tudo que ganharam nos últimos 12 meses. Toda vez que esse número bate recorde, ele sai em alguma notícia — mas dá para acompanhar o histórico completo direto na fonte, sem esperar a manchete.
Inadimplência da Carteira de Crédito (código 21082): Mede qual fração de todo o crédito do país está com alguma parcela atrasada há mais de 90 dias. É um termômetro de quanto o brasileiro está conseguindo pagar as próprias contas, atualizado todo mês.
O Que Fazer com os Dados Depois de Puxar
No fim, puxar o número é a parte fácil. O que eu de fato uso no dia a dia é comparar a série ao longo do tempo — a poupança contra a Selic meta, por exemplo, ou o IGP-M contra o reajuste do aluguel — e isso só fica claro quando o dado sai da tabela crua e vira gráfico. Se você já tem uma planilha de orçamento ou um painel pronto, essas séries entram como mais uma coluna; se ainda não tem, vale montar a estrutura antes de sair puxando série atrás de série.
FAQ — Perguntas Frequentes Sobre a API do Banco Central
Sim. Não precisa de cadastro, chave de acesso nem limite de uso divulgado — qualquer série do SGS responde pela mesma URL pública.
Não para o básico: o Google Sheets lê o endereço direto pelo IMPORTDATA, sem nenhuma linha de código. Python entra só quando você quer automatizar a limpeza dos dados ou juntar várias séries de uma vez.
Na consulta de séries do SGS, no site do Banco Central, buscando pelo nome do indicador que você procura.
Na maioria dos casos é filtro de data faltando numa série diária, ou um intervalo maior que 10 anos entre a data inicial e a final.
