Reference · built on requestCommons signalEconomic & calendar reference

Bank of Canada Valet API

Daily exchange rates, the policy rate, CORRA and bond yields from the Bank of Canada Valet API in JSON, CSV or XML, with no key.

About

The Bank of Canada Valet API is the Bank's web service for the data it publishes: exchange rates, the target for the overnight rate, CORRA, Government of Canada bond yields, the Bank of Canada commodity price index and the statistics behind its reports. Every series and every group has a name, and the lists route enumerates all of them. Requests need no registration and no key.

Through Fibric, an operator reads the daily exchange rates and the rates it tracks, converts the foreign-currency amounts in your orders, payouts and invoices at the Bank's rate for the day, and proposes the adjustments for a person to approve.

This is a reference listing. It documents what Fibric would read from Bank of Canada Valet API and what it could propose, based on the publisher's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • Daily average exchange rates in the FX_RATES_DAILY group, one series per pair such as FXUSDCAD, published once each business day by 16:30 ET
  • Monthly and annual averages in FX_RATES_MONTHLY and FX_RATES_ANNUAL, and reciprocal daily rates in FX_RATES_RECIPROCAL
  • The target for the overnight rate, the Bank Rate (BR.CDN) and CORRA (AVG.INTWO) with its transparency statistics
  • Selected benchmark and marketable Government of Canada bond yields in the bond_yields_benchmark and bond_yields_marketable groups
  • Series and group definitions from /lists/series and /lists/groups, and data from /observations/{seriesNames} or /observations/group/{groupName}
  • The most recent observation for every exchange rate as RSS from /fx_rss

Proposed actions

Read-only. This feed informs operators; it changes nothing.

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Check a Canadian-dollar price list against the rate it was set at

    Read FXUSDCAD for today and for the day the list was priced. Propose a price list review when the gap crosses your threshold, with both rates attached.

    With Price List Drift

  • Reconcile marketplace payouts settled in US dollars

    Match a payout's converted amount to the FX_RATES_DAILY rate for the settlement date and put the difference in front of finance to accept or dispute.

    With Payout Reconciliation

  • Declare customs values in Canadian dollars

    Take the daily rate for the shipment date and propose the declared value in Canadian dollars, with the rate and series name recorded on the declaration.

    With Customs Declaration

  • Put the policy rate and yields in the board pack

    Pull the target for the overnight rate and the benchmark bond yields for the period and place them beside your finance metrics with a source line.

    With Board Pack

Requirements

  • The series or group names you need, taken from /lists/series/json or /lists/groups/json
  • A once-a-day fetch for exchange rates, since the Bank publishes them once each business day
  • Attribution to the Bank of Canada as the source, with an indication if changes were made
  • Slow starts at peak times and a back-off on retries, as the how-to guide asks
Authentication
None. The Valet API needs no registration and no access key; the Bank asks you to follow its terms of use and to cache data that updates once a day.

Limits

  • recent, recent_weeks, recent_months and recent_years cannot be combined with start_date and end_date in one request
  • Date parameters apply only to time series, and the Bank notes a brief processing delay between publication and the API
  • Exchange rates are indicative averages of aggregated quotes from financial institutions; the current daily series begin in 2017
  • The Bank publishes no numeric rate limit; the how-to guide asks for slow starts, back-off on retry and caching

Access and pricing

Reference listing. Public feed access is separate from Fibric integration. If you request this feed, your quote covers the build, usage, and support.

Request Bank of Canada Valet API ↗

Questions and answers

Do I need an API key for the Valet API?
No. The Bank's how-to guide states that no registration and no access key are needed and that there is no cost. It asks you to follow the terms of use, start slowly at peak times, back off on retries, and cache data that updates once a day, such as exchange rates.
Which formats and filters does Valet support?
JSON, CSV or XML, chosen by the format segment of the path, with JSON as the default. Observations can be filtered with start_date and end_date, or with recent, recent_weeks, recent_months or recent_years, and ordered with order_dir set to asc or desc.
When are the daily exchange rates published?
Once each business day by 16:30 ET. The Bank describes them as indicative rates obtained from averages of aggregated price quotes from financial institutions. The current daily series begin in 2017; earlier noon and closing rates are kept separately as historical data.
Ask about Bank of Canada Valet API

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.