API do Banco Central: Como Usar e a Tabela de Códigos SGS

Veja como puxar Selic, IGP-M, INPC, poupança e mais dados do Banco Central pela API SGS, com a URL pronta, fórmula do Sheets e código Python.
Imagem via IA

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

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/AAAA

Trocar 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=csv

Atenção: O Banco Central exige filtro de data em todas as séries diárias — sem dataInicial e dataFinal, 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érieCódigoO Que MedeUnidade e Periodicidade
Selic diária (over)11Taxa média das operações de 1 dia útil garantidas por títulos públicos% ao dia, diária
Selic meta (Copom)432Meta oficial de juros definida pelo Copom% ao ano, diária
IGP-M189Índice da FGV, usado em contratos de aluguel% ao mês, mensal
INPC188Variação do custo de vida de famílias de renda mais baixa% ao mês, mensal
Poupança195Rentabilidade do período, pela regra vigente desde maio de 2012% ao mês, mensal
Euro (compra)21620Taxa PTAX de compra do euroR$ por euro, diária
Euro (venda)21619Taxa PTAX de venda do euroR$ por euro, diária
Endividamento das famílias29038Dí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édito21082Parcela 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 IMPORTDATA atualiza 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 df

Como 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.

Exemplo de gráfico de variação percentual acumulada por ano, no estilo que uma série da API do Banco Central produz.
Imagem via IA

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 dataInicial e dataFinal, a consulta pode voltar vazia.
  • Confundir formato=json com formato=csv — o Sheets só lê o CSV direto pelo IMPORTDATA; 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


1. A API do Banco Central É Gratuita ?

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.


2. Preciso Saber Programar Para Usar Essas Séries ?

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.


3. Onde Encontro o Código de Outras Séries Que Não Estão na Tabela ?

Na consulta de séries do SGS, no site do Banco Central, buscando pelo nome do indicador que você procura.


4. Por Que Minha Consulta Está Voltando Vazia ?

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.


Aviso: Este conteúdo tem caráter exclusivamente informativo e educativo e não constitui recomendação de investimento, produto financeiro, serviço bancário ou consultoria individual. Sempre avalie seu perfil e, se necessário, procure um profissional especializado. Para mais detalhes, consulte nosso Aviso Legal.

COMPARTILHE