You need the Swiss National Bank’s policy rate inside your application, with reliable timestamps, currency context (CHF), and tools to plot changes, compute spreads, and translate rate moves into loan costs. By the end of this guide, you’ll query SNB_POLICY_RATE from the Interest Rates API, interpret the fields correctly, handle monthly publication nuances, cache responses, and build production-ready analytics for dashboards, lending, treasury, or research workflows.
What the Swiss National Bank Policy Rate (SNB_POLICY_RATE) Represents
SNB_POLICY_RATE is the Swiss National Bank’s policy interest rate, expressed as a percentage rate per annum and denominated in CHF. It’s a central bank policy lever that influences short-term market rates, lending conditions, and CHF funding costs. In the Interest Rates API, SNB_POLICY_RATE is provided with monthly frequency, which means:
- Publication frequency: monthly. The API’s
frequencymetadata for this symbol is monthly. - Effective dates: when you request a specific calendar date, monthly symbols resolve to the last available day with data within that month.
- Use in software: pricing variable-rate loans in CHF, setting treasury benchmarks for internal transfer pricing, backtesting policy cycles, or monitoring monetary stance in macro dashboards.
All examples below use the official endpoints from interestratesapi.com, which delivers central bank and interbank benchmarks as JSON over REST with GET and API key authentication via the api_key query parameter only.
Authentication and Base URL
Every request to the Interest Rates API:
- Base URL:
https://interestratesapi.com/api/v1/ - HTTP method:
GET(no POST/PUT/DELETE) - Authentication:
?api_key=YOUR_API_KEYas a query parameter
If you need an API key, visit Register. For integration details, see the MCP page, and browse interestratesapi.com to learn more about available rate categories.
Reading Values, Dates, and Currency Fields
SNB_POLICY_RATE is returned as a numeric percentage. For example, a value of 1.75 means 1.75% per annum. The response includes:
rates: map from symbol to numeric rate.dates(when provided): per-symbol effective date for the value returned.currencies: per-symbol currency code (CHF for SNB_POLICY_RATE).
Because SNB_POLICY_RATE is monthly, if you query a daily endpoint period (like /timeseries), the service may repeat the current monthly value across business days or provide daily continuity aligned to data availability. Use dates or the series timestamps to align policy moves to your models. For historical month queries, /historical uses the last day with data in the requested month.
Endpoint 1: Catalogue of Available Rate Symbols — GET /api/v1/symbols
Use this to discover symbols and metadata (category, country, currency, frequency). You can filter for central bank rates and CHF, or fetch the full list and search for SNB_POLICY_RATE client-side.
cURL
curl -s "https://interestratesapi.com/api/v1/latest?api_key=YOUR_API_KEY&symbols=SNB_POLICY_RATE"
Python (requests)
import requests
params = {
'category': 'central_bank',
'base': 'CHF', # filter by currency to find SNB_POLICY_RATE
'api_key': 'YOUR_KEY'
}
r = requests.get('https://interestratesapi.com/api/v1/symbols', params=params)
data = r.json()
# search for the entry where symbol == 'SNB_POLICY_RATE'
JavaScript (fetch)
const url = 'https://interestratesapi.com/api/v1/symbols?category=central_bank&base=CHF&api_key=YOUR_KEY';
const response = await fetch(url);
const data = await response.json();
// Find data.symbols.find(s => s.symbol === 'SNB_POLICY_RATE')
PHP
<?php
$url = 'https://interestratesapi.com/api/v1/symbols?category=central_bank&base=CHF&api_key=YOUR_KEY';
$json = file_get_contents($url);
$data = json_decode($json, true);
// Iterate $data['symbols'] to locate SNB_POLICY_RATE
?>
JSON response (example)
{
"success": true,
"date": "2026-10-31",
"base": "CHF",
"rates": {
"SNB_POLICY_RATE": 0
},
"dates": {
"SNB_POLICY_RATE": "2026-10-31"
},
"currencies": {
"SNB_POLICY_RATE": "CHF"
},
"base_filter_note": null
}
Key fields: symbol is the identifier you pass to other endpoints. frequency helps you design queries and caching logic for monthly versus daily series.
Endpoint 2: Latest Value — GET /api/v1/latest
Fetch the most recent available SNB policy rate. This is the foundation for dashboards, alerts, and loan calculations keyed to the current policy stance.
cURL (official sample; copy as-is)
Python (requests)
import requests
response = requests.get(
'https://interestratesapi.com/api/v1/latest',
params=dict(symbols='SNB_POLICY_RATE', api_key='YOUR_API_KEY')
)
data = response.json()
rate = data['rates']['SNB_POLICY_RATE']
effective_date = data.get('dates', {}).get('SNB_POLICY_RATE', data.get('date'))
currency = data.get('currencies', {}).get('SNB_POLICY_RATE', 'CHF')
JavaScript (fetch)
const response = await fetch(
'https://interestratesapi.com/api/v1/latest?api_key=YOUR_API_KEY&symbols=SNB_POLICY_RATE'
);
const data = await response.json();
const rate = data.rates.SNB_POLICY_RATE;
const effectiveDate = (data.dates && data.dates.SNB_POLICY_RATE) || data.date;
const currency = data.currencies && data.currencies.SNB_POLICY_RATE;
PHP
<?php
$url = 'https://interestratesapi.com/api/v1/latest?api_key=YOUR_API_KEY&symbols=SNB_POLICY_RATE';
$json = file_get_contents($url);
$data = json_decode($json, true);
$rate = $data['rates']['SNB_POLICY_RATE'];
$effectiveDate = $data['dates']['SNB_POLICY_RATE'] ?? $data['date'];
$currency = $data['currencies']['SNB_POLICY_RATE'] ?? 'CHF';
?>
JSON response (official sample; copy as-is)
How to read this:
rates.SNB_POLICY_RATE: the latest policy rate as a percentage (per annum).dates.SNB_POLICY_RATE: the effective date for that rate value.currencies.SNB_POLICY_RATE:CHF, the currency context.
Endpoint 3: Value on a Specific Date — GET /api/v1/historical
Get the SNB policy rate for a target date. For monthly symbols like SNB_POLICY_RATE, the API uses the last day with data in that month if you pass any date within the month.
cURL
Python (requests)
import requests
params = {
'date': '2025-06-15',
'symbols': 'SNB_POLICY_RATE',
'api_key': 'YOUR_KEY'
}
r = requests.get('https://interestratesapi.com/api/v1/historical', params=params)
data = r.json()
rate = data['rates']['SNB_POLICY_RATE']
currency = data.get('currencies', {}).get('SNB_POLICY_RATE', 'CHF')
JavaScript (fetch)
const url = 'https://interestratesapi.com/api/v1/historical?date=2025-06-15&symbols=SNB_POLICY_RATE&api_key=YOUR_KEY';
const response = await fetch(url);
const data = await response.json();
const rate = data.rates.SNB_POLICY_RATE;
const currency = data.currencies && data.currencies.SNB_POLICY_RATE;
PHP
<?php
$query = http_build_query([
'date' => '2025-06-15',
'symbols' => 'SNB_POLICY_RATE',
'api_key' => 'YOUR_KEY'
]);
$url = 'https://interestratesapi.com/api/v1/historical?' . $query;
$data = json_decode(file_get_contents($url), true);
$rate = $data['rates']['SNB_POLICY_RATE'];
$currency = $data['currencies']['SNB_POLICY_RATE'] ?? 'CHF';
?>
JSON response (example)
Note: For monthly symbols, interpret the value as the policy rate applicable to that month; the service maps to the last available day within the month. Values in examples are illustrative.
Endpoint 4: Time Series — GET /api/v1/timeseries
Retrieve a continuous time series of SNB_POLICY_RATE between two dates. Use this to chart policy cycles, compute rolling statistics, or feed risk models.
cURL
Python (requests)
import requests
import pandas as pd
params = {
'start': '2025-11-11',
'end': '2026-11-11',
'symbols': 'SNB_POLICY_RATE',
'api_key': 'YOUR_KEY'
}
r = requests.get('https://interestratesapi.com/api/v1/timeseries', params=params)
data = r.json()
series = data['rates']['SNB_POLICY_RATE'] # dict of date -> value
df = pd.Series(series, name='SNB_POLICY_RATE').sort_index()
JavaScript (fetch)
const url = 'https://interestratesapi.com/api/v1/timeseries?start=2025-11-11&end=2026-11-11&symbols=SNB_POLICY_RATE&api_key=YOUR_KEY';
const response = await fetch(url);
const data = await response.json();
const series = data.rates.SNB_POLICY_RATE; // { 'YYYY-MM-DD': value }
PHP
<?php
$params = http_build_query([
'start' => '2025-11-11',
'end' => '2026-11-11',
'symbols' => 'SNB_POLICY_RATE',
'api_key' => 'YOUR_KEY'
]);
$json = file_get_contents('https://interestratesapi.com/api/v1/timeseries?' . $params);
$data = json_decode($json, true);
$series = $data['rates']['SNB_POLICY_RATE']; // associative array date => value
?>
JSON response (example)
Key fields: rates.SNB_POLICY_RATE is a date-to-value map. frequencies exposes how the series is served in the API response period. For monthly symbols you may see repeated daily values across the month for analytics continuity.
Endpoint 5: Fluctuation — GET /api/v1/fluctuation
Get change statistics for SNB_POLICY_RATE across a period. This is ideal for summarizing policy moves over a quarter or year.
cURL
Python (requests)
import requests
params = {
'start': '2025-11-11',
'end': '2026-11-11',
'symbols': 'SNB_POLICY_RATE',
'api_key': 'YOUR_KEY'
}
r = requests.get('https://interestratesapi.com/api/v1/fluctuation', params=params)
st = r.json()['rates']['SNB_POLICY_RATE']
start_v = st['start_value']; end_v = st['end_value']
change = st['change']; change_pct = st['change_pct']
JavaScript (fetch)
const url = 'https://interestratesapi.com/api/v1/fluctuation?start=2025-11-11&end=2026-11-11&symbols=SNB_POLICY_RATE&api_key=YOUR_KEY';
const response = await fetch(url);
const data = await response.json();
const stats = data.rates.SNB_POLICY_RATE;
const { start_value, end_value, change, change_pct, high, low } = stats;
PHP
<?php
$q = http_build_query([
'start' => '2025-11-11',
'end' => '2026-11-11',
'symbols' => 'SNB_POLICY_RATE',
'api_key' => 'YOUR_KEY'
]);
$data = json_decode(file_get_contents('https://interestratesapi.com/api/v1/fluctuation?' . $q), true);
$stats = $data['rates']['SNB_POLICY_RATE'];
$changePct = $stats['change_pct'];
?>
JSON response (example)
Key fields: change is absolute difference in percentage points; change_pct is the percentage change from start_value (null if start_value is zero). high and low summarize the range across the window.
Endpoint 6: OHLC — GET /api/v1/ohlc
Compute candlestick-style summaries from daily data. Even for monthly policy rates, OHLC offers compact snapshots per period (weekly, monthly, or quarterly) for charting and reporting.
cURL
Python (requests)
import requests
params = {
'symbols': 'SNB_POLICY_RATE',
'period': 'monthly',
'start': '2025-11-11',
'end': '2026-11-11',
'api_key': 'YOUR_KEY'
}
r = requests.get('https://interestratesapi.com/api/v1/ohlc', params=params)
ohlc = r.json()['rates']['SNB_POLICY_RATE'] # list of { period, open, high, low, close, data_points }
JavaScript (fetch)
const url = 'https://interestratesapi.com/api/v1/ohlc?symbols=SNB_POLICY_RATE&period=monthly&start=2025-11-11&end=2026-11-11&api_key=YOUR_KEY';
const response = await fetch(url);
const data = await response.json();
const bars = data.rates.SNB_POLICY_RATE; // [{ period: 'YYYY-MM', open, high, low, close, data_points }]
PHP
<?php
$params = http_build_query([
'symbols' => 'SNB_POLICY_RATE',
'period' => 'monthly',
'start' => '2025-11-11',
'end' => '2026-11-11',
'api_key' => 'YOUR_KEY'
]);
$res = json_decode(file_get_contents('https://interestratesapi.com/api/v1/ohlc?' . $params), true);
$bars = $res['rates']['SNB_POLICY_RATE'];
?>
JSON response (example)
Key fields: open, high, low, and close reflect derived values within each OHLC period; data_points is the number of daily observations used to compute that candlestick.
Endpoint 7: Loan Interest Cost Comparison — GET /api/v1/convert
Compare the total simple-interest cost for a loan priced off SNB_POLICY_RATE versus another benchmark. This endpoint uses the latest rate values for each symbol.
cURL
Python (requests)
import requests
params = {
'from': 'SNB_POLICY_RATE',
'to': 'ECB_MRO',
'amount': 100000,
'term_months': 12,
'api_key': 'YOUR_KEY'
}
r = requests.get('https://interestratesapi.com/api/v1/convert', params=params)
comp = r.json()
spread = comp['difference']['rate_spread']
JavaScript (fetch)
const url = 'https://interestratesapi.com/api/v1/convert?from=SNB_POLICY_RATE&to=ECB_MRO&amount=100000&term_months=12&api_key=YOUR_KEY';
const response = await fetch(url);
const data = await response.json();
const spread = data.difference.rate_spread;
PHP
<?php
$q = http_build_query([
'from' => 'SNB_POLICY_RATE',
'to' => 'ECB_MRO',
'amount' => 100000,
'term_months' => 12,
'api_key' => 'YOUR_KEY'
]);
$comp = json_decode(file_get_contents('https://interestratesapi.com/api/v1/convert?' . $q), true);
$spread = $comp['difference']['rate_spread'];
?>
JSON response (example)
Use cases: show a rate spread using difference.rate_spread, present interest savings, or route borrowers to the cheaper benchmark under a simple-interest assumption. Values in examples are illustrative.
How to Compute Spreads and Payments from API Values
- Spread between two rates (percentage points):
spread = rate_A - rate_B. For example, get SNB versus another rate by fetching two symbols from/latestor using/convertfor a direct comparison. - Simple monthly interest on principal P using an annual rate r%: convert to decimal R = r / 100. Then monthly interest =
P * (R / 12). For a non-amortizing loan over M months, total interest ≈P * R * (M / 12). To incorporate amortization, use your amortization schedule where each month’s interest is previous balance × (R / 12). - Monthly payment for a fully amortizing fixed-rate loan (principal P, monthly rate i = R/12, term M):
payment = P * i / (1 - (1 + i)^(-M)). Use SNB_POLICY_RATE as your base rate and add your product spread/margin before computing i.
Important: Do not hard-code rate numbers. Always use the returned numeric value from rates.SNB_POLICY_RATE and the correct effective date from dates.SNB_POLICY_RATE to anchor calculations.
Operational Details: Frequency, Business Days, and Caching
- Frequency: SNB_POLICY_RATE is monthly. In practice, you won’t need to poll this endpoint more than daily; for most apps, cache the latest response until the next business day or until your update window.
- Business days: Central bank policy rates don’t change every business day. For monthly series, the API may reflect the same value on consecutive days within the month.
- Caching: Use conditional caching in your API client or reverse proxy keyed by the
dateordates.SNB_POLICY_RATE. Refresh around your publishing window. - Rate limits: Respect
X-RateLimit-*headers and back off upon 429 responses. The API includesRetry-Afteron 429.
Error Handling and Reliability
Common error shapes adhere to {"success": false, "error": "message"}, with optional details for context. Anticipate:
- 401: invalid or missing
api_key - 403: account without active plan
- 404: no symbols matched or no data for the requested period (may include
detailson available ranges) - 422: validation errors (e.g., date format Y-m-d)
- 429: request quota exhausted (observe
Retry-After,X-RateLimit-Remaining,X-RateLimit-Reset)
Production tips:
- Validate symbols before calling series endpoints: look up
SNB_POLICY_RATEvia/symbolsat startup. - Guard against nulls:
change_pctcan be null whenstart_valueis zero. - Timezone: use the
dateanddatesfields from responses rather than assuming local midnight boundaries.
Real-World Integration Patterns
- Interest rate dashboards: Use
/latestfor headline values,/timeseriesfor charts, and/ohlcfor summaries per month or quarter. - Lending and mortgage platforms: Price CHF-linked products against SNB_POLICY_RATE plus a margin; compute amortizing payments from the returned rate.
- Treasury and ALM: Track policy cycles with
/fluctuationand set internal transfer pricing or liquidity buffers informed by the monthly policy stance. - Macro research: Use
/historicalfor point-in-time snapshots around policy meetings; use/timeseriesto run regime analysis.
When you’re ready to build, visit interestratesapi.com and the MCP page for implementation details.
FAQ
Q: Are SNB_POLICY_RATE values annualized percentages?
A: Yes. Interpret the numeric value as an annual percentage rate. For example, 1.50 means 1.50% per annum.
Q: How do I align effective dates for monthly data?
A: Use dates.SNB_POLICY_RATE if present; otherwise, use the top-level date. For /historical, the API maps to the last day with data within the requested month.
Q: How often should I query SNB_POLICY_RATE?
A: Monthly frequency implies daily polling is sufficient. Cache results and refresh once per business day or near your update window.
Q: What if I need to compare SNB_POLICY_RATE with another benchmark?
A: Use /latest with multiple symbols or /convert for a direct loan-cost comparison and spread.
Q: How do I handle missing data or zero values in change calculations?
A: Check for nulls in change_pct when the start value is zero. For missing data, catch 404 responses and read the details field for available ranges.
Next step: fetch SNB_POLICY_RATE in your environment and wire it into your pricing or analytics layer. Secure your key here: Register, explore integration notes in the MCP, and get an API key to start building.

