Localiza indicadores no catálogo curado de dados oficiais do Brasil.

Comece por aqui para descobrir o id a usar em obter_serie, comparar_series e painel. Sem argumentos, devolve os temas disponíveis e quantos indicadores cada um tem.

Args: consulta: palavras-chave, ex.: "selic", "ipca serviços", "dívida bruta". tema: restringe a um tema (ex.: inflacao, fiscal, credito). fonte: restringe a uma fonte (ex.: BCB, IBGE, Tesouro, IPEA). limite: máximo de resultados (padrão 15).

Próximas divulgações de indicadores do IBGE e a data da próxima decisão do Copom.

Args: dias: tamanho da janela, em dias, a partir de inicio. filtro: texto para filtrar pelo título (ex.: "IPCA", "PIB", "PNAD", "industrial"). inicio: data inicial (AAAA-MM-DD); padrão: hoje. Datas passadas mostram o que já saiu.

Preço de combustíveis ao consumidor nos postos (ANP, levantamento mensal).

Sem UF: média nacional e ranking por UF (mais barato primeiro). Com UF: ranking dos municípios. Com UF e município: os postos mais baratos. Produtos: gasolina, gasolina_aditivada, etanol, diesel (S500), diesel_s10, gnv, glp. Sem ano e mês, usa o último mês publicado. Os valores são médias simples das coletas, sem ponderar pelo volume vendido. Para uma série mensal da média nacional, use os indicadores de combustíveis do catálogo.

Exportações, importações ou saldo do Brasil (MDIC/Secex, ComexStat), por país, bloco, UF, via, seção ou produto.

Valores em US$ milhões (FOB) e peso em mil toneladas, somados no período; sem datas, usa os 12 meses fechados mais recentes. Para totais mensais como série, use obter_serie (tema comercio_exterior). O ComexStat recusa requisições de forma irregular: se recusar, tente de novo em instantes.

Args: fluxo: "exportacao", "importacao" ou "saldo". por: "pais", "bloco", "uf", "via", "secao", "capitulo", "sh4" ou "nenhum" (só o total). inicio, fim: mês (AAAA ou AAAA-MM); ano inteiro: inicio="2025", fim="2025". pais, bloco, uf, via, secao, capitulo: filtros por nome ou código; pais aceita lista separada por vírgula. limite: itens do ranking (até 50); o restante vai em "demais". mensal: inclui os totais mês a mês.

Indicadores do catálogo lado a lado, alinhados por período (2 a 12).

As periodicidades precisam ser iguais, a menos que agregacao seja informada: aí as séries mais frequentes são convertidas para a mais baixa do grupo.

Args: indicadores: lista de ids do catálogo. inicio, fim, ultimos: recorte, como em obter_serie. transformacao: mesma lista de obter_serie, aplicada a todas. agregacao: "ultimo" (taxas e estoques), "media" ou "soma" (fluxos).

Decisões do Copom sobre a Selic, com comunicados e atas.

Sem documento, devolve as últimas reuniões (data, meta decidida, variação em p.p.) e a data da próxima. Com documento, devolve o texto do comunicado ou da ata.

Args: ultimas: reuniões listadas, da mais recente para trás. documento: "comunicado" ou "ata". reuniao: número da reunião; padrão: a mais recente disponível. max_caracteres: tamanho do trecho de texto devolvido. a_partir_de: posição inicial, para continuar a leitura de um documento longo.

Busca conjuntos de dados nos portais de dados abertos oficiais: portal 'bndes' (operações, desembolsos e financiamentos do BNDES) ou 'aneel' (energia elétrica: geração, tarifas, outorgas). Devolve o título, a descrição, a página e os recursos (CSV, XLSX, API) de cada conjunto, para o usuário abrir ou baixar.

Dívida Pública Federal (Tesouro): estoque por tipo e instrumento, e fatores de variação.

Lê o Relatório Mensal da Dívida. Anexo 2.1 (padrão): estoque no fim do mês, em R$ bilhões, desde dez/2000. Anexo 2.9: emissões, resgates e juros apropriados, em R$ milhões. Sem período, traz os 12 meses mais recentes. Não é a DBGG do BCB, que tem outro perímetro. Principais itens no catálogo (dpf_*).

Args: inicio, fim: mês (AAAA-MM). ultimos: meses recentes. linhas: filtro por texto ("lft", "dpfe", "juros"); separe com ";". anexo: "2.1" (padrão) ou "2.9". listar: só a lista de linhas do anexo.

Emendas Pix (transferências especiais da União a estados e municípios), pelo TransfereGov.

Agrupa os planos de ação por por (uf, parlamentar ou beneficiario), ordenados pelo valor. Filtros: uf (sigla), situacao (ex.: CIENTE, IMPEDIDO), parlamentar e beneficiario (trecho do nome). Os valores são os previstos no plano de ação (custeio + investimento), não o montante já pago. Sem ano, usa o ano corrente.

Expectativas do Relatório Focus (BCB): mediana, média e dispersão.

Sem indicador, lista os indicadores por tipo. Com indicador, traz o retrato da pesquisa mais recente (uma linha por período); com referencia ou tipo 12_meses/24_meses, traz a evolução no tempo.

Args: indicador: ex.: "IPCA", "Selic", "PIB Total", "Câmbio", "Resultado primário"; aceita apelidos (pib, dolar). tipo: "anual", "mensal", "trimestral", "12_meses", "24_meses" ou "selic" (decisões do Copom). referencia: "2027" (anual), "2026-12" (mensal), "2026-T4" (trimestral) ou "R8/2026" (selic). data: data da pesquisa (AAAA-MM-DD) para o retrato; padrão: a mais recente. inicio, ultimos, frequencia: para a evolução (padrão 12 pontos, semanal). detalhe: para "Balança comercial": "Exportações", "Importações" ou "Saldo". top5: "curto", "medio" ou "longo" para as instituições Top 5. base_calculo: 0 = últimos 30 dias (padrão); 1 = últimos 5 dias úteis. suavizada: para 12_meses e 24_meses (padrão).

Fundos de investimento registrados na CVM (cadastro público da RCVM 175: classes de cotas).

Filtros: consulta (trecho do nome), classificacao (ex.: Ações, Renda Fixa), tipo (ex.: Fundo de Investimento Imobiliário), gestor, administrador (nome ou CNPJ) e publico_alvo. A lista vem em tabela (colunas: cnpj, nome, tipo, classificacao, gestor, administrador, patrimonio_liquido, data_patrimonio), ordenada pelo patrimônio informado, que pode estar defasado. Com cnpj exato (de classe ou de fundo), devolve a ficha completa: CNPJs e nomes de administrador, auditor, custodiante e controlador, e subclasses. Situação padrão 'Em Funcionamento Normal'; '' inclui todas. Cotas diárias: fundos_informe_diario.

Informe diário de um fundo financeiro (FIF) na CVM: cota, patrimônio, captação, resgate e cotistas.

cnpj é da classe ou do fundo. Cobre só os FIF: FII, FIDC, FIP e FIAGRO estão em outros conjuntos da CVM, ainda não incluídos. inicio e fim aceitam AAAA-MM ou AAAA-MM-DD (padrão: últimos 3 meses; máximo 12 meses por chamada). detalhe='resumo' (padrão) traz rentabilidade simples, captação líquida e uma linha por mês (último informe do mês, com a captação líquida somada). detalhe='diario' traz cada dia, 60 por página: use pagina (1, 2...). Para fundos com subclasses há uma série por subclasse, ou só a de subclasse. A rentabilidade simples é cota final sobre cota inicial menos 1; não é a rentabilidade oficial (ignora distribuições e taxas).

Divisão territorial do IBGE com os códigos oficiais (úteis para cruzar com o SIDRA e outras fontes).

nivel é 'estados' ou 'municipios'. Para municípios, informe a uf (sigla) ou um trecho do nome em consulta; sem nenhum dos dois, a lista seria o país inteiro e é recusada.

Indicador das 27 Unidades da Federação (IBGE), no último período divulgado, com comparação.

indicador: desocupacao (PNAD, trimestral), rendimento (rendimento médio real, trimestral), massa_rendimento (trimestral), ocupados (trimestral) ou pib (PIB corrente por UF, anual). uf filtra por nome, sigla ou código (ex.: 'bahia', 'BA', '29'). ordenar é 'maior' ou 'menor' pelo valor atual. periodos (1 a 12) é quantos períodos recentes buscar. A resposta traz uma tabela com: uf, codigo, valor, anterior (período anterior), ano_anterior (mesmo período do ano anterior) e variacao (em pontos percentuais para taxas, em % para os demais).

Quebras do IPCA (ou IPCA-15, INPC) num mês: variação, peso e contribuição em p.p. de cada componente, desde 2012.

Args: periodo: AAAA-MM; padrão o mais recente. nivel: "grupo", "subgrupo", "item", "subitem" ou "todos". indice: "ipca", "ipca15" ou "inpc". dentro_de: ramo da estrutura pelo código ("1" = alimentação) ou nome. filtro: texto para achar componentes pelo nome ("gasolina"). ordenar: "contribuicao" (padrão), "variacao", "peso" ou "estrutura". limite: linhas devolvidas.

Série histórica de um componente do IPCA (grupo, subgrupo, item ou subitem), desde 2012.

Exemplos de item: "Alimentação e bebidas", "Alimentação no domicílio", "Gasolina", "Energia elétrica residencial", "Aluguel residencial", ou o código da estrutura ("5104001").

Args: item: nome ou código da estrutura do componente (veja ipca_detalhado). inicio: mês inicial (AAAA-MM ou AAAA). fim: mês final. ultimos: quantidade de meses mais recentes (padrão 24 quando não há inicio). variavel: "variacao_mensal", "acumulado_12m", "acumulado_ano" ou "peso". indice: "ipca", "ipca15" ou "inpc".

Procura séries no Ipeadata por texto no nome, com filtro por fonte original e tema; devolve o código para ipea_serie. Sem argumentos, lista fontes e temas.

Args: consulta: palavras do nome, todas obrigatórias; sem acento nem maiúscula. fonte: trecho da sigla ou do nome da fonte original ("ANP", "Receita", "Caged"). tema: nome ou código do tema. base: "macro" (padrão), "regional", "social" ou "todas". incluir_inativas: inclui séries descontinuadas. limite: até 100 resultados.

Série do Ipeadata pelo código, com metadados e fonte original. O Ipeadata redistribui dados de IBGE, BCB, Receita, ANP etc. Séries de fonte privada (FGV, CNI, Anfavea...) ficam bloqueadas por padrão. Sem período, traz as observações mais recentes. Localize o código com ipea_buscar.

Args: codigo: ex.: "CAGED12_SALDON12". inicio, fim, ultimos: período e recorte, como em obter_serie. territorio: só séries regionais: "0" Brasil, "1" a "5" regiões, "35" ou "SP" UF, 7 dígitos município.

Série histórica de um indicador do catálogo, com fonte, unidade e código.

Sem período, traz as observações mais recentes (30 dias úteis, 24 meses, 12 trimestres ou 10 anos).

Args: indicador: id do catálogo (buscar_indicadores), ex.: "selic_meta", "ipca". inicio, fim: AAAA, AAAA-MM, AAAA-MM-DD ou AAAA-T1. ultimos: observações mais recentes. transformacao: variacao_periodo, variacao_anual, diferenca, acumulado_12m, acumulado_ano, soma_12m, media_movel_3m, media_movel_12m, anualizado, mm3m_anualizada ou base_100. Acumulados e anualizados valem para séries em variação % (ex.: ipca); soma_12m, para fluxos.

Retrato rápido de um tema: último valor, valor anterior e valor de 12 meses antes.

Args: tema: "geral" (principais indicadores do país) ou um tema do catálogo, ex.: politica_monetaria, inflacao, atividade, trabalho, fiscal, setor_externo, credito. Use buscar_indicadores sem argumentos para ver a lista.

Cotações PTAX de fechamento do Banco Central (compra e venda, em reais por unidade da moeda).

Args: moeda: símbolo da moeda (USD, EUR, GBP, JPY, CHF...). Use "lista" para ver as moedas disponíveis. inicio: data inicial (AAAA-MM-DD ou AAAA-MM). fim: data final; padrão: hoje. ultimos: quantidade de dias úteis mais recentes quando não há inicio.

Resultado do Tesouro Nacional (RTN): receitas, despesas e resultado primário do governo central.

Sinal: no RTN, positivo é superávit; é o oposto das NFSP do BCB. Sem período, traz os 12 meses mais recentes. Os principais agregados também estão no catálogo (rtn_*).

Args: inicio, fim: período (AAAA, AAAA-MM ou AAAA-MM-DD). ultimos: períodos recentes. linhas: filtro por texto ("previdenciarios") ou número da linha ("4.3"); separe com ";". tabela: "1.1" resumida (padrão), "1.2" completa, "1.1-A"/"1.2-A" a preços constantes, "1.2-B" acumulado em 12 meses, "2.1"/"2.2" anuais, "2.1-A"/"2.2-A" em % do PIB, "1.3" investimento, "1.4" custeio. nivel: profundidade das linhas sem filtro (1 totais, 2 padrão, 5 tudo). listar: devolve as tabelas e as linhas disponíveis.

Procura séries do SGS no catálogo de dados abertos do Banco Central, por palavras-chave.

Devolve código, título e periodicidade; use o código em sgs_serie. A busca cobre só as séries publicadas como dados abertos, não o SGS inteiro.

Args: consulta: palavras-chave, ex.: "inadimplência cartão de crédito". limite: máximo de resultados (até 100).

Qualquer série do SGS (BCB) pelo código, quando não está no catálogo. Use sgs_buscar para achar códigos.

Args: codigo: número da série, ex.: 432 (meta Selic). inicio, fim, ultimos, transformacao: como em obter_serie.

Procura o código de um ente (União, estado, DF ou município) no SICONFI. O código IBGE é o que siconfi_relatorio usa.

Args: busca: parte do nome ("campinas") ou código IBGE. Vazio = lista pelos filtros. uf: sigla da UF, para restringir. esfera: "U", "E", "D" ou "M". limite: entes devolvidos (padrão 20).

Demonstrativos fiscais do SICONFI, declarados pelos entes, em R$: RREO (bimestral), RGF (quadrimestral) e DCA (anual).

Sem anexo, lista os anexos disponíveis; com anexo, devolve as contas em colunas. Para achar o código do ente, use siconfi_entes.

Args: relatorio: "RREO", "RGF" ou "DCA". ente: código IBGE (35 = SP, 3550308 = São Paulo, 1 = União) ou nome; nome ambíguo pede uf ou esfera. exercicio: ano (padrão: ano anterior). periodo: RREO, bimestre 1 a 6 (padrão 6); RGF, quadrimestre 1 a 3 ou semestre 1 a 2. Não vale para DCA. anexo: ex.: "01" (RREO, balanço orçamentário), "02" (RGF, dívida consolidada), "I-C" (DCA); aceita o nome. conta: trecho do nome da conta, ex.: "pessoal". coluna: trecho do nome da coluna, ex.: "empenhadas". uf: sigla, para desambiguar o ente. esfera: "U", "E", "D" ou "M". poder: só RGF: "E" (padrão), "L", "J", "M" ou "D". periodicidade: só RGF: "Q" (padrão) ou "S". simplificado: demonstrativo simplificado (municípios com menos de 50 mil habitantes). max_linhas: contas devolvidas (padrão 60).

Procura tabelas do SIDRA (IBGE) por palavras-chave no nome da tabela ou da pesquisa.

Args: consulta: palavras-chave, ex.: "pib municípios", "rendimento domiciliar per capita". limite: máximo de resultados.

Consulta livre a qualquer tabela do SIDRA (IBGE). Antes, use sidra_metadados para ver variáveis e categorias.

Args: tabela: número da tabela (ex.: 7060 IPCA, 5938 PIB). variaveis: ids separados por vírgula, ou "all". periodos: "last N", "all", "202001-202612" ou "202601,202602". Mensal AAAAMM; trimestral AAAA01 a AAAA04; anual AAAA. classificacoes: ex.: {"315": "7169,7170"}; "all" traz todas. Sem informar, vem o total. nivel_territorial: n1 Brasil, n2 grande região, n3 UF, n6 município, n7 região metropolitana. localidades: "all" ou códigos IBGE separados por vírgula ("35" = SP no n3). limite: linhas devolvidas.

Descreve uma tabela do SIDRA: variáveis, classificações, categorias, períodos e níveis territoriais.

Args: tabela: número da tabela. classificacao: id de uma classificação para listar suas categorias (ex.: "315"). filtro: texto para filtrar as categorias pelo nome. limite: máximo de categorias listadas por classificação.

Taxas e preços dos títulos do Tesouro Direto (mercado secundário).

Sem vencimento, lista as cotações de todos os títulos numa data (padrão: a mais recente). Com vencimento, devolve o histórico de um título. Taxas em % ao ano; preços (PU) em R$. Taxa de compra é a do investidor que compra (menor que a de venda). Dados desde 2004; o arquivo oficial é grande e fica em cache.

Args: tipo: parte do nome: "selic", "prefixado", "ipca+", "renda+", "educa+". Vazio = todos. vencimento: ano, mês ou dia (ex.: "2035-05"). Para histórico, precisa identificar um título. data: dia da cotação (AAAA-MM-DD); sem pregão, usa o anterior. inicio, fim: período do histórico. ultimos: cotações recentes do histórico (padrão 30; máximo 1000).