How to Integrate Bank of Korea Base Rate Data into Your App: Complete API Guide

Introduction

In the fast-paced world of finance, access to accurate and timely interest rate data is crucial for developers, economists, and financial analysts. The Federal Funds Effective Rate (symbol: FED_FUNDS) is a key indicator of the cost of borrowing money in the U.S. economy, making it essential for various financial applications. This blog post serves as a comprehensive guide to integrating the Bank of Korea Base Rate data into your application using the Interest Rates API. We will cover all relevant endpoints, provide code examples, and discuss best practices for effective implementation.

Why Use Interest Rates API?

The Interest Rates API provides developers with a reliable source of interest rate data, including central bank rates, interbank rates, and historical financial time series. Without such APIs, developers face significant challenges, including:

• Difficulty in obtaining accurate and up-to-date financial data.
• Increased development time and costs associated with building and maintaining data sources.
• Challenges in ensuring data reliability and consistency.

By leveraging the Interest Rates API, developers can focus on building robust financial applications without the overhead of managing data sources themselves.

Getting Started with Interest Rates API

To begin using the Interest Rates API, you need to familiarize yourself with the available endpoints. The API provides seven key endpoints that allow you to access various types of interest rate data:

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

All requests to the API must use the GET method and include the api_key as a query parameter. In the following sections, we will explore each endpoint in detail, providing code examples and practical use cases.

1. Retrieving Available Symbols

The first step in integrating the Interest Rates API is to retrieve the available symbols. This can be done using the /symbols endpoint. This endpoint allows you to filter symbols based on currency, category, and provider.

Endpoint Documentation

**GET** /api/v1/symbols

**Optional Filters**:

• base: ISO 3-letter currency (e.g., USD, EUR).
• category: Filter by category (central_bank, interbank, treasury, reference).
• provider: Filter by provider (fred, ecb, bis).

Code Example

Here’s how to retrieve the available symbols using cURL:

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

In Python, you can use the following code:

import requests

response = requests.get(
'https://interestratesapi.com/api/v1/symbols',
params=dict(category='central_bank', base='USD', api_key='YOUR_KEY')
)

data = response.json()

In JavaScript, you can use the fetch API:

const response = await fetch(
'https://interestratesapi.com/api/v1/symbols?category=central_bank&base=USD&api_key=YOUR_KEY'
);

const data = await response.json();

And in PHP:

$url = "https://interestratesapi.com/api/v1/symbols?category=central_bank&base=USD&api_key=YOUR_KEY";
$response = file_get_contents($url);
$data = json_decode($response, true);

Sample JSON Response

Here’s an example of a JSON response from the /symbols endpoint:

{
"success": true,
"count": 2,
"symbols": [
{
"symbol": "FED_FUNDS",
"name": "US Federal Funds Rate",
"category": "central_bank",
"country_code": "US",
"currency_code": "USD",
"frequency": "daily",
"description": "The interest rate at which depository institutions lend reserve balances to each other overnight"
}
]
}

2. Fetching Latest Rates

Once you have the available symbols, the next step is to fetch the latest rates using the /latest endpoint. This endpoint provides the most recent values for specified symbols.

Endpoint Documentation

**GET** /api/v1/latest

**Optional Parameters**:

• symbols: Comma-separated list of symbols (e.g., FED_FUNDS, ECB_MRO).
• base: Currency filter.
• category: Filter by category.

Code Example

To fetch the latest rates using cURL:

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

In Python:

response = requests.get(
'https://interestratesapi.com/api/v1/latest',
params=dict(symbols='FED_FUNDS,ECB_MRO', api_key='YOUR_KEY')
)

data = response.json()

In JavaScript:

const response = await fetch(
'https://interestratesapi.com/api/v1/latest?symbols=FED_FUNDS,ECB_MRO&api_key=YOUR_KEY'
);

const data = await response.json();

And in PHP:

$url = "https://interestratesapi.com/api/v1/latest?symbols=FED_FUNDS,ECB_MRO&api_key=YOUR_KEY";
$response = file_get_contents($url);
$data = json_decode($response, true);

Sample JSON Response

Here’s an example of a JSON response from the /latest endpoint:

{
"success": true,
"date": "2026-08-17",
"base": "MIXED",
"rates": {
"FED_FUNDS": 5.33,
"ECB_MRO": 4.50
},
"dates": {
"FED_FUNDS": "2026-08-17",
"ECB_MRO": "2026-08-17"
},
"currencies": {
"FED_FUNDS": "USD",
"ECB_MRO": "EUR"
}
}

3. Accessing Historical Data

To analyze trends over time, you may need to access historical data. The /historical endpoint allows you to retrieve the value of a symbol on a specific date.

Endpoint Documentation

**GET** /api/v1/historical

**Required Parameters**:

• date: Date in Y-m-d format.

**Optional Parameters**:

• symbols: Comma-separated list of symbols.
• base: Currency filter.

Code Example

To access historical data using cURL:

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

In Python:

response = requests.get(
'https://interestratesapi.com/api/v1/historical',
params=dict(date='2025-06-15', symbols='FED_FUNDS', api_key='YOUR_KEY')
)

data = response.json()

In JavaScript:

const response = await fetch(
'https://interestratesapi.com/api/v1/historical?date=2025-06-15&symbols=FED_FUNDS&api_key=YOUR_KEY'
);

const data = await response.json();

And in PHP:

$url = "https://interestratesapi.com/api/v1/historical?date=2025-06-15&symbols=FED_FUNDS&api_key=YOUR_KEY";
$response = file_get_contents($url);
$data = json_decode($response, true);

Sample JSON Response

Here’s an example of a JSON response from the /historical endpoint:

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

4. Retrieving Time Series Data

The /timeseries endpoint allows you to retrieve a series of data between two specified dates. This is particularly useful for trend analysis and forecasting.

Endpoint Documentation

**GET** /api/v1/timeseries

**Required Parameters**:

• start: Start date in Y-m-d format.
• end: End date in Y-m-d format (must be greater than or equal to start).
• symbols: Comma-separated list of symbols.

**Optional Parameters**:

• base: Currency filter.

Code Example

To retrieve time series data using cURL:

curl "https://interestratesapi.com/api/v1/timeseries?start=2025-08-17&end=2026-08-17&symbols=FED_FUNDS&api_key=YOUR_KEY"

In Python:

response = requests.get(
'https://interestratesapi.com/api/v1/timeseries',
params=dict(start='2025-08-17', end='2026-08-17', symbols='FED_FUNDS', api_key='YOUR_KEY')
)

data = response.json()

In JavaScript:

const response = await fetch(
'https://interestratesapi.com/api/v1/timeseries?start=2025-08-17&end=2026-08-17&symbols=FED_FUNDS&api_key=YOUR_KEY'
);

const data = await response.json();

And in PHP:

$url = "https://interestratesapi.com/api/v1/timeseries?start=2025-08-17&end=2026-08-17&symbols=FED_FUNDS&api_key=YOUR_KEY";
$response = file_get_contents($url);
$data = json_decode($response, true);

Sample JSON Response

Here’s an example of a JSON response from the /timeseries endpoint:

{
"success": true,
"base": "USD",
"start_date": "2025-08-17",
"end_date": "2026-08-17",
"rates": {
"FED_FUNDS": {
"2025-01-02": 5.33,
"2025-01-03": 5.33,
"2025-01-06": 5.33
}
},
"frequencies": {
"FED_FUNDS": "daily"
},
"currencies": {
"FED_FUNDS": "USD"
}
}

5. Analyzing Fluctuations

The /fluctuation endpoint provides change statistics over a specified range, allowing you to analyze the volatility of interest rates.

Endpoint Documentation

**GET** /api/v1/fluctuation

**Required Parameters**:

• start: Start date in Y-m-d format.
• end: End date in Y-m-d format (must be greater than or equal to start).
• symbols: Comma-separated list of symbols.

**Optional Parameters**:

• base: Currency filter.

Code Example

To analyze fluctuations using cURL:

curl "https://interestratesapi.com/api/v1/fluctuation?start=2025-08-17&end=2026-08-17&symbols=FED_FUNDS&api_key=YOUR_KEY"

In Python:

response = requests.get(
'https://interestratesapi.com/api/v1/fluctuation',
params=dict(start='2025-08-17', end='2026-08-17', symbols='FED_FUNDS', api_key='YOUR_KEY')
)

data = response.json()

In JavaScript:

const response = await fetch(
'https://interestratesapi.com/api/v1/fluctuation?start=2025-08-17&end=2026-08-17&symbols=FED_FUNDS&api_key=YOUR_KEY'
);

const data = await response.json();

And in PHP:

$url = "https://interestratesapi.com/api/v1/fluctuation?start=2025-08-17&end=2026-08-17&symbols=FED_FUNDS&api_key=YOUR_KEY";
$response = file_get_contents($url);
$data = json_decode($response, true);

Sample JSON Response

Here’s an example of a JSON response from the /fluctuation endpoint:

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

6. Obtaining OHLC Data

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

Endpoint Documentation

**GET** /api/v1/ohlc

**Required Parameters**:

• symbols: Comma-separated list of symbols.

**Optional Parameters**:

• period: Period for the data (weekly, monthly, quarterly; default is monthly).
• start: Start date in Y-m-d format.
• end: End date in Y-m-d format.

Code Example

To obtain OHLC data using cURL:

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

In Python:

response = requests.get(
'https://interestratesapi.com/api/v1/ohlc',
params=dict(symbols='FED_FUNDS', period='monthly', start='2025-08-17', end='2026-08-17', api_key='YOUR_KEY')
)

data = response.json()

In JavaScript:

const response = await fetch(
'https://interestratesapi.com/api/v1/ohlc?symbols=FED_FUNDS&period=monthly&start=2025-08-17&end=2026-08-17&api_key=YOUR_KEY'
);

const data = await response.json();

And in PHP:

$url = "https://interestratesapi.com/api/v1/ohlc?symbols=FED_FUNDS&period=monthly&start=2025-08-17&end=2026-08-17&api_key=YOUR_KEY";
$response = file_get_contents($url);
$data = json_decode($response, true);

Sample JSON Response

Here’s an example of a JSON response from the /ohlc endpoint:

{
"success": true,
"period": "monthly",
"start_date": "2025-08-17",
"end_date": "2026-08-17",
"rates": {
"FED_FUNDS": [
{
"period": "2025-01",
"open": 5.50,
"high": 5.50,
"low": 5.33,
"close": 5.33,
"data_points": 23
}
]
}
}

7. Comparing Loan Interest Costs

The /convert endpoint allows you to compare the total interest cost of a simple loan at the latest rate of each symbol. This is particularly useful for financial applications that need to provide users with cost comparisons.

Endpoint Documentation

**GET** /api/v1/convert

**Required Parameters**:

• from: Symbol to convert from.
• to: Symbol to convert to.
• amount: Numeric value (>= 0).

**Optional Parameters**:

• term_months: Duration of the loan in months (default is 12).

Code Example

To compare loan interest costs using cURL:

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

In Python:

response = requests.get(
'https://interestratesapi.com/api/v1/convert',
params=dict(from='FED_FUNDS', to='ECB_MRO', amount=100000, term_months=12, api_key='YOUR_KEY')
)

data = response.json()

In JavaScript:

const response = await fetch(
'https://interestratesapi.com/api/v1/convert?from=FED_FUNDS&to=ECB_MRO&amount=100000&term_months=12&api_key=YOUR_KEY'
);

const data = await response.json();

And in PHP:

$url = "https://interestratesapi.com/api/v1/convert?from=FED_FUNDS&to=ECB_MRO&amount=100000&term_months=12&api_key=YOUR_KEY";
$response = file_get_contents($url);
$data = json_decode($response, true);

Sample JSON Response

Here’s an example of a JSON response from the /convert endpoint:

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

Error Handling

When working with APIs, it's essential to handle errors gracefully. The Interest Rates API may return various error codes, including:

• 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 error handling, you can check the success field in the JSON response. If it is false, you can retrieve the error message for debugging.

Rate Limit Headers

The API also provides rate limit headers that can help you manage your usage:

• X-RateLimit-Limit: The maximum number of requests you're allowed to make in a given time period.
• X-RateLimit-Remaining: The number of requests remaining in the current time window.
• X-RateLimit-Reset: The time at which the current rate limit window resets.

By monitoring these headers, you can implement backoff strategies to avoid hitting rate limits.

Mini Project: Node.js/Express Endpoint

To demonstrate the practical application of the Interest Rates API, let's create a simple Node.js/Express endpoint that fetches, caches, and serves the FED_FUNDS rate data.

Setup

First, ensure you have Node.js and Express installed. Create a new project and install the necessary dependencies:

npm init -y
npm install express axios node-cache

Code Example

Here’s a simple implementation:

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=FED_FUNDS&api_key=' + API_KEY;

app.get('/fed-funds', async (req, res) => {
const cachedData = cache.get('fedFundsData');

if (cachedData) {
return res.json(cachedData);
}

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

app.listen(3000, () => {
console.log('Server is running on http://localhost:3000');
});

This simple Express server fetches the latest FED_FUNDS rate and caches it for one hour. You can access the data by navigating to http://localhost:3000/fed-funds.

Conclusion

Integrating the Bank of Korea Base Rate data into your application using the Interest Rates API is a straightforward process. By following the steps outlined in this guide, you can effectively access and utilize interest rate data for 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.

For more information and to explore additional features, visit Explore Interest Rates API features and Get started with Interest Rates API.