Introduction
In the rapidly evolving world of fintech, access to accurate and timely financial data is crucial for developers, economists, and analysts. One such vital data point is the Danish Interbank Offered Rate (CIBOR), particularly the 3-month rate, which serves as a benchmark for various financial products. Integrating this data into your application can enhance its functionality and provide users with valuable insights. This blog post will guide you through the process of integrating the Danish Interbank Offered Rate 3-Month data into your application using the Interest Rates API from interestratesapi.com. We will cover all necessary endpoints, provide code examples, and discuss best practices for implementation.
Understanding the Interest Rates API
The Interest Rates API provides a comprehensive set of endpoints to access various interest rate data, including central bank rates, interbank rates, and treasury rates. The API is designed to be developer-friendly, allowing for easy integration into applications. The primary focus of this guide will be on the following endpoints:
- /api/v1/symbols: Retrieve available rate symbols.
- /api/v1/latest: Get the latest value per symbol.
- /api/v1/historical: Fetch historical data for a specific date.
- /api/v1/timeseries: Access a series of data between two dates.
- /api/v1/fluctuation: Analyze change statistics over a range.
- /api/v1/ohlc: Obtain OHLC candlestick data.
- /api/v1/convert: Compare loan interest costs between two rates.
All requests to the API must use the GET method and require an api_key as a query parameter for authentication. This guide will provide detailed instructions on how to use each endpoint effectively.
Step 1: Retrieve Available Symbols
The first step in integrating the Danish Interbank Offered Rate data is to retrieve the available symbols using the /api/v1/symbols endpoint. This endpoint allows you to filter symbols based on categories such as central bank, interbank, treasury, or reference rates.
Here’s how to make a request to this endpoint:
curl "https://interestratesapi.com/api/v1/symbols?category=interbank&base=DKK&api_key=YOUR_KEY"In this example, we are filtering for interbank rates in Danish Krone (DKK). The expected JSON response will look like this:
{
"success": true,
"count": 1,
"symbols": [
{
"symbol": "CIBOR_3M",
"name": "Copenhagen Interbank Offered Rate 3-Month",
"category": "interbank",
"country_code": "DK",
"currency_code": "DKK",
"frequency": "daily",
"description": "The interest rate at which banks lend to each other for a 3-month period."
}
]
}
This response indicates that the CIBOR 3-Month rate is available for use in your application.
Step 2: Fetch the Latest Rate
Once you have identified the symbol for the CIBOR 3-Month rate, the next step is to fetch the latest rate using the /api/v1/latest endpoint. This endpoint provides the most recent value for the specified symbols.
Here’s how to make a request to this endpoint:
curl "https://interestratesapi.com/api/v1/latest?symbols=CIBOR_3M&api_key=YOUR_KEY"The expected JSON response will look like this:
{
"success": true,
"date": "2026-09-13",
"base": "DKK",
"rates": {
"CIBOR_3M": 1.75
},
"dates": {
"CIBOR_3M": "2026-09-13"
},
"currencies": {
"CIBOR_3M": "DKK"
}
}
This response indicates that the latest CIBOR 3-Month rate is 1.75% as of September 13, 2026.
Step 3: Access Historical Data
To analyze trends over time, you may want to access historical data for the CIBOR 3-Month rate. This can be done using the /api/v1/historical endpoint, which allows you to specify a date for which you want to retrieve the rate.
Here’s how to make a request to this endpoint:
curl "https://interestratesapi.com/api/v1/historical?date=2025-06-15&symbols=CIBOR_3M&api_key=YOUR_KEY"The expected JSON response will look like this:
{
"success": true,
"date": "2025-06-15",
"base": "DKK",
"rates": {
"CIBOR_3M": 1.50
},
"currencies": {
"CIBOR_3M": "DKK"
}
}
This response indicates that the CIBOR 3-Month rate was 1.50% on June 15, 2025.
Step 4: Retrieve Time Series Data
For a more comprehensive analysis, you may want to retrieve a time series of the CIBOR 3-Month rate over a specified date range. This can be accomplished using the /api/v1/timeseries endpoint.
Here’s how to make a request to this endpoint:
curl "https://interestratesapi.com/api/v1/timeseries?start=2025-09-01&end=2026-09-01&symbols=CIBOR_3M&api_key=YOUR_KEY"The expected JSON response will look like this:
{
"success": true,
"base": "DKK",
"start_date": "2025-09-01",
"end_date": "2026-09-01",
"rates": {
"CIBOR_3M": {
"2025-09-01": 1.60,
"2025-09-02": 1.62,
"2025-09-03": 1.61
}
},
"frequencies": {
"CIBOR_3M": "daily"
},
"currencies": {
"CIBOR_3M": "DKK"
}
}
This response provides daily rates for the CIBOR 3-Month rate between the specified dates.
Step 5: Analyze Fluctuations
To understand how the CIBOR 3-Month rate has changed over a specific period, you can use the /api/v1/fluctuation endpoint. This endpoint provides statistics such as the start and end values, change, and percentage change over the specified date range.
Here’s how to make a request to this endpoint:
curl "https://interestratesapi.com/api/v1/fluctuation?start=2025-09-01&end=2026-09-01&symbols=CIBOR_3M&api_key=YOUR_KEY"The expected JSON response will look like this:
{
"success": true,
"rates": {
"CIBOR_3M": {
"start_date": "2025-09-01",
"end_date": "2026-09-01",
"start_value": 1.60,
"end_value": 1.75,
"change": 0.15,
"change_pct": 9.38,
"high": 1.80,
"low": 1.55
}
}
}
This response indicates that the CIBOR 3-Month rate increased by 0.15% over the specified period, with a high of 1.80% and a low of 1.55%.
Step 6: Obtain OHLC Data
If you require candlestick data for the CIBOR 3-Month rate, you can use the /api/v1/ohlc endpoint. This endpoint provides open, high, low, and close values for a specified period.
Here’s how to make a request to this endpoint:
curl "https://interestratesapi.com/api/v1/ohlc?symbols=CIBOR_3M&period=monthly&start=2025-09-01&end=2026-09-01&api_key=YOUR_KEY"The expected JSON response will look like this:
{
"success": true,
"period": "monthly",
"start_date": "2025-09-01",
"end_date": "2026-09-01",
"rates": {
"CIBOR_3M": [
{
"period": "2025-09",
"open": 1.60,
"high": 1.65,
"low": 1.55,
"close": 1.62,
"data_points": 30
}
]
}
}
This response provides the monthly OHLC data for the CIBOR 3-Month rate.
Step 7: Compare Loan Interest Costs
Finally, if you want to compare the loan interest costs between the CIBOR 3-Month rate and another rate, you can use the /api/v1/convert endpoint. This endpoint allows you to specify the amount and term for the comparison.
Here’s how to make a request to this endpoint:
curl "https://interestratesapi.com/api/v1/convert?from=CIBOR_3M&to=RBA_CASH_RATE&amount=100000&term_months=12&api_key=YOUR_KEY"The expected JSON response will look like this:
{
"success": true,
"amount": 100000,
"term_months": 12,
"from": {
"symbol": "CIBOR_3M",
"rate": 1.75,
"date": "2026-09-13",
"total_interest": 1750.00,
"total_payment": 101750.00
},
"to": {
"symbol": "RBA_CASH_RATE",
"rate": 5.33,
"date": "2026-09-13",
"total_interest": 5330.00,
"total_payment": 105330.00
},
"difference": {
"rate_spread": 3.58,
"interest_saved": 3580.00
}
}
This response indicates that borrowing at the CIBOR 3-Month rate would save you 3580.00 compared to borrowing at the RBA Cash Rate over a 12-month term.
Error Handling
When working with the Interest Rates API, it is essential to handle errors gracefully. Here are some common error responses you may encounter:
- 401: Missing
api_key, invalid or revoked key. - 403: Account without active plan.
- 404: No symbols matched or no data for requested date/range.
- 422: Validation error (e.g., wrong date format, invalid symbol).
- 429: Request quota exhausted.
For error responses, you can check the success field in the JSON response. If it is false, the error field will provide a message detailing the issue.
Understanding Rate Limit Headers
The Interest Rates API includes rate limit headers in its responses, which can help you manage your API usage effectively. Here are the key headers to be aware of:
- X-RateLimit-Limit: The maximum number of requests allowed in a given time period.
- X-RateLimit-Remaining: The number of requests remaining in the current time period.
- X-RateLimit-Reset: The time at which the current rate limit will reset.
By monitoring these headers, you can optimize your API calls and avoid hitting rate limits.
Mini End-to-End Project: Node.js/Express Endpoint
To demonstrate the integration of the CIBOR 3-Month rate into a Node.js application, we will create a simple Express endpoint that fetches, caches, and serves the rate data.
const express = require('express');
const axios = require('axios');
const app = express();
const PORT = process.env.PORT || 3000;
const API_KEY = 'YOUR_KEY';
const BASE_URL = 'https://interestratesapi.com/api/v1/latest?symbols=CIBOR_3M&api_key=' + API_KEY;
app.get('/api/cibor', async (req, res) => {
try {
const response = await axios.get(BASE_URL);
res.json(response.data);
} catch (error) {
res.status(500).json({ success: false, error: error.message });
}
});
app.listen(PORT, () => {
console.log(`Server is running on port ${PORT}`);
});
This simple Express application fetches the latest CIBOR 3-Month rate and serves it at the /api/cibor endpoint. You can further enhance this application by adding caching mechanisms and error handling as needed.
Conclusion
Integrating the Danish Interbank Offered Rate 3-Month data into your application using the Interest Rates API from interestratesapi.com is a straightforward process. By following the steps outlined in this guide, you can access a wealth of financial data that can enhance your fintech applications. Whether you are fetching the latest rates, analyzing historical data, or comparing loan costs, the Interest Rates API provides the tools you need to succeed in the competitive financial landscape.
For more information and to explore additional features, visit Explore Interest Rates API features and Get started with Interest Rates API.
