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

In the rapidly evolving world of fintech, access to accurate and timely interest rate data is crucial for developers, economists, and financial analysts. The Interest Rates API from interestratesapi.com provides a comprehensive solution for integrating interest rate data, including central bank rates, interbank rates, and financial time series analysis into applications. This guide will walk you through the process of integrating the Interest on Reserve Balances (FED_IORB) data into your application using the API.

Understanding the Importance of Interest Rate Data

Interest rates play a pivotal role in the financial ecosystem, influencing everything from loan rates to investment decisions. Without access to reliable interest rate data, developers face significant challenges in building applications that require real-time financial information. The Interest Rates API addresses these challenges by providing a robust set of endpoints that allow users to retrieve the latest rates, historical data, and fluctuations over time.

API Overview

The Interest Rates API offers several endpoints that cater to different data retrieval needs. Below is a summary of the key endpoints you will be using:

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

Step-by-Step Integration Guide

1. Fetch Available Symbols

The first step in integrating the Interest Rates API is to retrieve the available symbols. This will help you understand which rates you can access. Use the following endpoint:

GET /api/v1/symbols

Here’s how to make a request using cURL:

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

Example JSON response:


{
"success": true,
"count": 2,
"symbols": [
{
"symbol": "FED_IORB",
"name": "Interest on Reserve Balances",
"category": "central_bank",
"country_code": "US",
"currency_code": "USD",
"frequency": "daily",
"description": "The interest rate on reserve balances held at the Federal Reserve."
}
]
}

2. Retrieve the Latest Rates

Once you have the symbols, you can fetch the latest rates. This is done using the following endpoint:

GET /api/v1/latest

Here’s a cURL example to get the latest FED_IORB rate:

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

Example JSON response:


{
"success": true,
"date": "2026-06-23",
"base": "USD",
"rates": {
"FED_IORB": 5.33
},
"dates": {
"FED_IORB": "2026-06-23"
},
"currencies": {
"FED_IORB": "USD"
}
}

3. Access Historical Data

To analyze trends over time, you may want to access historical data. Use the following endpoint:

GET /api/v1/historical

Here’s how to retrieve the FED_IORB rate for a specific date:

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

Example JSON response:


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

4. Retrieve Time Series Data

For a more comprehensive analysis, you can retrieve a time series of rates between two dates. Use the following endpoint:

GET /api/v1/timeseries

Here’s a cURL example:

curl "https://interestratesapi.com/api/v1/timeseries?start=2025-06-23&end=2026-06-23&symbols=FED_IORB&api_key=YOUR_KEY"

Example JSON response:


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

5. Analyze Fluctuations

To understand how rates have changed over a specific period, you can use the fluctuation endpoint:

GET /api/v1/fluctuation

Here’s an example request:

curl "https://interestratesapi.com/api/v1/fluctuation?start=2025-06-23&end=2026-06-23&symbols=FED_IORB&api_key=YOUR_KEY"

Example JSON response:


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

6. Retrieve OHLC Data

For applications that require candlestick data, you can retrieve OHLC (Open, High, Low, Close) data using the following endpoint:

GET /api/v1/ohlc

Here’s how to make a request:

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

Example JSON response:


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

7. Compare Loan Interest Costs

Finally, you can compare the interest costs of loans between two rates using the convert endpoint:

GET /api/v1/convert

Here’s an example request:

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

Example JSON response:


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

Error Handling

When working with the Interest Rates API, it is essential to handle errors gracefully. Below are common error responses you may encounter:

401: Missing api_key, invalid or revoked key, user not found.
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 rate limit errors (429), the response will include headers:

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 when the rate limit will reset.

Mini End-to-End Project: Node.js/Express Example

To illustrate how to integrate the Interest Rates API into a Node.js application, here’s a simple example using Express:

const express = require('express');
const fetch = require('node-fetch');
const app = express();
const PORT = process.env.PORT || 3000;

app.get('/api/iorb', async (req, res) => {
const apiKey = 'YOUR_KEY';
const response = await fetch(`https://interestratesapi.com/api/v1/latest?symbols=FED_IORB&api_key=${apiKey}`);
const data = await response.json();
res.json(data);
});

app.listen(PORT, () => {
console.log(`Server is running on port ${PORT}`);
});

This simple Express server fetches the latest FED_IORB rate and serves it at the /api/iorb endpoint. You can expand this project by adding caching mechanisms, error handling, and more endpoints as needed.

Conclusion

Integrating the Interest Rates API from interestratesapi.com into your application provides a powerful tool for accessing vital interest rate data. By following the steps outlined in this guide, you can effectively retrieve and utilize interest rate information, enhancing your fintech applications and analytical capabilities. For more information and to explore additional features, visit Explore Interest Rates API features and Get started with Interest Rates API.