quantbrasil macro
Consulta indicadores macroeconômicos do Banco Central
Sintaxe
quantbrasil macroEsta é uma operação de leitura. Modos de saída: json, human.
Argumentos e opções
| Nome | Tipo | Obrigatório | Descrição | Padrão |
|---|---|---|---|---|
--sections <sections> | Opção | Não | Lista de seções separadas por vírgula. Seções válidas: selic, ipca, focus, ptax | — |
--ipca-year <year> | Opção | Não | Ano do IPCA mensal e do acumulado no ano | — |
--ptax-date <date> | Opção | Não | Data de referência no formato AAAA-MM-DD | — |
--json | Opção | Não | Exibe 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 --jsonSaí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": []
}