{"openapi":"3.1.0","info":{"title":"Bank of Canada API","version":"1.0.0","description":"Live official central-bank data from the Bank of Canada's public Valet API — no key, nothing cached. The Bank of Canada is the only major central bank with a fully open data API, and this exposes the three things markets watch. The fx endpoint returns the official daily exchange rates for 24 currencies against the Canadian dollar — USD/CAD, EUR/CAD, GBP/CAD, JPY/CAD and more — each in both directions (Canadian dollars per unit and units per Canadian dollar) with the observation date; these are the Bank's official published reference rates, not a retail aggregator (USD/CAD resolves to about 1.39). The rates endpoint returns the Bank's policy interest rate — the overnight target that sets the price of money in Canada — plus CORRA, the Canadian Overnight Repo Rate Average benchmark, with recent history so you can see the last moves. The yields endpoint returns the Government of Canada benchmark bond-yield curve (2, 3, 5, 7, 10-year and long) with the 10y-2y spread. This is the official-rates layer for any forex, fixed-income, treasury, research or macro app that needs authoritative Canadian central-bank numbers. Live from the Bank of Canada, nothing stored. Distinct from ECB-based FX and US-Treasury yield APIs — this is the Bank of Canada's own data. 4 endpoints.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/bankofcanada-api","description":"oanor gateway"}],"tags":[{"name":"Rates"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/fx":{"get":{"operationId":"get_v1_fx","tags":["Rates"],"summary":"Official daily FX rates vs CAD","description":"","parameters":[{"name":"symbols","in":"query","required":false,"description":"Currencies (e.g. USD,EUR), or all 24","schema":{"type":"string"},"example":"USD,EUR,GBP,JPY"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"CAD","date":"2026-06-08","count":4,"rates":[{"pair":"USDCAD","currency":"USD","cad_per_unit":1.3947,"unit_per_cad":0.717},{"pair":"EURCAD","currency":"EUR","cad_per_unit":1.6094,"unit_per_cad":0.62135},{"pair":"GBPCAD","currency":"GBP","cad_per_unit":1.8615,"unit_per_cad":0.537201},{"pair":"JPYCAD","currency":"JPY","cad_per_unit":0.00871,"unit_per_cad":114.810563}],"source":"Bank of Canada official daily rates"},"meta":{"timestamp":"2026-06-09T11:39:48.744Z","request_id":"bc6e2934-3ca6-4c30-989e-9367ff5f26b2"},"status":"ok","message":"FX rates retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/rates":{"get":{"operationId":"get_v1_rates","tags":["Rates"],"summary":"Policy rate + CORRA","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"corra":{"date":"2026-05-27","name":"Canadian Overnight Repo Rate Average","rate_pct":2.25},"source":"Bank of Canada","policy_rate":{"date":"2026-05-27","name":"Target for the overnight rate","rate_pct":2.25},"policy_rate_history":[{"date":"2026-06-05","rate":2.25},{"date":"2026-06-04","rate":2.25},{"date":"2026-06-03","rate":2.25},{"date":"2026-06-02","rate":2.25},{"date":"2026-06-01","rate":2.25},{"date":"2026-05-29","rate":2.25},{"date":"2026-05-28","rate":2.25},{"date":"2026-05-27","rate":2.25}]},"meta":{"timestamp":"2026-06-09T11:39:49.275Z","request_id":"d831422c-4575-456a-93f0-cdf28d255f7d"},"status":"ok","message":"Policy rates retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/yields":{"get":{"operationId":"get_v1_yields","tags":["Rates"],"summary":"Government of Canada bond-yield curve","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"2026-06-05","count":6,"curve":[{"term":"2Y","yield_pct":2.87},{"term":"3Y","yield_pct":2.96},{"term":"5Y","yield_pct":3.14},{"term":"7Y","yield_pct":3.28},{"term":"10Y","yield_pct":3.48},{"term":"LONG","yield_pct":3.83}],"issuer":"Government of Canada","source":"Bank of Canada benchmark bond yields","country":"Canada","spread_10y_2y_bps":61},"meta":{"timestamp":"2026-06-09T11:39:49.570Z","request_id":"2da50b2f-9f91-466c-a6b6-120819ddde03"},"status":"ok","message":"Bond yields retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Bank of Canada Valet API (live)","service":"bankofcanada-api","endpoints":{"GET /v1/fx":"Official daily FX rates vs CAD (symbols=USD,EUR,… or all 24).","GET /v1/meta":"This document.","GET /v1/rates":"Policy interest rate (overnight target) + CORRA, with recent history.","GET /v1/yields":"Government of Canada benchmark bond-yield curve (2Y–long) + 10y-2y spread."},"description":"Live official Bank of Canada data from the public Valet API: official daily FX rates for 24 currencies against the Canadian dollar (both directions, with date); the policy interest rate (overnight target) plus CORRA with recent history; and the Government of Canada benchmark bond-yield curve (2/3/5/7/10-year and long) with the 10y-2y spread. Live, no key, nothing stored. Distinct from ECB-based FX and US-Treasury yield APIs — this is the Bank of Canada's own central-bank data.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T11:39:49.717Z","request_id":"f4fe6071-d3a7-453b-9463-6b832c0ea82a"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":12000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":800,"monthly_call_quota":145000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2200,"monthly_call_quota":660000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5300,"monthly_call_quota":3300000,"rps_limit":30,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/bankofcanada-api"}