BOC (BOC_OVERNIGHT) Rate Change

BOC (BOC_OVERNIGHT) Rate Change

BOC (BOC_OVERNIGHT) Rate Change: Build Robust Finance Integrations with the Interest Rates API

You need a reliable way to programmatically track and analyze changes in the Bank of Canada Overnight Rate inside your fintech product. By the end of this guide you will fetch the BOC_OVERNIGHT rate with a single GET call, read effective dates and units correctly, compute spreads or monthly payments from returned values, and build time series, fluctuation, and OHLC views in your application using https://interestratesapi.com.

Illustration: BOC (BOC_OVERNIGHT) Rate Change

What the BOC_OVERNIGHT Rate Represents

BOC_OVERNIGHT is the Bank of Canada Overnight Rate. It is a central bank policy rate used across Canadian dollar (CAD) funding markets and as a reference for loans, mortgages, and treasury operations. In the Interest Rates API, BOC_OVERNIGHT is a central bank symbol with monthly frequency. For monthly symbols, historical requests use the last available day with data in the requested month. The values are returned as percentages (e.g., 2.5 means 2.5% per annum unless otherwise noted in the series documentation).

Why it matters:

  • Loan and mortgage repricing: Many variable-rate products reference central bank policy rates.
  • Risk and treasury management: Sensitivity to policy shifts drives funding costs and hedging.
  • Macro research: Policy rate changes anchor expectations across the yield curve.

All examples below use the base URL https://interestratesapi.com/api/v1/ and GET requests authenticated via the api_key query parameter. For more, see the MCP or visit interestratesapi.com.

How to Find and Verify the Symbol with /symbols

Use /symbols to discover rate identifiers and metadata. You can filter by category, base currency, or provider, then read fields like frequency and description to verify you’re querying the right series.

cURL

curl -s "https://interestratesapi.com/api/v1/latest?api_key=YOUR_API_KEY&symbols=BOC_OVERNIGHT"

Python (requests)

import requests

resp = requests.get(
"https://interestratesapi.com/api/v1/symbols",
params={"category": "central_bank", "base": "CAD", "api_key": "YOUR_API_KEY"}
)
symbols = resp.json()
print(symbols.get("symbols", []))

JavaScript (fetch)

const res = await fetch(
"https://interestratesapi.com/api/v1/symbols?category=central_bank&base=CAD&api_key=YOUR_API_KEY"
);
const body = await res.json();
console.log(body.symbols);

PHP

<?php
$url = "https://interestratesapi.com/api/v1/symbols?category=central_bank&base=CAD&api_key=YOUR_API_KEY";
$body = file_get_contents($url);
$data = json_decode($body, true);
print_r($data['symbols'] ?? []);

Key fields you’ll use:

  • symbol: BOC_OVERNIGHT (Bank of Canada Overnight Rate)
  • frequency: monthly (for this symbol)
  • currency_code: CAD
  • category: central_bank

Once you’ve confirmed the symbol and metadata, you can fetch actual values using the endpoints below. Learn more at interestratesapi.com.

Get the Latest BOC_OVERNIGHT Value with /latest

The /latest endpoint returns the most recent available value for each requested symbol, along with effective dates and currency codes. Authentication is via api_key query parameter, and the method is GET.

Official cURL (copy-paste exactly)

Official JSON (verbatim)

{
    "success": true,
    "date": "2026-10-31",
    "base": "CAD",
    "rates": {
        "BOC_OVERNIGHT": 2.5
    },
    "dates": {
        "BOC_OVERNIGHT": "2026-10-31"
    },
    "currencies": {
        "BOC_OVERNIGHT": "CAD"
    },
    "base_filter_note": null
}

How to read this:

  • rates: a map of symbol to numeric percentage value (2.5 means 2.5%).
  • dates: a map of symbol to effective date for the returned value. For monthly symbols, the effective date is typically the last day with data in that month.
  • currencies: a map to confirm currency_code (CAD for BOC_OVERNIGHT).
  • date: the API’s response date context. Use dates[symbol] as the effective date for your logic.

Python (requests)

import requests

r = requests.get(
"https://interestratesapi.com/api/v1/latest",
params={"symbols": "BOC_OVERNIGHT", "api_key": "YOUR_API_KEY"}
)
j = r.json()
rate = j["rates"]["BOC_OVERNIGHT"]
effective_date = j["dates"]["BOC_OVERNIGHT"]
currency = j["currencies"]["BOC_OVERNIGHT"]
print(rate, effective_date, currency)

JavaScript (fetch)

const resp = await fetch(
"https://interestratesapi.com/api/v1/latest?symbols=BOC_OVERNIGHT&api_key=YOUR_API_KEY"
);
const data = await resp.json();
const rate = data.rates["BOC_OVERNIGHT"];
const eff = data.dates["BOC_OVERNIGHT"];
const ccy = data.currencies["BOC_OVERNIGHT"];
console.log({ rate, eff, ccy });

PHP

<?php
$url = "https://interestratesapi.com/api/v1/latest?symbols=BOC_OVERNIGHT&api_key=YOUR_API_KEY";
$body = file_get_contents($url);
$j = json_decode($body, true);
$rate = $j["rates"]["BOC_OVERNIGHT"] ?? null;
$eff = $j["dates"]["BOC_OVERNIGHT"] ?? null;
$ccy = $j["currencies"]["BOC_OVERNIGHT"] ?? null;
var_dump($rate, $eff, $ccy);

Practical notes:

  • Units: percentages as decimals (2.5 means 2.5%).
  • Caching: for central bank policy rates, cache until the next expected publication window or when you detect a change. Use dates[symbol] to invalidate cache when the effective date rolls.
  • Business days: if a rate is monthly, do not expect a new value on weekends/holidays. Use the monthly effective date for charge or accrual cutovers.

Get your API key to test this now: Register.

Fetch a Specific Month with /historical

/historical lets you query the rate on a given date. For monthly symbols, the API uses the last available day with data within that month.

cURL

Sample JSON

Reading the response:

  • rates.BOC_OVERNIGHT: the percentage value for that month (illustrative in the sample JSON).
  • date: the requested date; the value corresponds to the month containing that date, using the last day with data in that month.
  • currencies: currency code for the symbol.

Python (requests)

import requests

resp = requests.get(
"https://interestratesapi.com/api/v1/historical",
params={"date": "2025-06-15", "symbols": "BOC_OVERNIGHT", "api_key": "YOUR_API_KEY"}
)
hist = resp.json()
value = hist["rates"]["BOC_OVERNIGHT"]
print(value)

JavaScript (fetch)

const r = await fetch(
"https://interestratesapi.com/api/v1/historical?date=2025-06-15&symbols=BOC_OVERNIGHT&api_key=YOUR_API_KEY"
);
const h = await r.json();
console.log(h.rates["BOC_OVERNIGHT"]);

PHP

<?php
$url = "https://interestratesapi.com/api/v1/historical?date=2025-06-15&symbols=BOC_OVERNIGHT&api_key=YOUR_API_KEY";
$body = file_get_contents($url);
$j = json_decode($body, true);
echo $j["rates"]["BOC_OVERNIGHT"] ?? null;

Tip: The “monthly” behavior is important for analytics windows (month-end processes, accounting, and variable-rate loan statements). Use the last-day-with-data rule for alignment.

Build a Time Series with /timeseries

/timeseries returns a date-indexed series for each symbol between start and end. This is ideal for charts, analytics, and change detection workflows.

cURL

Sample JSON

Reading the response:

  • rates.BOC_OVERNIGHT: map of YYYY-MM-DD to percentage value.
  • frequencies[symbol]: the observed frequency in the returned series.
  • start_date/end_date: the inclusive bounds processed by the API.

Python (requests)

import requests

resp = requests.get(
"https://interestratesapi.com/api/v1/timeseries",
params={"start": "2025-11-12", "end": "2026-11-12", "symbols": "BOC_OVERNIGHT", "api_key": "YOUR_API_KEY"}
)
series = resp.json()
points = series["rates"]["BOC_OVERNIGHT"]
for d, v in sorted(points.items()):
print(d, v)

JavaScript (fetch)

const res = await fetch(
"https://interestratesapi.com/api/v1/timeseries?start=2025-11-12&end=2026-11-12&symbols=BOC_OVERNIGHT&api_key=YOUR_API_KEY"
);
const s = await res.json();
const entries = Object.entries(s.rates["BOC_OVERNIGHT"]);
entries.sort(([d1],[d2]) => d1.localeCompare(d2));
console.log(entries);

PHP

<?php
$url = "https://interestratesapi.com/api/v1/timeseries?start=2025-11-12&end=2026-11-12&symbols=BOC_OVERNIGHT&api_key=YOUR_API_KEY";
$body = file_get_contents($url);
$j = json_decode($body, true);
$points = $j["rates"]["BOC_OVERNIGHT"] ?? [];
ksort($points);
print_r($points);

Engineering tip: Align your charting and analytics windows with the returned dates. For monthly symbols, consider resampling the series to month-end if your dashboard expects one point per month.

Measure Changes with /fluctuation

/fluctuation computes change statistics between two dates for requested symbols. Use it to populate “rate change” badges, summary cards, or alert thresholds.

cURL

Sample JSON

Key fields:

  • start_value, end_value: the rate at the range boundaries.
  • change, change_pct: absolute and percent change across the range.
  • high, low: extremes within the range.

Python (requests)

import requests

r = requests.get(
"https://interestratesapi.com/api/v1/fluctuation",
params={"start": "2025-11-12", "end": "2026-11-12", "symbols": "BOC_OVERNIGHT", "api_key": "YOUR_API_KEY"}
)
f = r.json()["rates"]["BOC_OVERNIGHT"]
print(f["change"], f["change_pct"], f["high"], f["low"])

JavaScript (fetch)

const r = await fetch(
"https://interestratesapi.com/api/v1/fluctuation?start=2025-11-12&end=2026-11-12&symbols=BOC_OVERNIGHT&api_key=YOUR_API_KEY"
);
const f = await r.json();
const stats = f.rates["BOC_OVERNIGHT"];
console.log(stats);

PHP

<?php
$url = "https://interestratesapi.com/api/v1/fluctuation?start=2025-11-12&end=2026-11-12&symbols=BOC_OVERNIGHT&api_key=YOUR_API_KEY";
$body = file_get_contents($url);
$j = json_decode($body, true);
$st = $j["rates"]["BOC_OVERNIGHT"] ?? [];
print_r($st);

Use change_pct for normalized comparisons, and change for absolute moves. If you’re surfacing alerts, key off change or high/low breaches.

Aggregate Candles with /ohlc

/ohlc computes open, high, low, close candlesticks from daily observations on-the-fly, grouped by period (weekly, monthly, quarterly). This is efficient for chart libraries expecting OHLC inputs.

cURL

Sample JSON

Key fields:

  • open, high, low, close: derived from underlying daily data within the period.
  • data_points: count of daily observations used to build the candle.
  • period: the YYYY-MM label for monthly aggregation (or week/quarter label as applicable).

Python (requests)

import requests

res = requests.get(
"https://interestratesapi.com/api/v1/ohlc",
params={"symbols": "BOC_OVERNIGHT", "period": "monthly", "start": "2025-11-12", "end": "2026-11-12", "api_key": "YOUR_API_KEY"}
)
ohlc = res.json()["rates"]["BOC_OVERNIGHT"]
for candle in ohlc:
print(candle["period"], candle["open"], candle["close"], candle["data_points"])

JavaScript (fetch)

const resp = await fetch(
"https://interestratesapi.com/api/v1/ohlc?symbols=BOC_OVERNIGHT&period=monthly&start=2025-11-12&end=2026-11-12&api_key=YOUR_API_KEY"
);
const o = await resp.json();
console.log(o.rates["BOC_OVERNIGHT"]);

PHP

<?php
$url = "https://interestratesapi.com/api/v1/ohlc?symbols=BOC_OVERNIGHT&period=monthly&start=2025-11-12&end=2026-11-12&api_key=YOUR_API_KEY";
$body = file_get_contents($url);
$j = json_decode($body, true);
print_r($j["rates"]["BOC_OVERNIGHT"] ?? []);

Tip: Candles are dynamic and recomputed as daily data changes. Cache OHLC responses by (symbol, period, start, end) and invalidate when you detect a new daily close or policy update.

Compare Loan Interest Costs with /convert

/convert compares the total simple interest cost for a specified amount and term between two rate symbols based on their latest values. This is useful to quantify spreads and cost differences in dashboards.

cURL

Sample JSON

Reading the response:

  • from/to.rate: latest percentage values used for the calculation.
  • total_interest: interest over the specified term for a simple loan assumption.
  • difference.rate_spread: the rate differential in percentage points.

Python (requests)

import requests

resp = requests.get(
"https://interestratesapi.com/api/v1/convert",
params={"from": "BOC_OVERNIGHT", "to": "ECB_MRO", "amount": 100000, "term_months": 12, "api_key": "YOUR_API_KEY"}
)
comparison = resp.json()
print(comparison["difference"])

JavaScript (fetch)

const res = await fetch(
"https://interestratesapi.com/api/v1/convert?from=BOC_OVERNIGHT&to=ECB_MRO&amount=100000&term_months=12&api_key=YOUR_API_KEY"
);
const cmp = await res.json();
console.log(cmp.difference);

PHP

<?php
$url = "https://interestratesapi.com/api/v1/convert?from=BOC_OVERNIGHT&to=ECB_MRO&amount=100000&term_months=12&api_key=YOUR_API_KEY";
$body = file_get_contents($url);
$j = json_decode($body, true);
print_r($j["difference"] ?? []);

Note: If you need amortized payments instead of simple interest, retrieve the latest rate from /latest, convert the percent to a periodic rate, and apply your amortization formula client-side (example shown later in this article).

How to Compute Spreads and Monthly Payments from Returned Values

Spreads:

  • To compute a spread between BOC_OVERNIGHT and another symbol, call /latest for both symbols in one request (or use /convert which includes rate_spread). Subtract the two percentage values: spread_pp = rate_A - rate_B. Keep units as percentage points.

Monthly payment (amortized loan):

  • Obtain r_annual from /latest (e.g., rate = 2.5 means r_annual = 0.025 as a decimal).
  • Choose compounding convention consistent with your product (e.g., monthly). Derive r_monthly = r_annual / 12 unless you model a different compounding basis.
  • For principal P and term n months, the standard fixed-payment formula is: Payment = P * r_monthly / (1 - (1 + r_monthly)^(-n)).
  • Do not hardcode values; read them programmatically from the API so your UI updates on rate changes.

Accruals and day count:

  • Returned values are annualized percentages. If you compute prorated interest, convert to a daily or monthly rate consistent with your chosen day count convention (e.g., 30/360, ACT/365). Apply the convention your product supports; the API returns the percentage rate, not the convention.

Error Handling, Rate Limits, Caching, and Business-Day Behavior

Error shape:

  • All error responses use success=false with an error message string. Some 404s also include details.
  • Common statuses: 401 (missing/invalid api_key), 403 (inactive plan), 404 (no symbols or no data for the requested period), 422 (validation error), 429 (quota exhausted; Retry-After and X-RateLimit-* headers present).

Rate limiting headers:

  • X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset help you implement backoff and retries.

Caching strategies:

  • For BOC_OVERNIGHT, cache latest responses and invalidate when dates[symbol] changes.
  • For time series and OHLC, cache by parameter tuple (symbol, start, end, period). Invalidate when you detect a new effective date after publication.

Business days and publication:

  • BOC_OVERNIGHT is monthly in this API. Do not expect new values on weekends or holidays. When reconciling to statements or dashboards, align with the returned dates[symbol] field and month-end processes.

Learn more implementation details at interestratesapi.com and the MCP.

Putting It All Together: A Minimal BOC_OVERNIGHT Dashboard Flow

Recommended sequence:

  1. Discovery: Call /symbols once at startup (filtered by category=central_bank and base=CAD) to confirm BOC_OVERNIGHT metadata.
  2. Latest tile: Call /latest for BOC_OVERNIGHT. Display value, effective date, and currency.
  3. Sparkline: Call /timeseries for the past 12–24 months, resample as needed for monthly display.
  4. Change summary: Call /fluctuation over YTD or a chosen window and surface change and change_pct.
  5. Candle chart: Call /ohlc with period=monthly for visually clean aggregates.
  6. Loan comparison: Use /convert when you need a quick, API-side comparison between BOC_OVERNIGHT and another policy rate.

All requests are GET, append api_key as a query parameter, and return JSON suitable for direct binding into frontend or backend code.

FAQ

Q1: How is the BOC_OVERNIGHT rate expressed in the API?
A1: As a percentage value. For example, 2.5 in the response means 2.5% per annum.

Q2: Which date should I treat as the effective date?
A2: Use dates['BOC_OVERNIGHT'] from the /latest response (or the keys in /timeseries) as your effective date for the rate in your application logic.

Q3: How do monthly symbols behave on /historical?
A3: For monthly symbols, the API returns the value using the last day with data within that month of the requested date.

Q4: Can I compute a monthly payment directly from /convert?
A4: /convert returns simple interest totals for comparison. For amortized payments, retrieve the rate via /latest and apply your amortization formula client-side using the returned percentage.

Q5: What should I cache and when should I refresh?
A5: Cache /latest until the effective date changes; cache /timeseries and /ohlc by parameter tuple. Refresh on policy announcements or when you detect new effective dates from the API.

Ship your BOC_OVERNIGHT integration now. Create an API key and start calling the endpoints above: Register. Read endpoint details in the MCP and explore more rates at interestratesapi.com.

Ready to get started?

Get your API key and start validating bank data in minutes.

Get API Key