IORB (FED_IORB) Interest Rate

IORB (FED_IORB) Interest Rate

You need to programmatically fetch the Federal Reserve’s Interest on Reserve Balances (IORB) rate and fold it into dashboards, loan pricing, risk models, or macro analysis. By the end of this guide, you will be able to query FED_IORB from the Interest Rates API, read the response correctly, compute spreads and payments based on the returned value, and productionize your integration across all endpoints you’ll likely need.

What the FED_IORB rate is and why it matters

FED_IORB is the Interest on Reserve Balances set by the Federal Reserve. It is a key administered rate in USD money markets and an anchor for short-term interest rates in the United States. Because it helps set a floor for overnight rates, changes in IORB quickly cascade into banks’ funding costs, deposit pricing, commercial lending decisions, and downstream benchmarks.

Illustration: IORB (FED_IORB) Interest Rate

In the Interest Rates API, FED_IORB is:

  • Category: central bank
  • Currency: USD
  • Frequency: daily
  • Symbol: FED_IORB

This article focuses exclusively on FED_IORB and shows how to use all seven endpoints to retrieve IORB data and related analytics, with concrete, copy-pasteable code and JSON you can rely on.

How the Interest Rates API expresses FED_IORB

Key details you will use when parsing API responses:

  • Units: percentage points (e.g., 3.90 is 3.90%).
  • Dates: YYYY-MM-DD strings. Daily series include only dates with observations (typically business days). For weekends and holidays, expect gaps in the date keys; the latest endpoint returns the most recent available business day.
  • Currency: USD (for FED_IORB). Responses also include a currencies map keyed by symbol.
  • Frequency: daily. Some endpoints (OHLC) aggregate daily observations into weekly/quarterly/monthly periods.

Production notes you’ll want to plan for:

  • Publication cadence: daily frequency means new values show up on business days; design caches and refresh jobs accordingly.
  • Caching: cache recent daily responses (e.g., 5–15 minutes) to reduce latency and rate-limit usage during peak traffic. Bust on market close or your scheduled fetch times.
  • Non-business days: code for missing dates; don’t assume continuity across weekends/holidays.
  • Error handling and quotas: handle 401/403/404/422/429 with fallbacks and exponential backoff. Inspect Retry-After and X-RateLimit-* headers on 429.

To explore all capabilities or add new symbols alongside FED_IORB later, start at interestratesapi.com. When you are ready to build, Register for an API key and move directly into implementation.

Quick-start: get the latest FED_IORB in one call

The latest endpoint gives you the most recent available value and the effective date for FED_IORB. Use this for dashboards, alerts, and pricing pipelines that only need the current setting.

cURL: latest FED_IORB (official sample)

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

Official JSON response

{
    "success": true,
    "date": "2026-11-06",
    "base": "USD",
    "rates": {
        "FED_IORB": 3.9
    },
    "dates": {
        "FED_IORB": "2026-11-06"
    },
    "currencies": {
        "FED_IORB": "USD"
    },
    "base_filter_note": null
}

How to read this:

  • rates.FED_IORB is expressed in percent (3.9 means 3.90%).
  • dates.FED_IORB is the effective date of that rate.
  • base/currencies confirm the currency (USD).

Python (requests)

import requests

resp = requests.get(
"https://interestratesapi.com/api/v1/latest",
params={"symbols": "FED_IORB", "api_key": "YOUR_API_KEY"},
timeout=10
)
data = resp.json()

iorb = data["rates"]["FED_IORB"] # e.g., 3.9 meaning 3.90%
iorb_date = data["dates"]["FED_IORB"] # "2026-11-06"
iorb_ccy = data["currencies"]["FED_IORB"] # "USD"

print(iorb, iorb_date, iorb_ccy)

JavaScript (fetch)

const response = await fetch(
"https://interestratesapi.com/api/v1/latest?symbols=FED_IORB&api_key=YOUR_API_KEY"
);
const data = await response.json();

const iorb = data.rates.FED_IORB; // 3.9
const iorbDate = data.dates.FED_IORB; // "2026-11-06"
const iorbCcy = data.currencies.FED_IORB; // "USD"

console.log(iorb, iorbDate, iorbCcy);

PHP

<?php
$url = "https://interestratesapi.com/api/v1/latest?symbols=FED_IORB&api_key=YOUR_API_KEY";
$json = file_get_contents($url);
$data = json_decode($json, true);

$iorb = $data["rates"]["FED_IORB"];
$iorbDate = $data["dates"]["FED_IORB"];
$iorbCcy = $data["currencies"]["FED_IORB"];

echo $iorb . " " . $iorbDate . " " . $iorbCcy;
?>

Endpoint coverage for FED_IORB

This section walks through all seven endpoints, using FED_IORB wherever applicable. Each includes a cURL request, multi-language code snippet, and an example JSON response from the API reference where provided.

1) Symbols — discover and filter available benchmarks

Use this to confirm symbol availability, category, currency, and frequency. For FED_IORB, filter by category=central_bank and base=USD.

cURL

Python

import requests

resp = requests.get(
"https://interestratesapi.com/api/v1/symbols",
params={"category": "central_bank", "base": "USD", "api_key": "YOUR_API_KEY"},
timeout=10
)
symbols = resp.json()["symbols"]
# Iterate and locate FED_IORB among central-bank USD rates

JavaScript

const res = await fetch(
"https://interestratesapi.com/api/v1/symbols?category=central_bank&base=USD&api_key=YOUR_API_KEY"
);
const payload = await res.json();
const symbols = payload.symbols;

PHP

<?php
$url = "https://interestratesapi.com/api/v1/symbols?category=central_bank&base=USD&api_key=YOUR_API_KEY";
$data = json_decode(file_get_contents($url), true);
$symbols = $data["symbols"];
?>

JSON example

Tip: Store the metadata (frequency, currency) in your symbol registry to drive validation and UI labels.

2) Latest — get the most recent FED_IORB

Use this for status pages, intraday refreshes, and triggers. The official sample above shows how to parse the latest FED_IORB and its effective date.

cURL (official)

Python

import requests
r = requests.get(
"https://interestratesapi.com/api/v1/latest",
params={"symbols": "FED_IORB", "api_key": "YOUR_API_KEY"},
)
print(r.json())

JavaScript

const resp = await fetch("https://interestratesapi.com/api/v1/latest?symbols=FED_IORB&api_key=YOUR_API_KEY");
console.log(await resp.json());

PHP

<?php
echo file_get_contents("https://interestratesapi.com/api/v1/latest?symbols=FED_IORB&api_key=YOUR_API_KEY");
?>

Official JSON

3) Historical — value on a specific date

Use this when you need the setting on a single date (rollup logic is handled for lower-frequency series; FED_IORB is daily).

cURL

Python

import requests
res = requests.get(
"https://interestratesapi.com/api/v1/historical",
params={"date": "2025-06-15", "symbols": "FED_IORB", "api_key": "YOUR_API_KEY"},
)
print(res.json())

JavaScript

const r = await fetch("https://interestratesapi.com/api/v1/historical?date=2025-06-15&symbols=FED_IORB&api_key=YOUR_API_KEY");
console.log(await r.json());

PHP

<?php
echo file_get_contents("https://interestratesapi.com/api/v1/historical?date=2025-06-15&symbols=FED_IORB&api_key=YOUR_API_KEY");
?>

JSON example

Notes:

  • The date field echoes your requested date.
  • rates maps symbols to values (percent).

4) Time series — daily series between dates

Pull a contiguous date range with per-day observations. Useful for charts, regressions, or rolling analytics.

cURL

Python

import requests
ts = requests.get(
"https://interestratesapi.com/api/v1/timeseries",
params={"start": "2025-11-07", "end": "2026-11-07", "symbols": "FED_IORB", "api_key": "YOUR_API_KEY"},
).json()

series = ts["rates"]["FED_IORB"] # dict of date -> value
freq = ts["frequencies"]["FED_IORB"] # "daily"
ccy = ts["currencies"]["FED_IORB"] # "USD"

JavaScript

const tsResp = await fetch("https://interestratesapi.com/api/v1/timeseries?start=2025-11-07&end=2026-11-07&symbols=FED_IORB&api_key=YOUR_API_KEY");
const tsData = await tsResp.json();
const series = tsData.rates.FED_IORB; // { "2025-01-02": 5.33, ... }

PHP

<?php
$u = "https://interestratesapi.com/api/v1/timeseries?start=2025-11-07&end=2026-11-07&symbols=FED_IORB&api_key=YOUR_API_KEY";
$ts = json_decode(file_get_contents($u), true);
$series = $ts["rates"]["FED_IORB"];
?>

JSON example

The rates object is a nested dictionary: symbol → date → value. Missing dates signify non-business days.

5) Fluctuation — change stats over a window

Use this for month-to-date/quarter-to-date change, high/low, and percent change. Handy for summaries and alerts without pulling the full time series.

cURL

Python

import requests
fl = requests.get(
"https://interestratesapi.com/api/v1/fluctuation",
params={"start": "2025-11-07", "end": "2026-11-07", "symbols": "FED_IORB", "api_key": "YOUR_API_KEY"},
).json()

iorb_stats = fl["rates"]["FED_IORB"]
# keys: start_date, end_date, start_value, end_value, change, change_pct, high, low

JavaScript

const f = await fetch("https://interestratesapi.com/api/v1/fluctuation?start=2025-11-07&end=2026-11-07&symbols=FED_IORB&api_key=YOUR_API_KEY");
const stats = (await f.json()).rates.FED_IORB;

PHP

<?php
$url = "https://interestratesapi.com/api/v1/fluctuation?start=2025-11-07&end=2026-11-07&symbols=FED_IORB&api_key=YOUR_API_KEY";
$stats = json_decode(file_get_contents($url), true)["rates"]["FED_IORB"];
?>

JSON example

Field notes:

  • change = end_value − start_value (percent points).
  • change_pct is relative change in percent terms; it is null if start_value is 0.

6) OHLC — candlestick aggregates from daily data

Use OHLC to compress daily FED_IORB observations into weekly, monthly, or quarterly candles, including data_points count per candle.

cURL

Python

import requests
ohlc = requests.get(
"https://interestratesapi.com/api/v1/ohlc",
params={"symbols": "FED_IORB", "period": "monthly", "start": "2025-11-07", "end": "2026-11-07", "api_key": "YOUR_API_KEY"},
).json()

candles = ohlc["rates"]["FED_IORB"] # list of {period, open, high, low, close, data_points}

JavaScript

const o = await fetch("https://interestratesapi.com/api/v1/ohlc?symbols=FED_IORB&period=monthly&start=2025-11-07&end=2026-11-07&api_key=YOUR_API_KEY");
const ohlcData = (await o.json()).rates.FED_IORB;

PHP

<?php
$u = "https://interestratesapi.com/api/v1/ohlc?symbols=FED_IORB&period=monthly&start=2025-11-07&end=2026-11-07&api_key=YOUR_API_KEY";
$candles = json_decode(file_get_contents($u), true)["rates"]["FED_IORB"];
?>

JSON example

Use open/high/low/close for candlestick charts. data_points tells you how many business-day observations contributed to the candle.

7) Convert — compare loan interest cost across rates

Convert compares total interest on a simple loan using the latest rates of two symbols. While your use case centers on FED_IORB, this endpoint lets you quickly quantify spreads in dollar terms versus another benchmark (e.g., a policy or interbank rate).

cURL

Python

import requests
cmp = requests.get(
"https://interestratesapi.com/api/v1/convert",
params={"from": "FED_IORB", "to": "ECB_MRO", "amount": 100000, "term_months": 12, "api_key": "YOUR_API_KEY"},
).json()

spread = cmp["difference"]["rate_spread"]
interest_saved = cmp["difference"]["interest_saved"]

JavaScript

const c = await fetch("https://interestratesapi.com/api/v1/convert?from=FED_IORB&to=ECB_MRO&amount=100000&term_months=12&api_key=YOUR_API_KEY");
const cmpData = await c.json();
const spread = cmpData.difference.rate_spread;

PHP

<?php
$url = "https://interestratesapi.com/api/v1/convert?from=FED_IORB&to=ECB_MRO&amount=100000&term_months=12&api_key=YOUR_API_KEY";
$cmp = json_decode(file_get_contents($url), true);
$spread = $cmp["difference"]["rate_spread"];
?>

JSON example

Field notes:

  • rate_spread is in percent points (from.rate − to.rate).
  • total_interest and total_payment reflect a simple loan calculation using the latest rate for each symbol at request time.

Practical implementation details for production

Reading effective dates reliably

Always read the effective date for the rate you use:

  • latest.dates.FED_IORB gives the date the returned rate applies to.
  • timeseries.rates.FED_IORB is intrinsically keyed by effective date; your chart axis should come from the date keys.
  • historical.date echoes your query date, while rates carries the value on or as-of that date (daily for FED_IORB).

Caching and refresh intervals

  • Daily series can be cached for minutes to reduce load and protect against transient errors.
  • Refresh after your scheduled update window or when a new business day begins in your target timezone.
  • Keep a short-lived cache for /latest and a longer page cache for /ohlc and /fluctuation to amortize computation.

Error handling and rate limits

  • 401/403: check your api_key value or account authorization.
  • 404: no symbol or no data in range — consider falling back to /latest or narrowing your date range; some 404s include a details field with available ranges.
  • 422: input validation issues (date format Y-m-d, unknown symbol).
  • 429: retry after the duration in the Retry-After header; consider reading X-RateLimit-* headers to inform backoff strategy.

Computing a spread from returned values

You can compute a spread in code after calling /latest for two symbols. For FED_IORB vs some other benchmark Y:

  • Fetch both via /latest?symbols=FED_IORB,Y.
  • spread_pp = rates.FED_IORB − rates.Y (percent points).
  • Use the dates map to ensure both values are as-of the same effective date; otherwise label your UI with each effective date.

Computing a monthly payment without making up numbers

If you use FED_IORB as an index for a simple loan with principal P and monthly rate r_m (derived from the annual percentage R returned by the API), a standard amortizing payment is:

  • r_m = R / 100 / 12
  • payment = P × r_m × (1 + r_m)^N / ((1 + r_m)^N − 1), for N months

Use the exact R you just fetched from the API (e.g., latest.rates.FED_IORB), pass through your margin or floor rules if applicable, and display the effective date next to the quoted payment. If you prefer a simple-interest estimate, the /convert endpoint returns total_interest and total_payment for you given amount and term_months, using the latest values.

Common fintech use cases with FED_IORB

  • Interest-rate dashboards: refresh /latest and /fluctuation for daily status, and /ohlc monthly for compressing charts.
  • Loan pricing engines: use /latest FED_IORB as the index, compute your spreads and amortizing payments, and cache for short intervals.
  • Macro and risk models: pull /timeseries for regressions, shock scenarios, and pre/post policy-change analysis.
  • Treasury and ALM tooling: monitor spreads between FED_IORB and interbank benchmarks using /latest and /convert.

For developers embedding multiple benchmarks side-by-side, consult the multi-capability page: MCP. You can register and get your key here: Register.

End-to-end reference: all seven endpoints together

For quick scanning, here are minimal one-liners for each endpoint with FED_IORB:

  • Symbols: https://interestratesapi.com/api/v1/symbols?category=central_bank&base=USD&api_key=YOUR_API_KEY
  • Latest: https://interestratesapi.com/api/v1/latest?symbols=FED_IORB&api_key=YOUR_API_KEY
  • Historical: https://interestratesapi.com/api/v1/historical?date=YYYY-MM-DD&symbols=FED_IORB&api_key=YOUR_API_KEY
  • Time series: https://interestratesapi.com/api/v1/timeseries?start=YYYY-MM-DD&end=YYYY-MM-DD&symbols=FED_IORB&api_key=YOUR_API_KEY
  • Fluctuation: https://interestratesapi.com/api/v1/fluctuation?start=YYYY-MM-DD&end=YYYY-MM-DD&symbols=FED_IORB&api_key=YOUR_API_KEY
  • OHLC: https://interestratesapi.com/api/v1/ohlc?symbols=FED_IORB&period=monthly&start=YYYY-MM-DD&end=YYYY-MM-DD&api_key=YOUR_API_KEY
  • Convert: https://interestratesapi.com/api/v1/convert?from=FED_IORB&to=ECB_MRO&amount=100000&term_months=12&api_key=YOUR_API_KEY

If you need to broaden beyond FED_IORB later, use the symbols endpoint to enumerate available identifiers, or visit interestratesapi.com for an overview.

FAQ

Q: What units does the API return for FED_IORB?
A: Percentage points. For example, 3.9 represents 3.90%.

Q: How should I handle weekends and holidays?
A: Daily series omit non-business days. Use the last available business-day value for displays, and always show the dates.FED_IORB effective date so users know which day the value applies to.

Q: How do I compute a rate spread?
A: Call /latest with both symbols (e.g., FED_IORB and another benchmark), then subtract the two values. Confirm whether each symbol’s effective date matches before labeling the spread as-of a specific date.

Q: What errors should I expect and how do I recover?
A: 401/403 for authentication/authorization, 404 for missing symbols/data, 422 for invalid inputs, and 429 for rate limits. On 429, honor Retry-After and inspect X-RateLimit-* headers for pacing.

Q: Can I calculate monthly payments directly from the API?
A: The API returns rates; you can compute amortizing payments from those values, or use /convert for a simple-interest comparison across two rates to estimate total_interest and total_payment for a given term and amount.

Ready to integrate FED_IORB into your platform? Start building with the full endpoint reference at interestratesapi.com, explore additional capabilities via the MCP, and Get started with Interest Rates API to obtain your API key.

Ready to get started?

Get your API key and start validating bank data in minutes.

Get API Key

Related posts