QuantBrasil
Documentação

quantbrasil macro

Consulta indicadores macroeconômicos do Banco Central

Sintaxe

quantbrasil macro

Esta é uma operação de leitura. Modos de saída: json, human.

Argumentos e opções

NomeTipoObrigatórioDescriçãoPadrão
--sections <sections>OpçãoNãoLista de seções separadas por vírgula. Seções válidas: selic, ipca, focus, ptax—
--ipca-year <year>OpçãoNãoAno do IPCA mensal e do acumulado no ano—
--ptax-date <date>OpçãoNãoData de referência no formato AAAA-MM-DD—
--jsonOpçãoNãoExibe saída JSON—

Exemplos

quantbrasil macro
quantbrasil macro --sections selic,focus
quantbrasil macro --sections ipca --ipca-year 2025
quantbrasil macro --sections ptax --ptax-date 2026-11-13 --json

Saída (--json)

Estrutura da resposta retornada com --json:

export interface MacroIndicatorsResponse {
  as_of: string;
  selic: MacroSelic | null;
  ipca: MacroIpca | null;
  focus: MacroFocus | null;
  ptax: MacroPtax | null;
  unavailable: MacroSection[];
}

export interface MacroSelic {
  target_pct: number;
  target_date: string;
  effective_since: string | null;
  previous_target_pct: number | null;
  source_url: string | null;
}

export interface MacroIpca {
  year: number;
  months: MacroIpcaMonth[];
  year_to_date_pct: number | null;
  last_month: string | null;
  last_month_pct: number | null;
  twelve_months_pct: number | null;
  source_urls: string[];
}

export interface MacroFocus {
  survey_date: string;
  expectations: MacroFocusExpectation[];
  source_url: string | null;
}

export interface MacroPtax {
  quote_date: string;
  buy: number;
  sell: number;
  published_at: string;
  source_url: string | null;
}

export type MacroSection = (typeof macroSections)[number];

export interface MacroIpcaMonth {
  month: string;
  change_pct: number;
}

export interface MacroFocusExpectation {
  indicator: string;
  reference_year: number;
  median: number;
  respondents: number;
  survey_date: string;
}

Exemplo de resposta

{
  "as_of": "2026-11-16",
  "selic": {
    "target_pct": 13.75,
    "target_date": "2026-11-16",
    "effective_since": "2026-09-17",
    "previous_target_pct": 14,
    "source_url": "https://api.bcb.gov.br/dados/serie/bcdata.sgs.432/dados?formato=json&dataInicial=14/11/2023&dataFinal=16/11/2026"
  },
  "ipca": {
    "year": 2026,
    "months": [
      {
        "month": "2026-08",
        "change_pct": -0.32
      },
      {
        "month": "2026-09",
        "change_pct": 0.82
      },
      {
        "month": "2026-10",
        "change_pct": 0.14
      }
    ],
    "year_to_date_pct": 4.1,
    "last_month": "2026-10",
    "last_month_pct": 0.14,
    "twelve_months_pct": 4.63,
    "source_urls": [
      "https://api.bcb.gov.br/dados/serie/bcdata.sgs.433/dados?formato=json&dataInicial=01/01/2025&dataFinal=16/11/2026",
      "https://api.bcb.gov.br/dados/serie/bcdata.sgs.13522/dados?formato=json&dataInicial=01/01/2025&dataFinal=16/11/2026"
    ]
  },
  "focus": {
    "survey_date": "2026-11-13",
    "expectations": [
      {
        "indicator": "IPCA",
        "reference_year": 2026,
        "median": 5.1082,
        "respondents": 146,
        "survey_date": "2026-11-13"
      },
      {
        "indicator": "Selic",
        "reference_year": 2026,
        "median": 13.75,
        "respondents": 144,
        "survey_date": "2026-11-13"
      },
      {
        "indicator": "PIB Total",
        "reference_year": 2026,
        "median": 1.7215,
        "respondents": 119,
        "survey_date": "2026-11-13"
      },
      {
        "indicator": "Câmbio",
        "reference_year": 2026,
        "median": 5.4,
        "respondents": 121,
        "survey_date": "2026-11-13"
      }
    ],
    "source_url": "https://olinda.bcb.gov.br/olinda/servico/Expectativas/versao/v1/odata/ExpectativasMercadoAnuais"
  },
  "ptax": {
    "quote_date": "2026-11-13",
    "buy": 5.6512,
    "sell": 5.6518,
    "published_at": "2026-11-13 13:03:27.375047",
    "source_url": "https://olinda.bcb.gov.br/olinda/servico/PTAX/versao/v1/odata/CotacaoDolarPeriodo"
  },
  "unavailable": []
}