Discover available data series in the Bank of Canada Valet API.

Use this first when you do not already know a series name. Filter with 'search' to narrow the (large) catalogue, then feed a returned name into 'boc_get_observations'. Returns a paginated list of series with their name, label, and description.

Discover available data groups (curated bundles of related series).

Groups collect related series — for example 'FX_RATES_DAILY' bundles the daily exchange rates for many currencies. Feed a returned group name into 'boc_get_group_observations'.

Get the label and description metadata for a single series.

Useful for confirming a series is what you expect before pulling its observations.

Retrieve observations (the actual data points) for one or more series.

This is the core tool. Supply a date range with 'start_date'/'end_date', or ask for the latest values with 'recent'. Multiple comma-separated series are returned side by side for easy comparison.

Example: series_names='FXUSDCAD', recent=1 returns the latest USD/CAD rate.

Retrieve observations for every series in a group in one call.

For example group_name='FX_RATES_DAILY', recent=1 returns the latest daily exchange rate for all published currencies at once.