You need the Magyar Nemzeti Bank’s official policy rate inside your software—accurate, machine-readable, and ready for pricing, risk, or treasury workflows. By the end of this guide you’ll be able to fetch, cache, and analyze the MNB Base Rate (MNB_BASE_RATE) from the Interest Rates API across latest, historical, time series, fluctuation, OHLC, and even loan-comparison endpoints using cURL, Python, JavaScript, or PHP.
What the MNB Base Rate (MNB_BASE_RATE) Represents
MNB_BASE_RATE is the policy rate set by Magyar Nemzeti Bank (Hungary’s central bank). It is the anchor for HUF monetary policy and a reference point for bank funding costs, lending rates, mortgage repricing, and discounting cash flows in HUF. In Interest Rates API, MNB_BASE_RATE is categorized as a central bank rate and uses the currency code HUF. The frequency for this symbol is monthly, meaning updates reflect monthly policy decisions and publication cadence rather than intraday ticks.
Units: the API returns the rate as a percentage (e.g., 5.5 represents 5.5% per annum). To use it in formulas, convert to a decimal (r = 0.055) when needed.
Effective dates: for monthly symbols, the API associates a date with each observation. If you query a day within that month, the value returns for the last day with data in that month. Always read the date returned alongside the rate to ensure you reference the correct effective period in your models.
Business days and publication: central bank policy rates observe a decision calendar and publication schedule. Monthly frequency implies that values often change on specific meeting or decision dates, not every day. Use returned dates to align changes with your accrual periods. For caching, a practical approach is to cache the latest response for the current month and refresh daily, or immediately after known decision dates if that’s part of your process.
How to Discover and Work with MNB_BASE_RATE
All endpoints are served from https://interestratesapi.com and use the base URL https://interestratesapi.com/api/v1/. Authentication is via the api_key query parameter. Requests are always GET—never POST. For more detail, see the MCP and also browse https://interestratesapi.com. If you don’t have a key yet, Register and Get started with Interest Rates API.
Endpoint 1: Symbols — Find MNB_BASE_RATE
Use the catalogue to confirm symbol availability and metadata. You can filter by category=central_bank or by HUF base currency. The response includes fields like name, category, country_code, currency_code, frequency, and description.
cURL
curl -s "https://interestratesapi.com/api/v1/latest?api_key=YOUR_API_KEY&symbols=MNB_BASE_RATE"
Python (requests)
import requests
resp = requests.get(
"https://interestratesapi.com/api/v1/symbols",
params=dict(category="central_bank", base="HUF", api_key="YOUR_KEY"),
timeout=20
)
symbols = resp.json()
print(symbols)
JavaScript (fetch)
const url = "https://interestratesapi.com/api/v1/symbols?category=central_bank&base=HUF&api_key=YOUR_KEY";
const res = await fetch(url);
const symbols = await res.json();
console.log(symbols);
PHP
<?php
$url = "https://interestratesapi.com/api/v1/symbols?category=central_bank&base=HUF&api_key=YOUR_KEY";
$response = file_get_contents($url);
$symbols = json_decode($response, true);
print_r($symbols);
?>
How to use it
Search for an entry with "symbol": "MNB_BASE_RATE". Confirm its frequency (monthly) and "currency_code": "HUF". Use this metadata to drive UI labels and to set cache TTLs that match monthly publications.
Endpoint 2: Latest — Read the Current MNB Base Rate
This endpoint returns the latest value and its effective date. Always read both the rate and the associated date for accurate accrual and repricing.
Official cURL (copy exactly)
Official JSON (copy exactly)
{
"success": true,
"date": "2026-10-31",
"base": "HUF",
"rates": {
"MNB_BASE_RATE": 5.5
},
"dates": {
"MNB_BASE_RATE": "2026-10-31"
},
"currencies": {
"MNB_BASE_RATE": "HUF"
},
"base_filter_note": null
}
How to read this:
- rates.MNB_BASE_RATE is the latest percentage value (annualized).
- dates.MNB_BASE_RATE is the effective date of that latest observation.
- currencies.MNB_BASE_RATE shows the rate’s currency (HUF).
- date is the API-wide date context for the response.
Python (requests)
import requests
resp = requests.get(
"https://interestratesapi.com/api/v1/latest",
params=dict(symbols="MNB_BASE_RATE", api_key="YOUR_KEY"),
timeout=20
)
data = resp.json()
rate = data["rates"]["MNB_BASE_RATE"]
effective_date = data["dates"]["MNB_BASE_RATE"]
currency = data["currencies"]["MNB_BASE_RATE"]
print(rate, effective_date, currency)
JavaScript (fetch)
const url = "https://interestratesapi.com/api/v1/latest?symbols=MNB_BASE_RATE&api_key=YOUR_KEY";
const res = await fetch(url);
const data = await res.json();
const rate = data.rates.MNB_BASE_RATE;
const effectiveDate = data.dates.MNB_BASE_RATE;
const currency = data.currencies.MNB_BASE_RATE;
console.log(rate, effectiveDate, currency);
PHP
<?php
$params = http_build_query([
"symbols" => "MNB_BASE_RATE",
"api_key" => "YOUR_KEY"
]);
$url = "https://interestratesapi.com/api/v1/latest?$params";
$json = file_get_contents($url);
$data = json_decode($json, true);
$rate = $data["rates"]["MNB_BASE_RATE"];
$date = $data["dates"]["MNB_BASE_RATE"];
$curr = $data["currencies"]["MNB_BASE_RATE"];
echo "$rate $curr on $date\n";
?>
Endpoint 3: Historical — Value on a Specific Date
Use this to align rate snapshots with end-of-month pricing, valuation dates, or backtesting checkpoints. For monthly symbols, the last day with data in the specified month is returned.
cURL
JSON (from the reference)
Python (requests)
import requests
resp = requests.get(
"https://interestratesapi.com/api/v1/historical",
params=dict(date="2025-06-15", symbols="MNB_BASE_RATE", api_key="YOUR_KEY"),
timeout=20
)
data = resp.json()
value = data["rates"]["MNB_BASE_RATE"]
print(data["date"], value)
JavaScript (fetch)
const url = "https://interestratesapi.com/api/v1/historical?date=2025-06-15&symbols=MNB_BASE_RATE&api_key=YOUR_KEY";
const res = await fetch(url);
const data = await res.json();
console.log(data.date, data.rates.MNB_BASE_RATE);
PHP
<?php
$url = "https://interestratesapi.com/api/v1/historical?date=2025-06-15&symbols=MNB_BASE_RATE&api_key=YOUR_KEY";
$response = file_get_contents($url);
$data = json_decode($response, true);
echo $data["date"] . " " . $data["rates"]["MNB_BASE_RATE"] . "\n";
?>
Notes
If you request a mid-month date for a monthly symbol, the API returns the month’s observation as defined by its data source, using the last day with data within that month. Store both the request date and returned date/value to verify alignment during audits.
Endpoint 4: Time Series — Build Historical Curves
Time series are essential for dashboards, econometric models, and stress testing. You specify start, end, and symbols. The response includes rates keyed by date, plus frequency and currency metadata.
cURL
JSON (from the reference)
Python (requests)
import requests
resp = requests.get(
"https://interestratesapi.com/api/v1/timeseries",
params=dict(start="2025-11-19", end="2026-11-19", symbols="MNB_BASE_RATE", api_key="YOUR_KEY"),
timeout=30
)
series = resp.json()
points = series["rates"]["MNB_BASE_RATE"]
for d, v in points.items():
print(d, v)
JavaScript (fetch)
const url = "https://interestratesapi.com/api/v1/timeseries?start=2025-11-19&end=2026-11-19&symbols=MNB_BASE_RATE&api_key=YOUR_KEY";
const res = await fetch(url);
const data = await res.json();
const points = data.rates.MNB_BASE_RATE;
Object.entries(points).forEach(([date, value]) => {
console.log(date, value);
});
PHP
<?php
$url = "https://interestratesapi.com/api/v1/timeseries?start=2025-11-19&end=2026-11-19&symbols=MNB_BASE_RATE&api_key=YOUR_KEY";
$json = file_get_contents($url);
$data = json_decode($json, true);
foreach ($data["rates"]["MNB_BASE_RATE"] as $date => $value) {
echo "$date $value\n";
}
?>
Practical tips
- Cache time series per symbol and month to minimize repeated reads; invalidate cache for months crossing a recent policy decision.
- Use the frequencies and currencies maps to annotate charts and ensure consistent unit handling.
Endpoint 5: Fluctuation — Change Stats over a Range
Compute summarized changes—start/end values, absolute change, percentage change, and high/low—over your range. Helpful for summaries in dashboards and monitoring alerts.
cURL
JSON (from the reference)
Python (requests)
import requests
resp = requests.get(
"https://interestratesapi.com/api/v1/fluctuation",
params=dict(start="2025-11-19", end="2026-11-19", symbols="MNB_BASE_RATE", api_key="YOUR_KEY"),
timeout=20
)
stats = resp.json()["rates"]["MNB_BASE_RATE"]
print(stats["start_value"], stats["end_value"], stats["change_pct"])
JavaScript (fetch)
const url = "https://interestratesapi.com/api/v1/fluctuation?start=2025-11-19&end=2026-11-19&symbols=MNB_BASE_RATE&api_key=YOUR_KEY";
const res = await fetch(url);
const data = await res.json();
const f = data.rates.MNB_BASE_RATE;
console.log(f.start_value, f.end_value, f.high, f.low, f.change_pct);
PHP
<?php
$url = "https://interestratesapi.com/api/v1/fluctuation?start=2025-11-19&end=2026-11-19&symbols=MNB_BASE_RATE&api_key=YOUR_KEY";
$json = file_get_contents($url);
$data = json_decode($json, true);
$f = $data["rates"]["MNB_BASE_RATE"];
echo "Start: {$f["start_value"]}, End: {$f["end_value"]}, Δ%: {$f["change_pct"]}\n";
?>
Practical tips
- Use change and change_pct for monthly newsletters or alert thresholds.
- High/low help explain the path of policy within your selected window.
Endpoint 6: OHLC — Candlestick Aggregations
OHLC aggregates rates into open/high/low/close per chosen period. This is often used for charting monthly or quarterly policy paths at a glance. The API computes OHLC on-the-fly from underlying daily data; it does not store separate OHLC tables.
cURL
JSON (from the reference)
Python (requests)
import requests
resp = requests.get(
"https://interestratesapi.com/api/v1/ohlc",
params=dict(symbols="MNB_BASE_RATE", period="monthly",
start="2025-11-19", end="2026-11-19", api_key="YOUR_KEY"),
timeout=20
)
ohlc = resp.json()["rates"]["MNB_BASE_RATE"]
for bar in ohlc:
print(bar["period"], bar["open"], bar["high"], bar["low"], bar["close"], bar["data_points"])
JavaScript (fetch)
const url = "https://interestratesapi.com/api/v1/ohlc?symbols=MNB_BASE_RATE&period=monthly&start=2025-11-19&end=2026-11-19&api_key=YOUR_KEY";
const res = await fetch(url);
const data = await res.json();
const series = data.rates.MNB_BASE_RATE;
series.forEach(bar => {
console.log(bar.period, bar.open, bar.high, bar.low, bar.close, bar.data_points);
});
PHP
<?php
$url = "https://interestratesapi.com/api/v1/ohlc?symbols=MNB_BASE_RATE&period=monthly&start=2025-11-19&end=2026-11-19&api_key=YOUR_KEY";
$json = file_get_contents($url);
$data = json_decode($json, true);
foreach ($data["rates"]["MNB_BASE_RATE"] as $bar) {
echo "{$bar["period"]} O:{$bar["open"]} H:{$bar["high"]} L:{$bar["low"]} C:{$bar["close"]} n={$bar["data_points"]}\n";
}
?>
Field notes
- period is a YYYY-MM or YYYY-Wxx depending on aggregation.
- data_points indicates how many underlying daily points were used in the computation window.
Endpoint 7: Convert — Compare Loan Interest Costs
This endpoint compares total interest cost of a simple loan priced at the latest rates of two symbols. You can use it to visualize the spread between MNB_BASE_RATE and another benchmark for a given loan amount and term. For spreads and payment estimates in your own code, see the formulas below.
cURL
JSON (from the reference)
Python (requests)
import requests
resp = requests.get(
"https://interestratesapi.com/api/v1/convert",
params=dict(from="MNB_BASE_RATE", to="ECB_MRO", amount=100000, term_months=12, api_key="YOUR_KEY"),
timeout=15
)
cmp = resp.json()
print(cmp["difference"]["rate_spread"], cmp["difference"]["interest_saved"])
JavaScript (fetch)
const url = "https://interestratesapi.com/api/v1/convert?from=MNB_BASE_RATE&to=ECB_MRO&amount=100000&term_months=12&api_key=YOUR_KEY";
const res = await fetch(url);
const data = await res.json();
console.log(data.difference.rate_spread, data.difference.interest_saved);
PHP
<?php
$url = "https://interestratesapi.com/api/v1/convert?from=MNB_BASE_RATE&to=ECB_MRO&amount=100000&term_months=12&api_key=YOUR_KEY";
$json = file_get_contents($url);
$data = json_decode($json, true);
echo "Spread: {$data["difference"]["rate_spread"]}, Saved: {$data["difference"]["interest_saved"]}\n";
?>
Computing spreads and payments yourself
- Spread (in percentage points): spread = rate_A - rate_B (use the numeric percentage fields from the API). For decimal form, divide by 100.
- Simple monthly interest estimate for amount A and annual percentage rate r% over m months (interest-only approximation): monthly_interest = A × (r/100) / 12. Total simple interest over m months: total_interest ≈ monthly_interest × m. Use amortization formulas if you price installment loans.
- Amortized monthly payment (rate as decimal R = r/100): payment = A × [R/12] / (1 − (1 + R/12)^(−m)). Substitute R from the latest MNB_BASE_RATE you fetched to compute a payment. Do not hardcode values; read them from the API.
Errors, Rate Limits, and Caching Strategy
Common error shapes are standardized:
- 401: api_key missing/invalid
- 403: account not active
- 404: symbol not found or no data in requested period (may include a details field with available ranges)
- 422: validation error (e.g., date format must be Y-m-d)
- 429: quota exhausted; watch Retry-After and X-RateLimit-* headers
Caching guidance for MNB_BASE_RATE:
- Latest: cache for the current month with a daily refresh cadence; on known decision days, refresh immediately.
- Historical/time series: cache immutable past months aggressively; invalidate only if your ingestion window overlaps the current or previous month.
- OHLC/fluctuation: compute on demand, then cache per (symbol, period, range) key.
Real-World Uses of MNB_BASE_RATE Data
- Interest rate dashboards: show latest MNB_BASE_RATE, month-over-month fluctuation, and OHLC for at-a-glance policy paths.
- Lending and mortgage: reprice HUF-linked variable-rate loans by reading the latest rate and computing monthly payments or spreads versus your margin.
- Treasury and ALM: align transfer prices to policy rates; monitor fluctuation stats to quantify policy shifts.
- Macro research and quant: run time series regressions, compute rolling windows, and produce heatmaps for policy changes.
Explore more endpoints and examples at interestratesapi.com and the Interest Rates API MCP. When you’re ready to integrate, Register for Interest Rates API.
Handling Dates, Units, and Effective Periods
All inputs are Y-m-d and output dates follow the same. For monthly symbols like MNB_BASE_RATE, if you ask for a date in the middle of the month via historical, the API returns the month’s valid observation (last day with data). Always:
- Use the dates map (for latest) or the keys in the time series to determine the precise effective date.
- Treat the numeric rate as percent per annum. Convert to decimals in pricing formulas: R = rate / 100.
- Specify your accrual conventions at the application layer; the API delivers the benchmark, not day-count logic.
Putting It All Together: Integration Checklist
- Discovery: GET /symbols; find MNB_BASE_RATE and store name, frequency, and currency.
- Operational read: GET /latest; render rate, effective date, and currency in UI.
- Backfills/point-in-time analyses: GET /historical with monthly date anchors.
- Analytics: GET /timeseries for your analysis horizon; derive moving statistics.
- Summaries: GET /fluctuation for percent changes and bounds.
- Charts: GET /ohlc for monthly or quarterly candlesticks.
- Comparisons: GET /convert to communicate cost differences to end users.
For the full reference, visit the MCP. To start building, Register and then Get started with Interest Rates API.
FAQ
Q: What timezone are dates in?
A: Dates are calendar dates (Y-m-d) without time-of-day fields. Align these with your own timezone conventions during ingestion.
Q: How often does MNB_BASE_RATE update?
A: MNB_BASE_RATE is monthly in the API. It updates according to the central bank’s policy schedule and publication cadence. Read the returned date to know which month and effective period you’re using.
Q: How should I compute a loan payment from the returned value?
A: Convert the percentage to a decimal R = rate/100, then apply your loan formula (e.g., amortized monthly payment = A × [R/12] / (1 − (1 + R/12)^(−m))). Always fetch the current rate via /latest at pricing time.
Q: What happens if I query a date with no data?
A: You may receive a 404 with a details field indicating available ranges. For monthly symbols, the API uses the last day with data within the month, but dates outside the dataset will return an error.
Q: Can I filter by base currency?
A: Yes, /symbols supports base and category filters. Latest, historical, and timeseries also include base/currency fields in the response to help you track units.
Build your MNB Base Rate integration now. Review the docs at the MCP, then Register for an API key. You can also explore interestratesapi.com and the Interest Rates API MCP for additional details, or Register for Interest Rates API to get started.