---
type: "firecrawl-provider"
description: "Official Bank of Canada data from the keyless Valet API and the Bank's RSS feeds: the policy interest rate in effect on any date with its change history, daily CAD exchange rates, Government of Canada benchmark bond yields, any of about 16,000 Valet series and 2,600 groups (CORRA, CPI and commodity price indexes, bank rates, auction results) with catalogue search and details, press releases, speeches and publications, and policy rate announcements with their decisions."
use_when: "Official Bank of Canada data from the keyless Valet API and the Bank's RSS feeds: the policy interest rate in effect on any date with its change history, daily CAD exchange rates, Government of Canada benchmark bond yields, any of about 16,000 Valet series and 2,600 groups (CORRA, CPI and commodity price indexes, bank rates, auction results) with catalogue search and details, press releases, speeches and publications, and policy rate announcements with their decisions."
categories: "Public records"
capabilities: 8
credits_per_call: 5
---
# Bank of Canada (Valet API and press feeds) on Firecrawl Alexandria

Official Bank of Canada data from the keyless Valet API and the Bank's RSS feeds: the policy interest rate in effect on any date with its change history, daily CAD exchange rates, Government of Canada benchmark bond yields, any of about 16,000 Valet series and 2,600 groups (CORRA, CPI and commodity price indexes, bank rates, auction results) with catalogue search and details, press releases, speeches and publications, and policy rate announcements with their decisions.

- Categories: Public records
- Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records)
- Provider key: `bankofcanada-ca`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/bankofcanada-ca)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/bankofcanada-ca/openapi.json)

## Capabilities

- [Bond yields](https://firecrawl.dev/alexandria/agents/providers/bankofcanada-ca/economic-data/bond_yields): Government of Canada benchmark bond yields from the Bank of Canada (Valet group bond_yields_benchmark): 2, 3, 5, 7 and 10-year, long-term and Real Return Bond yields in percent, for the latest business day, one date, a range or the latest N days.
- [Describe series](https://firecrawl.dev/alexandria/agents/providers/bankofcanada-ca/economic-data/describe_series): Details of one Bank of Canada Valet series (label, description, unit, frequency, date format) or one group (label, description, unit, page link and its member series).
- [Fx rates](https://firecrawl.dev/alexandria/agents/providers/bankofcanada-ca/economic-data/fx_rates): Bank of Canada daily average exchange rates (Canadian dollars per unit of about 26 foreign currencies, published each business day by 16:30 ET): the latest day by default, one date, a date range or the latest N days, for chosen currencies or every published rate, each with the inverse rate.
- [News](https://firecrawl.dev/alexandria/agents/providers/bankofcanada-ca/economic-data/news): Bank of Canada press releases, announcements, speeches, media advisories, market notices, upcoming events, Monetary Policy Reports, summaries of deliberations, Financial Stability Reports, Business Outlook Surveys and staff papers from the Bank's official RSS feeds, ten per page, newest first, with optional word filtering within the page.
- [Observations](https://firecrawl.dev/alexandria/agents/providers/bankofcanada-ca/economic-data/observations): Observations of any Bank of Canada Valet series (up to 20, e.g. V39079, FXUSDCAD, BD.CDN.10YR.DQ.YLD, CPI and commodity price indexes) or of one series group (e.g. CORRA, bond_yields_all, chartered_bank_interest, AUC_BOND_RESULTS auction results), for a date range, the latest N observations or the last N weeks, months or years, as one row per period and series with the raw value and its number.
- [Policy rate](https://firecrawl.dev/alexandria/agents/providers/bankofcanada-ca/economic-data/policy_rate): The Bank of Canada policy interest rate (target for the overnight rate, Valet series V39079): the rate in effect today or on any date since 1992, the most recent change and every change in the history window (three years back by default), each with the previous rate and the move in basis points.
- [Rate announcements](https://firecrawl.dev/alexandria/agents/providers/bankofcanada-ca/economic-data/rate_announcements): The Bank of Canada's scheduled policy interest rate announcements, newest first, found in its press release feed: date, title, link, summary, the decision (hold, cut or hike), the target overnight rate and the move in basis points. Scans up to 15 feed pages.
- [Search series](https://firecrawl.dev/alexandria/agents/providers/bankofcanada-ca/economic-data/search_series): Search the Bank of Canada Valet catalogue (about 16,000 series and 2,600 groups) by words in the name, label and description, best matches first, with each result's details and observations URLs.

## 1. Choose this provider when

Official Bank of Canada data from the keyless Valet API and the Bank's RSS feeds: the policy interest rate in effect on any date with its change history, daily CAD exchange rates, Government of Canada benchmark bond yields, any of about 16,000 Valet series and 2,600 groups (CORRA, CPI and commodity price indexes, bank rates, auction results) with catalogue search and details, press releases, speeches and publications, and policy rate announcements with their decisions.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "bankofcanada-ca",
  "capability": "economic-data/bond_yields",
  "options": {
    "date": "2026-10-22"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `date` (string): One day, YYYY-MM-DD. Weekends and holidays have no yields (not_found). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<date>`
- `end_date` (string): Range end, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<end_date>`
- `recent` (number): The latest N observations per series instead of a date or range. Example: `10`
- `start_date` (string): Range start, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<start_date>`
- `terms` (string[]): Terms to return. Default: all seven. Example: `[]`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "bankofcanada-ca",
    capability: "economic-data/bond_yields",
    options: {
      date: "2026-10-22",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "bankofcanada-ca",
  "capability": "economic-data/bond_yields",
  "options": {
    "date": "2026-10-22"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "bankofcanada-ca",
    "capability": "economic-data/bond_yields",
    "options": {
      "date": "2026-10-22"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'bankofcanada-ca/economic-data/bond_yields' \
  --options '{"date":"2026-10-22"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "bankofcanada-ca",
  "capability": "economic-data/bond_yields",
  "options": {
    "date": "2026-10-22"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "bankofcanada-ca",
  "capability": "economic-data/bond_yields",
  "options": {
    "date": "2026-10-22"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "attribution": "Source: Bank of Canada",
  "latest_date": "2026-10-22",
  "observed_at_ms": 1792968769000,
  "source_url": "https://www.bankofcanada.ca/valet/observations/group/bond_yields_benchmark/json?start_date=2026-10-22&end_date=2026-10-22",
  "terms_url": "https://www.bankofcanada.ca/terms/",
  "yield_count": 7,
  "yields": [
    {
      "date": "2026-10-22",
      "label": "Benchmark bond yield, 2-year",
      "series": "BD.CDN.2YR.DQ.YLD",
      "term": "2y",
      "yield_percent": 3.22
    },
    {
      "date": "2026-10-22",
      "label": "Benchmark bond yield, 3-year",
      "series": "BD.CDN.3YR.DQ.YLD",
      "term": "3y",
      "yield_percent": 3.32
    },
    {
      "date": "2026-10-22",
      "label": "Benchmark bond yield, 5-year",
      "series": "BD.CDN.5YR.DQ.YLD",
      "term": "5y",
      "yield_percent": 3.5
    },
    {
      "date": "2026-10-22",
      "label": "Benchmark bond yield, 7-year",
      "series": "BD.CDN.7YR.DQ.YLD",
      "term": "7y",
      "yield_percent": 3.58
    },
    {
      "date": "2026-10-22",
      "label": "Benchmark bond yield, 10-year",
      "series": "BD.CDN.10YR.DQ.YLD",
      "term": "10y",
      "yield_percent": 3.78
    },
    {
      "date": "2026-10-22",
      "label": "Benchmark bond yield, long-term",
      "series": "BD.CDN.LONG.DQ.YLD",
      "term": "long",
      "yield_percent": 4.1
    },
    {
      "date": "2026-10-22",
      "label": "Real Return Bonds yield, long-term",
      "series": "BD.CDN.RRB.DQ.YLD",
      "term": "real_return",
      "yield_percent": 1.85
    }
  ]
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Bond yields

- Capability: `economic-data/bond_yields`
- Description: Government of Canada benchmark bond yields from the Bank of Canada (Valet group bond_yields_benchmark): 2, 3, 5, 7 and 10-year, long-term and Real Return Bond yields in percent, for the latest business day, one date, a range or the latest N days.
- Instructions: Canadian government bond yields or the yield curve on a date, e.g. the 10-year Canada yield today or its path over a month.
- Cost: 5 credits per call
- Capability file: [Bond yields](https://firecrawl.dev/alexandria/agents/providers/bankofcanada-ca/economic-data/bond_yields)

Accepted options:
- `date` (string): One day, YYYY-MM-DD. Weekends and holidays have no yields (not_found). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<date>`
- `end_date` (string): Range end, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<end_date>`
- `recent` (number): The latest N observations per series instead of a date or range. Example: `10`
- `start_date` (string): Range start, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<start_date>`
- `terms` (string[]): Terms to return. Default: all seven. Example: `[]`

Response schema example:
```json
{
  "attribution": "Source: Bank of Canada",
  "latest_date": "2026-10-22",
  "observed_at_ms": 1792968769000,
  "source_url": "https://www.bankofcanada.ca/valet/observations/group/bond_yields_benchmark/json?start_date=2026-10-22&end_date=2026-10-22",
  "terms_url": "https://www.bankofcanada.ca/terms/",
  "yield_count": 7,
  "yields": [
    {
      "date": "2026-10-22",
      "label": "Benchmark bond yield, 2-year",
      "series": "BD.CDN.2YR.DQ.YLD",
      "term": "2y",
      "yield_percent": 3.22
    },
    {
      "date": "2026-10-22",
      "label": "Benchmark bond yield, 3-year",
      "series": "BD.CDN.3YR.DQ.YLD",
      "term": "3y",
      "yield_percent": 3.32
    },
    {
      "date": "2026-10-22",
      "label": "Benchmark bond yield, 5-year",
      "series": "BD.CDN.5YR.DQ.YLD",
      "term": "5y",
      "yield_percent": 3.5
    },
    {
      "date": "2026-10-22",
      "label": "Benchmark bond yield, 7-year",
      "series": "BD.CDN.7YR.DQ.YLD",
      "term": "7y",
      "yield_percent": 3.58
    },
    {
      "date": "2026-10-22",
      "label": "Benchmark bond yield, 10-year",
      "series": "BD.CDN.10YR.DQ.YLD",
      "term": "10y",
      "yield_percent": 3.78
    },
    {
      "date": "2026-10-22",
      "label": "Benchmark bond yield, long-term",
      "series": "BD.CDN.LONG.DQ.YLD",
      "term": "long",
      "yield_percent": 4.1
    },
    {
      "date": "2026-10-22",
      "label": "Real Return Bonds yield, long-term",
      "series": "BD.CDN.RRB.DQ.YLD",
      "term": "real_return",
      "yield_percent": 1.85
    }
  ]
}
```

### Describe series

- Capability: `economic-data/describe_series`
- Description: Details of one Bank of Canada Valet series (label, description, unit, frequency, date format) or one group (label, description, unit, page link and its member series).
- Instructions: Checking what a Valet series measures and its unit, or listing the series inside a group, before fetching observations.
- Cost: 5 credits per call
- Capability file: [Describe series](https://firecrawl.dev/alexandria/agents/providers/bankofcanada-ca/economic-data/describe_series)

Accepted options:
- `group` (string): Group name, e.g. bond_yields_benchmark. Exclusive with series. Pattern: ^[A-Za-z0-9._-]+$. Example: `<group>`
- `series` (string): Series name, e.g. FXUSDCAD. Exclusive with group. Pattern: ^[A-Za-z0-9._-]+$. Example: `<series>`

Response schema example:
```json
{
  "attribution": "Source: Bank of Canada",
  "date_format": "daily",
  "description": "Daily average exchange rate of the US dollar in Canadian dollars.",
  "frequency": "Business daily",
  "group_series": [],
  "kind": "series",
  "label": "USD/CAD",
  "name": "FXUSDCAD",
  "observations_url": "https://www.bankofcanada.ca/valet/observations/FXUSDCAD/json",
  "observed_at_ms": 1792968770445,
  "page_url": null,
  "source_url": "https://www.bankofcanada.ca/valet/series/FXUSDCAD/json",
  "terms_url": "https://www.bankofcanada.ca/terms/",
  "unit": "Canadian dollars per US dollar"
}
```

### Fx rates

- Capability: `economic-data/fx_rates`
- Description: Bank of Canada daily average exchange rates (Canadian dollars per unit of about 26 foreign currencies, published each business day by 16:30 ET): the latest day by default, one date, a date range or the latest N days, for chosen currencies or every published rate, each with the inverse rate.
- Instructions: Official CAD exchange rates, e.g. USD/CAD on a date, the latest EUR/CAD, a month of rates for invoicing or tax conversions.
- Cost: 5 credits per call
- Capability file: [Fx rates](https://firecrawl.dev/alexandria/agents/providers/bankofcanada-ca/economic-data/fx_rates)

Accepted options:
- `currencies` (string[]): ISO 4217 codes, e.g. ["USD", "EUR"]. Case-insensitive; CAD is not a series. Default: every currently published rate. Example: `[]`
- `date` (string): One day, YYYY-MM-DD. Weekends and Bank holidays have no rates (not_found). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<date>`
- `end_date` (string): Range end, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<end_date>`
- `recent` (number): The latest N observations per series instead of a date or range. Example: `10`
- `start_date` (string): Range start, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<start_date>`

Response schema example:
```json
{
  "attribution": "Source: Bank of Canada",
  "currencies": [
    "EUR",
    "USD"
  ],
  "latest_date": "2026-10-23",
  "note": "Bank of Canada daily exchange rates are indicative averages of aggregated quotes, published once each business day by 16:30 ET as Canadian dollars per unit of foreign currency. There are no rates for weekends or Bank of Canada holidays. units_per_cad is derived by this program as 1 / cad_per_unit, rounded to 8 significant digits.",
  "observed_at_ms": 1792968772049,
  "rate_count": 2,
  "rates": [
    {
      "cad_per_unit": 1.5667,
      "currency": "EUR",
      "date": "2026-10-23",
      "label": "EUR/CAD",
      "series": "FXEURCAD",
      "units_per_cad": 0.63828429
    },
    {
      "cad_per_unit": 1.3993,
      "currency": "USD",
      "date": "2026-10-23",
      "label": "USD/CAD",
      "series": "FXUSDCAD",
      "units_per_cad": 0.71464304
    }
  ],
  "source_url": "https://www.bankofcanada.ca/valet/observations/FXUSDCAD,FXEURCAD/json?start_date=2026-10-23&end_date=2026-10-23",
  "terms_url": "https://www.bankofcanada.ca/terms/"
}
```

### News

- Capability: `economic-data/news`
- Description: Bank of Canada press releases, announcements, speeches, media advisories, market notices, upcoming events, Monetary Policy Reports, summaries of deliberations, Financial Stability Reports, Business Outlook Surveys and staff papers from the Bank's official RSS feeds, ten per page, newest first, with optional word filtering within the page.
- Instructions: Recent Bank of Canada news or publications, a press release list, upcoming speeches and events, or paging back through the archive.
- Cost: 5 credits per call
- Capability file: [News](https://firecrawl.dev/alexandria/agents/providers/bankofcanada-ca/economic-data/news)

Accepted options:
- `category` (string): Default press_releases. Example: `press_releases`
- `page` (number): Feed page, ten items each. Default 1. A page past the end is an empty result. Example: `10`
- `query` (string): Words that must all appear in an item's title or description, applied within the page. Example: `<query>`

Response schema example:
```json
{
  "attribution": "Source: Bank of Canada",
  "category": "press_releases",
  "category_label": "Press releases (including policy rate announcements)",
  "has_more": true,
  "item_count": 10,
  "items": [
    {
      "description": "The Board of Directors of the Bank of Canada has initiated a recruitment process to fill the external Deputy Governor position left vacant by the appointment of Nicolas Vincent as a full-time Deputy Governor.",
      "occurrence_date": "2026-09-10",
      "published_at": "2026-09-10T11:00:09+00:00",
      "title": "Bank of Canada Board launches process to fill external Deputy Governor position",
      "type": "Announcement",
      "url": "https://www.bankofcanada.ca/2026/09/bank-canada-board-launches-process-fill-external-deputy-governor-position/"
    },
    {
      "description": "Her Excellency the Right Honourable Louise Arbour, Governor General of Canada, and the Honourable Wayne Long, Secretary of State (Canada Revenue Agency and Financial Institutions), joined Bank of Canada Governor Tiff Macklem today at an event to unveil Canada’s new vertical $20 bank note featuring a portrait of His Majesty King Charles III.",
      "occurrence_date": "2026-09-03",
      "published_at": "2026-09-03T13:20:16+00:00",
      "title": "Bank of Canada unveils new vertical $20 bank note",
      "type": "Announcement",
      "url": "https://www.bankofcanada.ca/2026/09/bank-canada-unveils-new-vertical-20-bank-note/"
    },
    {
      "description": "The Bank of Canada today held its target for the overnight rate at 2.25%, with the Bank Rate at 2.5% and the deposit rate at 2.20%.",
      "occurrence_date": "2026-09-02",
      "published_at": "2026-09-02T09:47:53+00:00",
      "title": "Bank of Canada maintains the policy rate at 2¼%",
      "type": "Announcement",
      "url": "https://www.bankofcanada.ca/2026/09/fad-press-release-2026-09-02/"
    },
    {
      "description": "The G7 Cyber Expert Group (CEG) successfully concluded its 2026 Cross-border coordination exercise (CBCE) on May 18, 2026. This exercise demonstrates the Group’s ongoing commitment to strengthening cyber resilience across the G7 financial sector.",
      "occurrence_date": "2026-07-31",
      "published_at": "2026-07-31T09:30:53+00:00",
      "title": "G7 2026 Cross-Border Coordination Exercise (CBCE)",
      "type": "Announcement",
      "url": "https://www.bankofcanada.ca/2026/07/g7-2026-cross-border-coordination-exercise-cbce/"
    },
    {
      "description": "The Bank of Canada today published its 2027 schedule for policy interest rate announcements and the release of the quarterly Monetary Policy Report.",
      "occurrence_date": "2026-07-27",
      "published_at": "2026-07-27T10:00:38+00:00",
      "title": "Bank of Canada publishes its 2027 schedule for policy interest rate announcements and other major publications",
      "type": "Announcement",
      "url": "https://www.bankofcanada.ca/2026/07/bank-canada-publishes-2027-schedule-policy-interest-rate-announcements-other-major-publications/"
    },
    {
      "description": "The Bank of Canada today held its target for the overnight rate at 2.25%, with the Bank Rate at 2.5% and the deposit rate at 2.20%.",
      "occurrence_date": "2026-07-15",
      "published_at": "2026-07-15T09:47:46+00:00",
      "title": "Bank of Canada maintains the policy rate at 2¼%",
      "type": "Announcement",
      "url": "https://www.bankofcanada.ca/2026/07/fad-press-release-2026-07-15/"
    },
    {
      "description": "The Bank of Canada today published a report summarizing the feedback it received from stakeholders and the Canadian public during consultations on its monetary policy framework.",
      "occurrence_date": "2026-06-25",
      "published_at": "2026-06-25T15:00:55+00:00",
      "title": "Bank of Canada publishes report on monetary policy framework consultations",
      "type": "Announcement",
      "url": "https://www.bankofcanada.ca/2026/06/bank-canada-publishes-report-monetary-policy-framework-consultations/"
    },
    {
      "description": "The Bank of Canada today held its target for the overnight rate at 2.25%, with the Bank Rate at 2.5% and the deposit rate at 2.20%.",
      "occurrence_date": "2026-06-10",
      "published_at": "2026-06-10T09:47:13+00:00",
      "title": "Bank of Canada maintains the policy rate at 2¼%",
      "type": "Announcement",
      "url": "https://www.bankofcanada.ca/2026/06/fad-press-release-2026-06-10/"
    },
    {
      "description": "The Bank of Canada announced today it is joining the Bank for International Settlements’ Project Agorá, an initiative exploring how tokenization could improve wholesale cross-border payments.",
      "occurrence_date": "2026-05-27",
      "published_at": "2026-05-27T09:00:10+00:00",
      "title": "Bank of Canada joins BIS Project Agorá to test improvements in wholesale cross-border payments",
      "type": "Announcement",
      "url": "https://www.bankofcanada.ca/2026/05/bank-canada-joins-bis-project-agora-test-improvements-wholesale-cross-border-payments/"
    },
    {
      "description": "Ethan McDonagh and Andrew Leong have won the Bank of Canada Museum’s 2026 Award for Excellence in Teaching Economics.",
      "occurrence_date": "2026-05-19",
      "published_at": "2026-05-19T10:00:13+00:00",
      "title": "Bank of Canada Museum honours two Canadian educators for innovation in the classroom",
      "type": "Announcement",
      "url": "https://www.bankofcanada.ca/2026/05/bank-canada-museum-honours-two-canadian-educators-innovation-classroom/"
    }
  ],
  "next_page": 2,
  "observed_at_ms": 1792968773511,
  "page": 1,
  "page_item_count": 10,
  "query": null,
  "source_url": "https://www.bankofcanada.ca/content_type/press-releases/feed/",
  "terms_url": "https://www.bankofcanada.ca/terms/"
}
```

### Observations

- Capability: `economic-data/observations`
- Description: Observations of any Bank of Canada Valet series (up to 20, e.g. V39079, FXUSDCAD, BD.CDN.10YR.DQ.YLD, CPI and commodity price indexes) or of one series group (e.g. CORRA, bond_yields_all, chartered_bank_interest, AUC_BOND_RESULTS auction results), for a date range, the latest N observations or the last N weeks, months or years, as one row per period and series with the raw value and its number.
- Instructions: Any Bank of Canada statistic not covered by policy_rate, fx_rates or bond_yields, or a Valet observations URL someone pasted; find names with search_series.
- Cost: 5 credits per call
- Capability file: [Observations](https://firecrawl.dev/alexandria/agents/providers/bankofcanada-ca/economic-data/observations)

Accepted options:
- `end_date` (string): Range end, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<end_date>`
- `group` (string): One Valet group name. Exclusive with series. Pattern: ^[A-Za-z0-9._-]+$. Example: `<group>`
- `max_observations` (number): Cap on returned values (default 2000); more is reported as partial coverage. Example: `10`
- `order` (string): Row order by period key. Default desc (newest first). Example: `asc`
- `recent` (number): The latest N observations per series instead of a date or range. Example: `10`
- `recent_months` (number): recent_months Example: `10`
- `recent_weeks` (number): recent_weeks Example: `10`
- `recent_years` (number): recent_years Example: `10`
- `series` (string[]): Valet series names. Exclusive with group. Example: `[]`
- `start_date` (string): Range start, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<start_date>`

Response schema example:
```json
{
  "attribution": "Source: Bank of Canada",
  "dimension": {
    "key": "d",
    "name": "Date"
  },
  "group": null,
  "observation_count": 10,
  "observations": [
    {
      "key": "2026-10-09",
      "number": 1.4271,
      "series": "FXUSDCAD",
      "value": "1.4271"
    },
    {
      "key": "2026-10-09",
      "number": 2.25,
      "series": "V39079",
      "value": "2.25"
    },
    {
      "key": "2026-10-08",
      "number": 1.424,
      "series": "FXUSDCAD",
      "value": "1.4240"
    },
    {
      "key": "2026-10-08",
      "number": 2.25,
      "series": "V39079",
      "value": "2.25"
    },
    {
      "key": "2026-10-07",
      "number": 1.4257,
      "series": "FXUSDCAD",
      "value": "1.4257"
    },
    {
      "key": "2026-10-07",
      "number": 2.25,
      "series": "V39079",
      "value": "2.25"
    },
    {
      "key": "2026-10-06",
      "number": 1.4226,
      "series": "FXUSDCAD",
      "value": "1.4226"
    },
    {
      "key": "2026-10-06",
      "number": 2.25,
      "series": "V39079",
      "value": "2.25"
    },
    {
      "key": "2026-10-05",
      "number": 1.4254,
      "series": "FXUSDCAD",
      "value": "1.4254"
    },
    {
      "key": "2026-10-05",
      "number": 2.25,
      "series": "V39079",
      "value": "2.25"
    }
  ],
  "observed_at_ms": 1792968775262,
  "period_count": 5,
  "series": [
    {
      "date_format": "daily",
      "description": "Daily average exchange rate of the US dollar in Canadian dollars.",
      "frequency": "Business daily",
      "label": "USD/CAD",
      "name": "FXUSDCAD",
      "unit": "Canadian dollars per US dollar"
    },
    {
      "date_format": "daily",
      "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": "Business daily",
      "label": "Target for the overnight rate (business daily)",
      "name": "V39079",
      "unit": "Percent"
    }
  ],
  "source_url": "https://www.bankofcanada.ca/valet/observations/V39079,FXUSDCAD/json?start_date=2026-10-05&end_date=2026-10-09",
  "target": {
    "kind": "series",
    "names": [
      "V39079",
      "FXUSDCAD"
    ]
  },
  "terms_url": "https://www.bankofcanada.ca/terms/",
  "truncated": false
}
```

### Policy rate

- Capability: `economic-data/policy_rate`
- Description: The Bank of Canada policy interest rate (target for the overnight rate, Valet series V39079): the rate in effect today or on any date since 1992, the most recent change and every change in the history window (three years back by default), each with the previous rate and the move in basis points.
- Instructions: The current Canadian policy rate, the rate in effect on a given date (e.g. at the end of a quarter, for comparison with other central banks), or when and by how much the Bank last moved it.
- Cost: 5 credits per call
- Capability file: [Policy rate](https://firecrawl.dev/alexandria/agents/providers/bankofcanada-ca/economic-data/policy_rate)

Accepted options:
- `date` (string): As-of date, YYYY-MM-DD. The rate in effect on it is the latest business-day observation on or before it. Default: the latest published. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<date>`
- `start_date` (string): Start of the change history, YYYY-MM-DD. Default: three years before date (or the last three years). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<start_date>`

Response schema example:
```json
{
  "as_of": "2026-09-30",
  "attribution": "Source: Bank of Canada",
  "changes": [
    {
      "change_bps": -25,
      "date": "2025-10-30",
      "previous_rate_percent": 2.5,
      "rate_percent": 2.25
    },
    {
      "change_bps": -25,
      "date": "2025-09-18",
      "previous_rate_percent": 2.75,
      "rate_percent": 2.5
    },
    {
      "change_bps": -25,
      "date": "2025-03-13",
      "previous_rate_percent": 3,
      "rate_percent": 2.75
    },
    {
      "change_bps": -25,
      "date": "2025-01-30",
      "previous_rate_percent": 3.25,
      "rate_percent": 3
    },
    {
      "change_bps": -50,
      "date": "2024-12-12",
      "previous_rate_percent": 3.75,
      "rate_percent": 3.25
    },
    {
      "change_bps": -50,
      "date": "2024-10-24",
      "previous_rate_percent": 4.25,
      "rate_percent": 3.75
    },
    {
      "change_bps": -25,
      "date": "2024-09-05",
      "previous_rate_percent": 4.5,
      "rate_percent": 4.25
    },
    {
      "change_bps": -25,
      "date": "2024-07-25",
      "previous_rate_percent": 4.75,
      "rate_percent": 4.5
    },
    {
      "change_bps": -25,
      "date": "2024-06-06",
      "previous_rate_percent": 5,
      "rate_percent": 4.75
    }
  ],
  "history": {
    "end_date": "2026-09-30",
    "observation_count": 778,
    "start_date": "2023-10-02"
  },
  "label": "Target for the overnight rate (business daily)",
  "last_change": {
    "change_bps": -25,
    "date": "2025-10-30",
    "previous_rate_percent": 2.5,
    "rate_percent": 2.25
  },
  "note": "The policy interest rate is the Bank of Canada's target for the overnight rate (Valet series V39079, business daily). The rate in effect on a date is the latest business-day observation on or before it.",
  "observation_date": "2026-09-30",
  "observed_at_ms": 1792968776874,
  "rate_percent": 2.25,
  "series": "V39079",
  "source_url": "https://www.bankofcanada.ca/valet/observations/V39079/json?start_date=2023-09-30&end_date=2026-09-30",
  "terms_url": "https://www.bankofcanada.ca/terms/",
  "unit": "Percent"
}
```

### Rate announcements

- Capability: `economic-data/rate_announcements`
- Description: The Bank of Canada's scheduled policy interest rate announcements, newest first, found in its press release feed: date, title, link, summary, the decision (hold, cut or hike), the target overnight rate and the move in basis points. Scans up to 15 feed pages.
- Instructions: The latest Bank of Canada rate decisions and their wording, e.g. what the Bank decided at its last meetings and the links to each announcement.
- Cost: 5 credits per call
- Capability file: [Rate announcements](https://firecrawl.dev/alexandria/agents/providers/bankofcanada-ca/economic-data/rate_announcements)

Accepted options:
- `limit` (number): Announcements to return. Default 8 (about one year). Example: `10`

Response schema example:
```json
{
  "announcements": [
    {
      "change_bps": 0,
      "date": "2026-09-02",
      "decision": "hold",
      "published_at": "2026-09-02T09:47:53+00:00",
      "summary": "The Bank of Canada today held its target for the overnight rate at 2.25%, with the Bank Rate at 2.5% and the deposit rate at 2.20%.",
      "target_rate_percent": 2.25,
      "title": "Bank of Canada maintains the policy rate at 2¼%",
      "url": "https://www.bankofcanada.ca/2026/09/fad-press-release-2026-09-02/"
    },
    {
      "change_bps": 0,
      "date": "2026-07-15",
      "decision": "hold",
      "published_at": "2026-07-15T09:47:46+00:00",
      "summary": "The Bank of Canada today held its target for the overnight rate at 2.25%, with the Bank Rate at 2.5% and the deposit rate at 2.20%.",
      "target_rate_percent": 2.25,
      "title": "Bank of Canada maintains the policy rate at 2¼%",
      "url": "https://www.bankofcanada.ca/2026/07/fad-press-release-2026-07-15/"
    },
    {
      "change_bps": 0,
      "date": "2026-06-10",
      "decision": "hold",
      "published_at": "2026-06-10T09:47:13+00:00",
      "summary": "The Bank of Canada today held its target for the overnight rate at 2.25%, with the Bank Rate at 2.5% and the deposit rate at 2.20%.",
      "target_rate_percent": 2.25,
      "title": "Bank of Canada maintains the policy rate at 2¼%",
      "url": "https://www.bankofcanada.ca/2026/06/fad-press-release-2026-06-10/"
    }
  ],
  "attribution": "Source: Bank of Canada",
  "feed_exhausted": false,
  "items_scanned": 10,
  "observed_at_ms": 1792968778262,
  "pages_scanned": 1,
  "returned": 3,
  "source_url": "https://www.bankofcanada.ca/content_type/press-releases/feed/",
  "terms_url": "https://www.bankofcanada.ca/terms/"
}
```

### Search series

- Capability: `economic-data/search_series`
- Description: Search the Bank of Canada Valet catalogue (about 16,000 series and 2,600 groups) by words in the name, label and description, best matches first, with each result's details and observations URLs.
- Instructions: Finding the Valet series or group name for a statistic (e.g. CORRA, prime rate, CPI, commodity prices, mortgage rates, auction results) before calling observations.
- Cost: 5 credits per call
- Capability file: [Search series](https://firecrawl.dev/alexandria/agents/providers/bankofcanada-ca/economic-data/search_series)

Accepted options:
- `kind` (string): Default all. Example: `series`
- `limit` (number): Default 20. Example: `10`
- `query` (string, required): Words that must all appear, e.g. "overnight rate" or "10-year bond". Example: `<query>`

Response schema example:
```json
{
  "attribution": "Source: Bank of Canada",
  "kind": "all",
  "match_count": 43,
  "observed_at_ms": 1792968779529,
  "query": "overnight rate",
  "results": [
    {
      "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.",
      "kind": "series",
      "label": "Target for the overnight rate (end of month)",
      "name": "STATIC_ATABLE_V39079",
      "observations_url": "https://www.bankofcanada.ca/valet/observations/STATIC_ATABLE_V39079/json",
      "valet_url": "https://www.bankofcanada.ca/valet/series/STATIC_ATABLE_V39079/json"
    },
    {
      "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)",
      "kind": "series",
      "label": "Target for the overnight rate (business daily)",
      "name": "V39079",
      "observations_url": "https://www.bankofcanada.ca/valet/observations/V39079/json",
      "valet_url": "https://www.bankofcanada.ca/valet/series/V39079/json"
    },
    {
      "description": "The rate at which major participants in the money market borrow and lend one-day funds to each other.",
      "kind": "series",
      "label": "Overnight rate",
      "name": "V122514",
      "observations_url": "https://www.bankofcanada.ca/valet/observations/V122514/json",
      "valet_url": "https://www.bankofcanada.ca/valet/series/V122514/json"
    },
    {
      "description": "This file contains data based on the Bank of Canada research paper described above. The data is not an official statistical release by the Bank of Canada, and it is provided on a voluntary basis by the author(s). The Bank and the author(s) are not responsible for errors in this file and do not guarantee that the series will be updated in the future.\nSources:\nBloomberg Finance L.P., Bloomberg Finance L.P./Bank of America Merrill Lynch, Haver Analytics, Board of Governors of the Federal Reserve System and Bank of Canada calculations.\nNote from the author(s):\nDates for Chart 2 are arbitrary and not associated with any particular time period. It displays a hypothetical shock in 2018 and its associated responses over 3 subsequent years.",
      "kind": "group",
      "label": "Overnight rate",
      "name": "SAN_LEBM180118_CHART2F",
      "observations_url": "https://www.bankofcanada.ca/valet/observations/group/SAN_LEBM180118_CHART2F/json",
      "valet_url": "https://www.bankofcanada.ca/valet/groups/SAN_LEBM180118_CHART2F/json"
    },
    {
      "description": null,
      "kind": "series",
      "label": "Bank of Canada (BoC) overnight rate (left scale)",
      "name": "SAN_FONT20250113_C4_S1",
      "observations_url": "https://www.bankofcanada.ca/valet/observations/SAN_FONT20250113_C4_S1/json",
      "valet_url": "https://www.bankofcanada.ca/valet/series/SAN_FONT20250113_C4_S1/json"
    }
  ],
  "returned": 5,
  "source_url": "https://www.bankofcanada.ca/valet/lists/series/json",
  "terms_url": "https://www.bankofcanada.ca/terms/",
  "total_groups": 2579,
  "total_series": 16237
}
```
