How to Integrate NBP Data into Your App: Complete API Guide

In the fast-paced world of fintech, access to accurate and timely financial data is crucial for developers, economists, and analysts. The National Bank of Poland (NBP) Reference Rate is a key indicator of the economic landscape in Poland, influencing various financial products and investment decisions. This guide will walk you through integrating the NBP Reference Rate data into your application using the Interest Rates API from interestratesapi.com. We will cover all relevant endpoints, provide code examples, and discuss best practices for effective implementation.

Understanding the Importance of Interest Rate Data

Interest rates are fundamental to the financial ecosystem. They affect everything from loan costs to investment returns. The NBP Reference Rate serves as a benchmark for various financial instruments in Poland, making it essential for applications that deal with loans, mortgages, and economic analysis. Without access to reliable interest rate data, developers face challenges such as:

Inability to provide accurate financial calculations.
Difficulty in analyzing market trends and making informed decisions.
Increased risk of financial mismanagement due to outdated or incorrect data.

By leveraging the Interest Rates API, developers can seamlessly integrate real-time and historical interest rate data into their applications, enhancing functionality and user experience.

Getting Started with the Interest Rates API

The Interest Rates API provides a straightforward way to access various interest rate data, including the NBP Reference Rate. Below are the key endpoints you will use to integrate this data into your application:

/symbols: Retrieve a list of available rate symbols.
/latest: Get the latest value for specified symbols.
/historical: Fetch the value of a symbol on a specific date.
/timeseries: Access a series of values between two dates.
/fluctuation: Analyze change statistics over a range.
/ohlc: Obtain OHLC candlestick data.
/convert: Compare loan interest costs between two rates.

All requests to the API must be made using the GET method, and authentication is handled via the api_key query parameter.

Endpoint 1: Retrieve Available Symbols

The first step in integrating the NBP Reference Rate is to retrieve the available symbols using the /symbols endpoint. This will help you confirm that the NBP Reference Rate is available for use.

Request Example

curl "https://interestratesapi.com/api/v1/symbols?category=central_bank&base=PLN&api_key=YOUR_KEY"

Response Example


{
"success": true,
"count": 1,
"symbols": [
{
"symbol": "NBP_REFERENCE_RATE",
"name": "National Bank of Poland Reference Rate",
"category": "central_bank",
"country_code": "PL",
"currency_code": "PLN",
"frequency": "monthly",
"description": "The interest rate set by the National Bank of Poland."
}
]
}

This response confirms that the NBP Reference Rate is available for integration. The symbol field will be used in subsequent API calls.

Endpoint 2: Fetch Latest Rate

Once you have confirmed the availability of the NBP Reference Rate, you can retrieve the latest rate using the /latest endpoint.

Request Example

curl "https://interestratesapi.com/api/v1/latest?symbols=NBP_REFERENCE_RATE&api_key=YOUR_KEY"

Response Example


{
"success": true,
"date": "2026-07-09",
"base": "PLN",
"rates": {
"NBP_REFERENCE_RATE": 5.33
},
"dates": {
"NBP_REFERENCE_RATE": "2026-07-09"
},
"currencies": {
"NBP_REFERENCE_RATE": "PLN"
}
}

The response provides the latest NBP Reference Rate along with the date it was recorded. This data can be used to inform users about current borrowing costs or investment returns.

Endpoint 3: Historical Data Retrieval

To analyze trends over time, you may need to access historical data. The /historical endpoint allows you to fetch the NBP Reference Rate for a specific date.

Request Example

curl "https://interestratesapi.com/api/v1/historical?date=2025-06-15&symbols=NBP_REFERENCE_RATE&api_key=YOUR_KEY"

Response Example


{
"success": true,
"date": "2025-06-15",
"base": "PLN",
"rates": {
"NBP_REFERENCE_RATE": 5.33
},
"currencies": {
"NBP_REFERENCE_RATE": "PLN"
}
}

This endpoint is particularly useful for financial analysts who need to assess how interest rates have changed over time, allowing for better forecasting and decision-making.

Endpoint 4: Time Series Data

For applications that require a series of data points over a specified period, the /timeseries endpoint is invaluable. It provides a range of values for the NBP Reference Rate between two dates.

Request Example

curl "https://interestratesapi.com/api/v1/timeseries?start=2025-07-09&end=2026-07-09&symbols=NBP_REFERENCE_RATE&api_key=YOUR_KEY"

Response Example


{
"success": true,
"base": "PLN",
"start_date": "2025-07-09",
"end_date": "2026-07-09",
"rates": {
"NBP_REFERENCE_RATE": {
"2025-07-09": 5.33,
"2025-07-10": 5.35,
"2025-07-11": 5.34
}
},
"frequencies": {
"NBP_REFERENCE_RATE": "daily"
},
"currencies": {
"NBP_REFERENCE_RATE": "PLN"
}
}

This data can be used to create visualizations or reports that show how the NBP Reference Rate fluctuates over time, providing insights into economic trends.

Endpoint 5: Fluctuation Analysis

The /fluctuation endpoint allows you to analyze the change in the NBP Reference Rate over a specified period, providing valuable insights into market volatility.

Request Example

curl "https://interestratesapi.com/api/v1/fluctuation?start=2025-07-09&end=2026-07-09&symbols=NBP_REFERENCE_RATE&api_key=YOUR_KEY"

Response Example


{
"success": true,
"rates": {
"NBP_REFERENCE_RATE": {
"start_date": "2025-07-09",
"end_date": "2026-07-09",
"start_value": 5.50,
"end_value": 5.33,
"change": -0.17,
"change_pct": -3.09,
"high": 5.50,
"low": 5.25
}
}
}

This endpoint is particularly useful for risk management and financial forecasting, allowing developers to build features that alert users to significant changes in interest rates.

Endpoint 6: OHLC Data

The /ohlc endpoint provides Open, High, Low, and Close (OHLC) data, which is essential for technical analysis in financial applications.

Request Example

curl "https://interestratesapi.com/api/v1/ohlc?symbols=NBP_REFERENCE_RATE&period=monthly&start=2025-07-09&end=2026-07-09&api_key=YOUR_KEY"

Response Example


{
"success": true,
"period": "monthly",
"start_date": "2025-07-09",
"end_date": "2026-07-09",
"rates": {
"NBP_REFERENCE_RATE": [
{
"period": "2025-07",
"open": 5.50,
"high": 5.55,
"low": 5.33,
"close": 5.33,
"data_points": 30
}
]
}
}

This data can be used to create candlestick charts, which are popular in financial analysis for visualizing price movements over time.

Endpoint 7: Loan Interest Cost Comparison

The /convert endpoint allows you to compare the total interest cost of loans between different rates, which is useful for financial decision-making.

Request Example

curl "https://interestratesapi.com/api/v1/convert?from=NBP_REFERENCE_RATE&to=ECB_MRO&amount=100000&term_months=12&api_key=YOUR_KEY"

Response Example


{
"success": true,
"amount": 100000,
"term_months": 12,
"from": {
"symbol": "NBP_REFERENCE_RATE",
"rate": 5.33,
"date": "2026-07-09",
"total_interest": 5330.00,
"total_payment": 105330.00
},
"to": {
"symbol": "ECB_MRO",
"rate": 4.50,
"date": "2026-07-09",
"total_interest": 4500.00,
"total_payment": 104500.00
},
"difference": {
"rate_spread": 0.83,
"interest_saved": 830.00
}
}

This endpoint is particularly valuable for users looking to make informed decisions about loans and refinancing options.

Error Handling and Rate Limits

When integrating with the Interest Rates API, it's essential to handle errors gracefully. Common error responses include:

401: Missing or invalid api_key.
403: Account without an active plan.
404: No symbols matched or no data for the requested date/range.
422: Validation error (e.g., wrong date format, invalid symbol).
429: Request quota exhausted.

For rate limits, the API provides the following headers:

X-RateLimit-Limit: The maximum number of requests allowed in a given time frame.
X-RateLimit-Remaining: The number of requests remaining in the current time frame.
X-RateLimit-Reset: The time when the rate limit will reset.

Implementing proper error handling and monitoring rate limits will ensure a smooth user experience and prevent disruptions in service.

Mini Project: Node.js/Express Endpoint

To demonstrate the practical application of the NBP Reference Rate data, let's create a simple Node.js/Express endpoint that fetches, caches, and serves the NBP Reference Rate data.

Setup

npm init -y
npm install express axios node-cache

Code Example

const express = require('express');
const axios = require('axios');
const NodeCache = require('node-cache');

const app = express();
const cache = new NodeCache();

const API_KEY = 'YOUR_KEY';
const BASE_URL = 'https://interestratesapi.com/api/v1/latest?symbols=NBP_REFERENCE_RATE&api_key=' + API_KEY;

app.get('/nbp-rate', async (req, res) => {
const cachedRate = cache.get('nbpRate');
if (cachedRate) {
return res.json(cachedRate);
}

try {
const response = await axios.get(BASE_URL);
cache.set('nbpRate', response.data, 3600); // Cache for 1 hour
res.json(response.data);
} catch (error) {
res.status(500).json({ error: 'Failed to fetch data' });
}
});

app.listen(3000, () => {
console.log('Server is running on port 3000');
});

This simple Express application fetches the latest NBP Reference Rate and caches it for one hour, reducing the number of API calls and improving performance.

Conclusion

Integrating the NBP Reference Rate data into your application using the Interest Rates API from interestratesapi.com is a straightforward process that can significantly enhance your application's financial capabilities. By following the steps outlined in this guide, you can provide users with accurate and timely interest rate information, enabling better financial decision-making.

For more information on the features and capabilities of the Interest Rates API, visit Explore Interest Rates API features or Get started with Interest Rates API.

How to Integrate NBP Data into Your App: Complete API Guide