Bank of Canada Valet API: Official Exchange Rate Data

What the Bank of Canada Valet API is

The Bank of Canada Valet API is a free, public web service that delivers the Bank's published economic and financial data in machine-readable form. Instead of copying figures from a web page, software can request a named series and receive dated values back in JSON or CSV. The Bank's documentation explains every endpoint, parameter and output field.

For anyone sending money internationally from Canada, the most relevant part of the service is the exchange rate data. The Bank publishes Canadian-dollar exchange rates against a defined list of foreign currencies, and those same series are available through Valet. The API delivers the Bank's official published data; it does not create a separate set of numbers.

Access does not require an account, an API key or a paid subscription. That makes the service usable by developers, accountants, small businesses and individuals who want an independent, citable reference rate. Terms of use and any usage expectations are set out in the Bank's documentation, which is the authoritative source for how the service behaves.

What the Valet API publishes

Valet covers a broad range of Bank of Canada data, including policy interest rates, bond yields and exchange rates. Each dataset has a short series code. The code FXUSDCAD, for example, identifies the United States dollar expressed in Canadian dollars. Other currencies follow the same pattern, and the documentation lists the full set of available series.

The exchange rate series are nominal, indicative rates. They are published for reference and analysis, and the Bank does not buy or sell currency at those rates for the general public. The list of quoted currencies is defined by the Bank and includes major trading currencies such as the United States dollar, euro, British pound and Japanese yen, alongside others.

The Bank publishes each business day's rate once, and no new value appears on weekends or Canadian statutory holidays. Dates that fall outside the publishing schedule simply have no observation. When you request a date range, you receive only the dates for which the Bank published a value.

How to request data from the Valet API

Requests are made with a simple URL. A typical request points at the observations endpoint, names the series and ends with the desired format, for example /valet/observations/FXUSDCAD/json. Date-range parameters such as start_date and end_date narrow the response to the period you need, which keeps downloads small and easy to store.

Responses pair a date with a value for each requested series, so a single call can return several currencies at once. A separate endpoint returns series metadata, such as the series name, description and unit of measure. CSV output suits spreadsheets and accounting records, while JSON suits software that reads the data programmatically.

How published rates relate to transfers from Canada

A transfer provider sets its own exchange rate and fees. The rate a provider quotes usually differs from the Bank's published rate, and that difference is one of the ways a transfer is priced. A published reference rate gives you a neutral, independent figure to compare against.

Because some services advertise low or zero fees while applying a margin to the exchange rate, the quoted rate alone does not show total cost. The Financial Consumer Agency of Canada advises comparing offers by the total amount the recipient receives rather than only the headline fee.

The Bank's currency converter uses the same published rates and can show what a given amount is worth at the reference rate. Comparing that figure with a provider's quote does not tell you which service to choose, but it shows how much of the difference comes from the exchange rate margin rather than an explicit fee.

How often the data is updated and how to verify it

Exchange rate data follows the Bank's publishing calendar: one observation per business day. The Bank does not revise a published daily rate to reflect later trading. If you need the current value, read it from the Bank's daily exchange rates page or from the API itself rather than relying on a saved copy.

To verify a figure, check the daily exchange rates page, which lists the most recent published rates, then confirm the same value through the currency converter or the API. If another site shows a different number, it is likely using a live market feed, a different timestamp or its own commercial rate.

For record-keeping, capture the published rate on the date of the transaction and note the source. Saving the date, the series code and the value lets you rebuild a calculation later, and it is also a practical way to respect the terms of use described in the Bank's documentation.

Key terms in the Valet output

A few terms make Valet output easier to read. Every response is built from series and observations. A series is a named dataset with its own code, units and publishing schedule. An observation is one value in that series, tied to a date. Nothing in the output is a quote you can transact at.

The daily exchange rates are nominal, indicative figures for the Canadian dollar. They are not the buy and sell prices a bank or a money services business offers to customers, and they do not include fees. Keeping that distinction clear prevents misreading a reference figure as a guaranteed transfer rate.

• Series code — the short identifier for one dataset, such as the code for a currency pair.
• Observation — a single published value paired with its date.
• Nominal exchange rate — the quoted price of one currency in another, before any fees.
• Reference rate — a published benchmark rate used for comparison and reporting.
• Spread or margin — the difference between a reference rate and the rate a provider offers.
• Business day — a day on which the Bank publishes data; weekends and statutory holidays are excluded.

Tax records, regulation and provider checks

For Canadian tax purposes, foreign-currency income and expenses generally have to be reported in Canadian dollars, which means converting amounts at a published exchange rate and keeping a record of the rate used. The Canada Revenue Agency publishes guidance on foreign income and on reporting specified foreign property.

Where the total cost of specified foreign property exceeds one hundred thousand Canadian dollars at any time in a year, a T1135 information return is generally required. Rates used in those calculations should come from a published, verifiable source, and the Bank's series are designed for exactly that kind of reference use.

Transfer providers operating as money services businesses in Canada are registered with FINTRAC and must meet anti-money-laundering obligations. Checking that registration, and watching for common fraud patterns reported by the Canadian Anti-Fraud Centre, is a separate step from reading exchange rate data but part of sending money safely.