Bank of Canada
App · 12 actions
Get the Bank of Canada's official data: daily exchange rates for 26 currencies against the Canadian dollar (and monthly and annual averages), currency conversion at the Bank's rates, the policy interest rate and its changes, key rates such as prime, CORRA and bond yields, inflation and its core measures, and any of its 16,000 data series. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Convert currency | Convert an amount between the Canadian dollar and another currency, or between two other currencies through the Canadian dollar, at the Bank of Canada's daily rates: the latest, or those of a date (the last business day before it when the Bank published none that day). |
| Get exchange rates | Get the Bank of Canada's exchange rates for one or more currencies against the Canadian dollar over a period: daily rates, or monthly or annual averages (the ones often used for tax returns). |
| Get group details | Get a Bank of Canada group's details and the series it holds, each with its id, name, description and how often it is published. |
| Get group observations | Get the values of every series in a Bank of Canada group over a period, such as all the daily exchange rates, the benchmark bond yields or the CPI measures. |
| Get inflation | Get Canada's inflation rate (the 12-month change in the Consumer Price Index) and the Bank of Canada's core measures (CPI-trim, CPI-median, CPI-common and CPI-XFET) for the latest months, with the Bank's 2% target and its 1% to 3% range. |
| Get key interest rates | Get Canada's key interest rates in one step: the policy rate, CORRA, the bank rate, the prime rate, the 3-month treasury bill, the 2, 5, 10-year and long-term benchmark bond yields and the 5-year conventional mortgage rate. |
| Get series details | Get a Bank of Canada series' details: its name, what it measures, its unit, how often it is published, and its latest value. |
| Get series observations | Get the values of one or more Bank of Canada data series over a period: interest rates, exchange rates, inflation, bond yields or any other of its 16,000 series. |
| Get the latest exchange rates | Get the Bank of Canada's most recent daily exchange rates for every currency it publishes, in Canadian dollars and the other way round, with the change from the business day before. |
| Get the policy interest rate | Get the Bank of Canada's policy interest rate (the target for the overnight rate) now, when it last changed and by how much, and every change in the last few years. |
| Search groups | Find groups of Bank of Canada series by words in their name, title or description, such as exchange rates or bond yields, or list every group. |
| Search series | Find Bank of Canada data series by words in their id, name or description, such as mortgage or US dollar. |
Convert currency
Convert an amount between the Canadian dollar and another currency, or between two other currencies through the Canadian dollar, at the Bank of Canada's daily rates: the latest, or those of a date (the last business day before it when the Bank published none that day). Returns the converted amount, the rate used and its date. No API key required.
Inputs
- Amount
amountnumberRequired - The amount to convert, such as 100.
- From currency
from_currencytextRequired - The currency the amount is in.
- To currency
to_currencytextRequired - The currency to convert the amount to.
- Date
datedate - Use the rates of this date (daily rates start on 2017-01-03). Rates published after this date are not used. Leave it empty for the latest rates.
Outputs
amountnumber- The amount converted.
converted_amountnumber- The amount in the currency converted to, to four decimals.
from_currencytext- The currency converted from, such as USD.
from_rate_in_cadnumber- The Bank's rate for the currency converted from, in Canadian dollars (null when it is the Canadian dollar).
inverse_ratenumber- The opposite: units converted from for one unit converted to.
ratenumber- Units of the currency converted to for one unit of the currency converted from, to six significant digits.
rate_datetext- The date of the Bank's rates used, as YYYY-MM-DD: the date asked for, or the last business day before it. Null when both currencies are the same.
requested_datetext- The date asked for, or null for the latest rates.
summarytext- One sentence with the amounts, the rate and its date, for a message.
to_currencytext- The currency converted to, such as CAD.
to_rate_in_cadnumber- The Bank's rate for the currency converted to, in Canadian dollars (null when it is the Canadian dollar).
Example output
{
"amount": 100.0,
"converted_amount": 140.54,
"from_currency": "USD",
"from_rate_in_cad": 1.4054,
"inverse_rate": 0.711541,
"rate": 1.4054,
"rate_date": "2026-10-20",
"requested_date": null,
"summary": "100 USD = 140.54 CAD at the Bank of Canada rate for 2026-10-20 (1 USD = 1.4054 CAD).",
"to_currency": "CAD",
"to_rate_in_cad": null
}Get exchange rates
Get the Bank of Canada's exchange rates for one or more currencies against the Canadian dollar over a period: daily rates, or monthly or annual averages (the ones often used for tax returns). Each currency comes with every rate in the period, its inverse, the latest rate, and the average, lowest and highest. No API key required.
Inputs
- Currencies
currencieslistRequired - The currencies to get rates for. Each rate is the number of Canadian dollars for one unit of the currency.
- Frequency
frequencytext - Daily rates (published each business day from 2017), or monthly or annual averages. Daily if left empty.One of:
daily,monthly(Monthly averages),annual(Annual averages). Default:daily. - Period
periodtext - Which observations to get: the latest few, those of the last few weeks, months or years, those between two dates, or the whole history. The latest observations if left empty.One of:
latest(The latest observations),weeks(The last few weeks),months(The last few months),years(The last few years),dates(Between two dates),all(The whole history). Default:latest. - How many
countnumber - With The latest observations, how many observations of each series; with the last few weeks, months or years, how many weeks, months or years. 10 if left empty.Only when Period is The latest observations, The last few weeks, The last few months or The last few years. From 1 to 10000. Default:
10. - Start date
start_datedate - The first date to include. Leave it empty to start from the beginning of the data.Only when Period is Between two dates.
- End date
end_datedate - The last date to include. Leave it empty to go up to the latest observation.Only when Period is Between two dates.
- Order
ordertext - Oldest first or newest first. Oldest first if left empty.One of:
asc(Oldest first),desc(Newest first). Default:asc.
Outputs
countnumber- How many currencies are listed.
count_requestednumber- How many observations (or weeks, months or years) were asked for, when the period counts them.
currencieslist- One entry per currency, in the order chosen.
end_datetext- The last date asked for, when the period is dates.
frequencytext- daily, monthly or annual, as asked for.
periodtext- Which observations were asked for: latest, weeks, months, years, dates or all.
start_datetext- The first date asked for, when the period is dates.
Example output
{
"count": 2,
"count_requested": 3,
"currencies": [
{
"average_rate": 1.410166667,
"change": -0.01,
"count": 3,
"currency": "USD",
"currency_name": "US dollar",
"discontinued": false,
"frequency": "Daily",
"label": "USD/CAD",
"latest_date": "2026-10-20",
"latest_inverse_rate": 0.7115,
"latest_rate": 1.4054,
"maximum_rate": 1.4154,
"minimum_rate": 1.4054,
"observations": [
{
"date": "2026-10-16",
"inverse_rate": 0.7065,
"rate": 1.4154
},
{
"date": "2026-10-19",
"inverse_rate": 0.7094,
"rate": 1.4097
},
{
"date": "2026-10-20",
"inverse_rate": 0.7115,
"rate": 1.4054
}
],
"percent_change": -0.7065,
"series": "FXUSDCAD",
"unit": "Canadian dollars per US dollar"
},
{
"average_rate": 1.583466667,
"change": -0.0122,
"count": 3,
"currency": "EUR",
"currency_name": "Euro",
"discontinued": false,
"frequency": "Daily",
"label": "EUR/CAD",
"latest_date": "2026-10-20",
"latest_inverse_rate": 0.6335,
"latest_rate": 1.5786,
"maximum_rate": 1.5908,
"minimum_rate": 1.5786,
"observations": [
{
"date": "2026-10-16",
"inverse_rate": 0.6286,
"rate": 1.5908
},
{
"date": "2026-10-19",
"inverse_rate": 0.6325,
"rate": 1.581
},
{
"date": "2026-10-20",
"inverse_rate": 0.6335,
"rate": 1.5786
}
],
"percent_change": -0.7669,
"series": "FXEURCAD",
"unit": "Canadian dollars per euro"
}
],
"end_date": null,
"frequency": "daily",
"period": "latest",
"start_date": null
}Get group details
Get a Bank of Canada group's details and the series it holds, each with its id, name, description and how often it is published. No API key required.
Inputs
- Group
grouptextRequired - The group of series, such as Daily exchange rates (FX_RATES_DAILY). The list holds every group, the common ones first; type to search it. Find groups by topic with Search groups.
Outputs
descriptiontext- What the group holds, in the Bank's words.
frequencytext- How often its series are published, when the Bank says.
labeltext- The group's title, such as Daily exchange rates.
nametext- The group's name, such as FX_RATES_DAILY.
serieslist- Every series in the group, in the Bank's order.
series_countnumber- How many series the group holds.
unittext- The unit its series share, when the Bank gives one.
web_pagetext- The page about it on bankofcanada.ca, when there is one.
Example output
{
"description": "Daily average exchange rates for various foreign currencies currently or historically published by the Bank of Canada, representing the value of one unit of foreign currency expressed in Canadian dollars.",
"frequency": "Business daily",
"label": "Daily exchange rates",
"name": "FX_RATES_DAILY",
"series": [
{
"description": "Daily average exchange rate of the euro in Canadian dollars.",
"frequency": "Daily",
"label": "EUR/CAD",
"name": "FXEURCAD"
},
{
"description": "Daily average exchange rate of the US dollar in Canadian dollars.",
"frequency": "Daily",
"label": "USD/CAD",
"name": "FXUSDCAD"
}
],
"series_count": 2,
"unit": "Canadian dollars per foreign currency unit",
"web_page": "https://www.bankofcanada.ca/?p=190892"
}Get group observations
Get the values of every series in a Bank of Canada group over a period, such as all the daily exchange rates, the benchmark bond yields or the CPI measures. Each series comes with its name, unit, every value in the period and the latest value. No API key required.
Inputs
- Group
grouptextRequired - The group of series, such as Daily exchange rates (FX_RATES_DAILY). The list holds every group, the common ones first; type to search it. Find groups by topic with Search groups.
- Period
periodtext - Which observations to get: the latest few, those of the last few weeks, months or years, those between two dates, or the whole history. The latest observations if left empty.One of:
latest(The latest observations),weeks(The last few weeks),months(The last few months),years(The last few years),dates(Between two dates),all(The whole history). Default:latest. - How many
countnumber - With The latest observations, how many observations of each series; with the last few weeks, months or years, how many weeks, months or years. 10 if left empty.Only when Period is The latest observations, The last few weeks, The last few months or The last few years. From 1 to 10000. Default:
10. - Start date
start_datedate - The first date to include. Leave it empty to start from the beginning of the data.Only when Period is Between two dates.
- End date
end_datedate - The last date to include. Leave it empty to go up to the latest observation.Only when Period is Between two dates.
- Order
ordertext - Oldest first or newest first. Oldest first if left empty.One of:
asc(Oldest first),desc(Newest first). Default:asc.
Outputs
countnumber- How many series are listed.
count_requestednumber- How many observations (or weeks, months or years) were asked for, when the period counts them.
descriptiontext- What the group holds, in the Bank's words.
end_datetext- The last date asked for, when the period is dates.
frequencytext- How often its series are published, when the Bank says.
grouptext- The group's name, as asked for, such as FX_RATES_DAILY.
labeltext- The group's title, such as Daily exchange rates.
ordertext- asc for oldest first, desc for newest first.
periodtext- Which observations were asked for: latest, weeks, months, years, dates or all.
serieslist- One entry per series in the group, in the Bank's order.
start_datetext- The first date asked for, when the period is dates.
total_observationsnumber- How many observations there are across every series.
unittext- The unit its series share, when the Bank gives one.
Example output
{
"count": 1,
"count_requested": 3,
"description": "Daily average exchange rates for various foreign currencies currently or historically published by the Bank of Canada, representing the value of one unit of foreign currency expressed in Canadian dollars.",
"end_date": null,
"frequency": "Business daily",
"group": "FX_RATES_DAILY",
"label": "Daily exchange rates",
"order": "asc",
"period": "latest",
"series": [
{
"average": 1.410166667,
"change": -0.01,
"count": 3,
"description": "Daily average exchange rate of the US dollar in Canadian dollars.",
"earliest_date": "2026-10-16",
"earliest_value": 1.4154,
"frequency": "Business daily",
"label": "USD/CAD",
"latest_date": "2026-10-20",
"latest_value": 1.4054,
"maximum": 1.4154,
"minimum": 1.4054,
"name": "FXUSDCAD",
"observations": [
{
"date": "2026-10-16",
"value": 1.4154
},
{
"date": "2026-10-19",
"value": 1.4097
},
{
"date": "2026-10-20",
"value": 1.4054
}
],
"percent_change": -0.7065,
"unit": "Canadian dollars per US dollar"
}
],
"start_date": null,
"total_observations": 3,
"unit": "Canadian dollars per foreign currency unit"
}Get inflation
Get Canada's inflation rate (the 12-month change in the Consumer Price Index) and the Bank of Canada's core measures (CPI-trim, CPI-median, CPI-common and CPI-XFET) for the latest months, with the Bank's 2% target and its 1% to 3% range. No API key required.
Inputs
- Months
monthsnumber - How many recent months to list, newest first. 12 if left empty.From 1 to 240. Default:
12.
Outputs
cpi_commonnumber- For the latest month: CPI-common, a core inflation measure, in percent.
cpi_indexnumber- For the latest month: The total Consumer Price Index itself (2002 = 100).
cpi_mediannumber- For the latest month: CPI-median, a core inflation measure, in percent.
cpi_trimnumber- For the latest month: CPI-trim, one of the Bank's preferred core inflation measures, in percent.
cpi_xfetnumber- For the latest month: CPI-XFET: inflation without food, energy and indirect taxes, over 12 months, in percent.
historylist- Each month asked for, newest first.
monthtext- The latest month published, as YYYY-MM.
summarytext- One sentence with the latest figures and the target, for a message.
targetnumber- The Bank's inflation target, in percent (2).
target_range_highnumber- The top of the target range, in percent (3).
target_range_lownumber- The bottom of the target range, in percent (1).
total_cpi_changenumber- For the latest month: Total CPI inflation: the change in consumer prices over 12 months, in percent (the headline inflation rate).
Example output
{
"cpi_common": 2.4,
"cpi_index": 170.0,
"cpi_median": 1.9,
"cpi_trim": 1.8,
"cpi_xfet": 2.1,
"history": [
{
"cpi_common": 2.4,
"cpi_index": 170.0,
"cpi_median": 1.9,
"cpi_trim": 1.8,
"cpi_xfet": 2.1,
"month": "2026-09",
"total_cpi_change": 3.1
},
{
"cpi_common": 2.6,
"cpi_index": 169.8,
"cpi_median": 2.0,
"cpi_trim": 1.9,
"cpi_xfet": 2.1,
"month": "2026-08",
"total_cpi_change": 3.0
}
],
"month": "2026-09",
"summary": "Inflation in Canada was 3.1% in September 2026 (core measures: CPI-trim 1.8%, CPI-median 1.9%, CPI-common 2.4%). The Bank's target is 2%, within a range of 1% to 3%.",
"target": 2.0,
"target_range_high": 3.0,
"target_range_low": 1.0,
"total_cpi_change": 3.1
}Get key interest rates
Get Canada's key interest rates in one step: the policy rate, CORRA, the bank rate, the prime rate, the 3-month treasury bill, the 2, 5, 10-year and long-term benchmark bond yields and the 5-year conventional mortgage rate. The latest values, or those on a date. No API key required.
Inputs
- Date
datedate - Get the rates as they were on this date (the latest published on or before it). Leave it empty for the latest rates.
Outputs
as_oftext- The most recent date among the rates, as YYYY-MM-DD.
bank_ratenumber- Bank rate, in percent.
bond_yield_10_yearnumber- Benchmark bond yield, 10-year, in percent.
bond_yield_2_yearnumber- Benchmark bond yield, 2-year, in percent.
bond_yield_5_yearnumber- Benchmark bond yield, 5-year, in percent.
bond_yield_long_termnumber- Benchmark bond yield, long-term, in percent.
corranumber- CORRA, the Canadian Overnight Repo Rate Average, in percent.
mortgage_5_yearnumber- Conventional mortgage rate, 5-year, in percent.
policy_ratenumber- Policy interest rate, in percent.
prime_ratenumber- Prime rate, in percent.
rateslist- Every rate with its name, series and date, in the order of the fields above.
requested_datetext- The date asked for, or null for the latest rates.
treasury_bill_3_monthnumber- Treasury bill yield, 3-month, in percent.
Example output
{
"as_of": "2026-10-21",
"bank_rate": 2.5,
"bond_yield_10_year": 3.9,
"bond_yield_2_year": 3.32,
"bond_yield_5_year": 3.62,
"bond_yield_long_term": 4.2,
"corra": 2.25,
"mortgage_5_year": 6.19,
"policy_rate": 2.25,
"prime_rate": 4.45,
"rates": [
{
"date": "2026-10-20",
"frequency": "Business daily",
"key": "policy_rate",
"name": "Policy interest rate",
"series": "V39079",
"value": 2.25
},
{
"date": "2026-10-20",
"frequency": "Business daily",
"key": "corra",
"name": "CORRA, the Canadian Overnight Repo Rate Average",
"series": "AVG.INTWO",
"value": 2.25
},
{
"date": "2026-10-20",
"frequency": "Daily",
"key": "bank_rate",
"name": "Bank rate",
"series": "V39078",
"value": 2.5
},
{
"date": "2026-10-14",
"frequency": "Weekly",
"key": "prime_rate",
"name": "Prime rate",
"series": "V80691311",
"value": 4.45
},
{
"date": "2026-10-20",
"frequency": "Business daily",
"key": "treasury_bill_3_month",
"name": "Treasury bill yield, 3-month",
"series": "TB.CDN.90D.MID",
"value": 2.5
},
{
"date": "2026-10-20",
"frequency": "Business daily",
"key": "bond_yield_2_year",
"name": "Benchmark bond yield, 2-year",
"series": "BD.CDN.2YR.DQ.YLD",
"value": 3.32
},
{
"date": "2026-10-20",
"frequency": "Business daily",
"key": "bond_yield_5_year",
"name": "Benchmark bond yield, 5-year",
"series": "BD.CDN.5YR.DQ.YLD",
"value": 3.62
},
{
"date": "2026-10-20",
"frequency": "Business daily",
"key": "bond_yield_10_year",
"name": "Benchmark bond yield, 10-year",
"series": "BD.CDN.10YR.DQ.YLD",
"value": 3.9
},
{
"date": "2026-10-20",
"frequency": "Business daily",
"key": "bond_yield_long_term",
"name": "Benchmark bond yield, long-term",
"series": "BD.CDN.LONG.DQ.YLD",
"value": 4.2
},
{
"date": "2026-10-21",
"frequency": "Weekly",
"key": "mortgage_5_year",
"name": "Conventional mortgage rate, 5-year",
"series": "V80691335",
"value": 6.19
}
],
"requested_date": null,
"treasury_bill_3_month": 2.5
}Get series details
Get a Bank of Canada series' details: its name, what it measures, its unit, how often it is published, and its latest value. No API key required.
Inputs
- Series
seriestextRequired - The series to describe. Pick a headline rate, an inflation measure or an exchange rate from the list, or type any of the Bank's 16,000 series ids, such as FXUSDCAD. Find ids with Search series.
Outputs
descriptiontext- What the series measures, in the Bank's words.
frequencytext- How often it is published, such as Business daily.
indexed_bytext- What its observations are keyed by: Date for nearly every series, or the key of an auction table.
labeltext- The series' short name, such as USD/CAD.
latest_datetext- The date of its most recent value.
latest_valuenumber- Its most recent value.
nametext- The series id, such as FXUSDCAD.
unittext- The unit of its values, when the Bank gives one.
Example output
{
"description": "Daily average exchange rate of the US dollar in Canadian dollars.",
"frequency": "Business daily",
"indexed_by": "Date",
"label": "USD/CAD",
"latest_date": "2026-10-20",
"latest_value": 1.4054,
"name": "FXUSDCAD",
"unit": "Canadian dollars per US dollar"
}Get series observations
Get the values of one or more Bank of Canada data series over a period: interest rates, exchange rates, inflation, bond yields or any other of its 16,000 series. Each series comes with its name, unit, every value in the period, the latest value, and the average, lowest and highest. No API key required.
Inputs
- Series
seriestextRequired - The series to get. Pick a headline rate, an inflation measure or an exchange rate from the list, or type any of the Bank's 16,000 series ids, such as FXUSDCAD. Find ids with Search series. Separate several ids with commas.
- Period
periodtext - Which observations to get: the latest few, those of the last few weeks, months or years, those between two dates, or the whole history. The latest observations if left empty.One of:
latest(The latest observations),weeks(The last few weeks),months(The last few months),years(The last few years),dates(Between two dates),all(The whole history). Default:latest. - How many
countnumber - With The latest observations, how many observations of each series; with the last few weeks, months or years, how many weeks, months or years. 10 if left empty.Only when Period is The latest observations, The last few weeks, The last few months or The last few years. From 1 to 10000. Default:
10. - Start date
start_datedate - The first date to include. Leave it empty to start from the beginning of the data.Only when Period is Between two dates.
- End date
end_datedate - The last date to include. Leave it empty to go up to the latest observation.Only when Period is Between two dates.
- Order
ordertext - Oldest first or newest first. Oldest first if left empty.One of:
asc(Oldest first),desc(Newest first). Default:asc.
Outputs
countnumber- How many series are listed.
count_requestednumber- How many observations (or weeks, months or years) were asked for, when the period counts them.
end_datetext- The last date asked for, when the period is dates.
ordertext- asc for oldest first, desc for newest first.
periodtext- Which observations were asked for: latest, weeks, months, years, dates or all.
serieslist- One entry per series, in the order they were named.
start_datetext- The first date asked for, when the period is dates.
total_observationsnumber- How many observations there are across every series.
Example output
{
"count": 2,
"count_requested": 3,
"end_date": null,
"order": "asc",
"period": "latest",
"series": [
{
"average": 1.410166667,
"change": -0.01,
"count": 3,
"description": "Daily average exchange rate of the US dollar in Canadian dollars.",
"earliest_date": "2026-10-16",
"earliest_value": 1.4154,
"frequency": "Business daily",
"label": "USD/CAD",
"latest_date": "2026-10-20",
"latest_value": 1.4054,
"maximum": 1.4154,
"minimum": 1.4054,
"name": "FXUSDCAD",
"observations": [
{
"date": "2026-10-16",
"value": 1.4154
},
{
"date": "2026-10-19",
"value": 1.4097
},
{
"date": "2026-10-20",
"value": 1.4054
}
],
"percent_change": -0.7065,
"unit": "Canadian dollars per US dollar"
},
{
"average": 2.25,
"change": 0.0,
"count": 3,
"description": "Also called the policy interest rate, the average rate that the Bank of Canada wants to see in the market for overnight money market financing. (V39079)",
"earliest_date": "2026-10-16",
"earliest_value": 2.25,
"frequency": "Business daily",
"label": "Target for the overnight rate (business daily)",
"latest_date": "2026-10-20",
"latest_value": 2.25,
"maximum": 2.25,
"minimum": 2.25,
"name": "V39079",
"observations": [
{
"date": "2026-10-16",
"value": 2.25
},
{
"date": "2026-10-19",
"value": 2.25
},
{
"date": "2026-10-20",
"value": 2.25
}
],
"percent_change": 0.0,
"unit": "Percent"
}
],
"start_date": null,
"total_observations": 6
}Get the latest exchange rates
Get the Bank of Canada's most recent daily exchange rates for every currency it publishes, in Canadian dollars and the other way round, with the change from the business day before. The Bank publishes them each business day by 16:30 Eastern time. No API key required.
Inputs
- Include discontinued currencies
include_discontinuedtrue/false - Also list the currencies the Bank no longer publishes (the Russian ruble, Saudi riyal and Vietnamese dong), with their last rates.Default:
false.
Outputs
countnumber- How many currencies are listed.
datetext- The date of the latest rates, as YYYY-MM-DD: the last business day the Bank published them.
rateslist- One entry per currency, by name (discontinued ones last, when included).
Example output
{
"count": 2,
"date": "2026-10-20",
"rates": [
{
"change": -0.0024,
"currency": "EUR",
"currency_name": "Euro",
"date": "2026-10-20",
"discontinued": false,
"inverse_rate": 0.6335,
"previous_date": "2026-10-19",
"previous_rate": 1.581,
"rate": 1.5786,
"series": "FXEURCAD"
},
{
"change": -0.0043,
"currency": "USD",
"currency_name": "US dollar",
"date": "2026-10-20",
"discontinued": false,
"inverse_rate": 0.7115,
"previous_date": "2026-10-19",
"previous_rate": 1.4097,
"rate": 1.4054,
"series": "FXUSDCAD"
}
]
}Get the policy interest rate
Get the Bank of Canada's policy interest rate (the target for the overnight rate) now, when it last changed and by how much, and every change in the last few years. No API key required.
Inputs
- Years of changes
yearsnumber - List the rate changes of this many years back (the data starts in 2009). 5 if left empty.From 1 to 30. Default:
5.
Outputs
change_countnumber- How many changes are listed.
changeslist- Every change in the years asked for, newest first.
datetext- The latest business day the rate is published for, as YYYY-MM-DD.
last_changenumber- The last change, in percentage points (-0.25 is a cut).
last_change_datetext- The first day at the current rate, as YYYY-MM-DD.
last_change_directiontext- increase or decrease.
previous_ratenumber- The rate before the last change, in percent.
ratenumber- The policy interest rate now, in percent, such as 2.25.
seriestext- The Bank's series id for the rate: V39079.
summarytext- One sentence with the rate and its last change, for a message.
yearsnumber- How many years back the changes go.
Example output
{
"change_count": 2,
"changes": [
{
"change": -0.25,
"date": "2025-10-30",
"direction": "decrease",
"previous_rate": 2.5,
"rate": 2.25
},
{
"change": -0.25,
"date": "2025-09-18",
"direction": "decrease",
"previous_rate": 2.75,
"rate": 2.5
}
],
"date": "2026-10-20",
"last_change": -0.25,
"last_change_date": "2025-10-30",
"last_change_direction": "decrease",
"previous_rate": 2.5,
"rate": 2.25,
"series": "V39079",
"summary": "The Bank of Canada's policy interest rate is 2.25% (as of 2026-10-20). It last changed on 2025-10-30, a decrease of 25 basis points from 2.5%.",
"years": 1
}Search groups
Find groups of Bank of Canada series by words in their name, title or description, such as exchange rates or bond yields, or list every group. Each group can then be read whole with Get group observations. No API key required.
Inputs
- Search for
querytext - Words the group's name, title or description must match. Leave it empty to list every group.
- Maximum results
limitnumber - How many groups to list at most. 50 if left empty.From 1 to 500. Default:
50.
Outputs
countnumber- How many groups are listed.
groupslist- The groups found, ordered by title as the Bank orders them.
has_moretrue/false- True when more match than are listed: raise the limit or narrow it.
querytext- The words searched for, or null to list all.
totalnumber- How many groups match in all.
Example output
{
"count": 2,
"groups": [
{
"description": "Annual average exchange rates for various foreign currencies currently or historically published by the Bank of Canada.",
"label": "Annual exchange rates",
"name": "FX_RATES_ANNUAL"
},
{
"description": "Daily average exchange rates for various foreign currencies currently or historically published by the Bank of Canada.",
"label": "Daily exchange rates",
"name": "FX_RATES_DAILY"
}
],
"has_more": false,
"query": "exchange rates",
"total": 2
}Search series
Find Bank of Canada data series by words in their id, name or description, such as mortgage or US dollar. Put a phrase in double quotes to match it exactly ("target for the overnight rate"). Leave the words empty to list every series. No API key required.
Inputs
- Search for
querytext - Words the series' id, name or description must match. Leave it empty to list every series.
- Maximum results
limitnumber - How many series to list at most. 50 if left empty.From 1 to 500. Default:
50.
Outputs
countnumber- How many series are listed.
has_moretrue/false- True when more match than are listed: raise the limit or narrow it.
querytext- The words searched for, or null to list all.
serieslist- The series found, ordered by name as the Bank orders them.
totalnumber- How many series match in all.
Example output
{
"count": 2,
"has_more": true,
"query": "\"target for the overnight rate\"",
"series": [
{
"description": "Also called the policy interest rate, the average rate that the Bank of Canada wants to see in the market for overnight money market financing. (V39079)",
"frequency": "Daily",
"label": "Target for the overnight rate (business daily)",
"name": "V39079"
},
{
"description": "Also called the policy interest rate, the average rate that the Bank of Canada wants to see in the market for overnight money market financing.",
"frequency": "Monthly",
"label": "Target for the overnight rate (end of month)",
"name": "STATIC_ATABLE_V39079"
}
],
"total": 4
}