bcb_expectations: Fetch Banco Central do Brasil (BCB) market expectations

In bbk: Client for Central Bank APIs

Fetch Banco Central do Brasil (BCB) market expectations

Description

Retrieve market expectations from the Banco Central do Brasil Focus survey (Relatório Focus) via the Olinda API. Each row is the summary of survey responses collected on a given date for a future reference period.

Usage

bcb_expectations(
  type = "annual",
  indicator = NULL,
  start_date = NULL,
  end_date = NULL
)

Arguments

type	(character(1)) The forecast horizon. One of "annual", "monthly", or "quarterly". Default "annual".
indicator	(NULL | character(1)) The economic indicator to filter on (e.g. "IPCA", "Selic", "Câmbio"). If NULL, all indicators are returned. Default NULL.
start_date	(NULL | Date(1) | character(1)) Start of the survey date range (e.g., "2024-01-01"). If NULL, no lower bound is applied. Default NULL.
end_date	(NULL | Date(1) | character(1)) End of the survey date range, in the same format as start_date. If NULL, no upper bound is applied. Default NULL.

Details

Querying without a filter returns the full history, which is large; supplying indicator and/or a date range is recommended.

Value

A data.table::data.table() with columns date, indicator, detail, reference, mean, median, sd, min, max, respondents, and base.

Source

https://dadosabertos.bcb.gov.br/

See Also

Other data: banxico_data(), bbk_data(), bbk_series(), bcb_data(), bcb_fx_rates(), bcb_inflation(), bcb_selic(), bcb_top5(), bde_data(), bde_latest(), bdf_codelist(), bdf_data(), bdf_dataset(), bdp_data(), bis_data(), boc_data(), boe_data(), boi_data(), boj_data(), cnb_czeonia(), cnb_data(), cnb_fx_other_rates(), cnb_fx_rates(), cnb_pribor(), ecb_data(), nbp_fx_rates(), nbp_gold(), nob_data(), onb_data(), snb_data(), srb_cross_rates(), srb_data()

Examples

# annual IPCA inflation expectations
bcb_expectations("annual", "IPCA", start_date = "2024-01-01", end_date = "2024-01-31")

bbk documentation built on Aug. 28, 2026, 5:07 p.m.