Can I use the Interest Rate API for commercial purposes?

Yes, but you must have a premium subscription. Commercial use of the Interest Rate API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.

How do I get an API key and start using the Interest Rate API?

Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.

What happens if I exceed my quota for the month?

Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page .

What happens if a request to the Interest Rate API fails?

The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.

What rates can I retrieve with the Interest Rate API?

The API covers current central bank policy rates for 22 countries plus major benchmark and prime rates, including SOFR, EURIBOR, ESTER, SONIA, SARON, TONAR, CORRA, EFFR, and Livret A, all queried via the rate parameter on the /v2/interestrate endpoint. For LIBOR-specific tooling see the LIBOR API , and explore the full API catalog for related finance data.

What does the /v2/interestrate response include?

A request to /v2/interestrate returns a JSON object with rate_name (the name of the rate), rate_pct (the rate value as a percentage), and last_updated (the date the rate was last refreshed in MM-DD-YYYY format). See error codes for the response when a request is unsuccessful.

How do I get historical interest rate data?

Use the /v2/interestratehistorical endpoint with the same rate parameter plus an optional date range, either start_date and end_date in YYYY-MM-DD format or start_time and end_time UNIX timestamps (in seconds); it returns up to 100 data points per call as a data array of objects with timestamp , date ( YYYY-MM-DD ) and rate_pct . Both endpoints are Premium only, so check our pricing page for access details.

How fresh is the data and what can I build with it?

Rates are refreshed every 4 hours, making the API suitable for finance dashboards, mortgage and loan calculators, and macroeconomic monitoring tools. Pair it with the Mortgage Rate API , Inflation API , or Exchange Rate API for richer financial applications.

Interest Rate API

The Interest Rate API provides current central bank interest rates for 22 countries (including the US Federal Reserve, ECB, and Bank of England), major benchmark rates such as SOFR, EFFR, and EURIBOR, and bank prime and base lending rates for the US, Canada, Japan, South Africa, China, Malaysia and Brazil.

"Prime" means different instruments in different markets — a surveyed bank prime rate in the US, a quoted Loan Prime Rate in China, an average of published bank base lending rates in Malaysia. Prime and base lending rate responses therefore include a rate_type and a source field describing exactly what the number is and who publishes it.

Interest rates are refreshed hourly, so new prints from each publisher are picked up promptly.

Available endpoints:

/v2/interestrate - Get a specific interest rate by name
/v2/interestratehistorical - Get historical interest rate data

Online

(4.4)

From 3,856 users

1,000+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average	P50	P75	P90	P95
328ms	370ms	381ms	718ms	999ms

Didn't find what you were looking for? Suggest an improvement

2 endpoints

https://api.api-ninjas.com/v2/interestrate

Get a specific interest rate by name. Returns the rate value, name, and last updated timestamp.

Parameters

`rate` required

Name of the interest rate to retrieve. The following rates are supported:

Central bank rates

Rate	Name
`central_bank_au`	Reserve Bank of Australia
`central_bank_br`	Central Bank of Brazil
`central_bank_ca`	Bank of Canada
`central_bank_cn`	People's Bank of China
`central_bank_cz`	Czech National Bank
`central_bank_dk`	Danmarks Nationalbank
`central_bank_eu`	European Central Bank
`central_bank_hu`	Hungarian National Bank
`central_bank_in`	Reserve Bank of India
`central_bank_il`	Bank of Israel
`central_bank_mx`	Bank of Mexico
`central_bank_nz`	Reserve Bank of New Zealand
`central_bank_no`	Norges Bank
`central_bank_pl`	Narodowy Bank Polski
`central_bank_ru`	Central Bank of Russia
`central_bank_sa`	South African Reserve Bank
`central_bank_sk`	Bank of Korea
`central_bank_se`	Sveriges Riksbank
`central_bank_ch`	Swiss National Bank
`central_bank_tr`	Central Bank of the Republic of Türkiye
`central_bank_gb`	Bank of England
`central_bank_us`	United States Federal Reserve

Benchmark rates

Rate	Name
`prime_us`	United States Prime Rate
`prime_ca`	Canada Prime Rate
`prime_jp`	Japan Prime Rate
`prime_za`	South Africa Prime Lending Rate
`lpr_cn_1y`	China Loan Prime Rate - 1 year
`lpr_cn_5y`	China Loan Prime Rate - over 5 years
`br_my`	Malaysia Average Base Rate
`blr_my`	Malaysia Average Base Lending Rate
`tpb_br`	Brazil Taxa Preferencial Brasileira
`euribor_1_week`	Euribor - 1 week
`euribor_1_month`	Euribor - 1 month
`euribor_3_months`	Euribor - 3 months
`euribor_6_months`	Euribor - 6 months
`euribor_12_months` (Euribor - 12 months)
`ester`	ESTER
`sonia`	SONIA
`saron`	SARON
`tonar`	TONAR
`sofr`	SOFR - overnight
`sofr_30d_avg`	SOFR 30-day average
`sofr_90d_avg`	SOFR 90-day average
`sofr_180d_avg`	SOFR 180-day average
`effr`	Effective Federal Funds Rate - EFFR
`corra`	Canadian Overnight Repo Rate Average - CORRA
`livret_a`	Livret A rate - France

Headers

X-Api-Key required
API Key associated with your account.

Response

The /v2/interestrate endpoint returns a JSON object with the following fields, or an error if the request is unsuccessful.

rate_name
The name of the interest rate.
rate_pct
The interest rate value as a percentage.
last_updated
Date when the rate was last updated (MM-DD-YYYY format).

Live Demo

Live demo · no API key required

Query parameters

rate

Get a free API key to get started — no credit card required.

Headers

X-Api-KeyLog in or sign up to get your API key

GET

https://api.api-ninjas.com/v2/interestrate?rate=central_bank_us

Sample response

{

"rate_name": "United States Federal Reserve",

"rate_pct": 4.5,

"last_updated": "12-18-2024"

}

Code Examples

curl -X GET "https://api.api-ninjas.com/v2/interestrate?rate=central_bank_us" \
  -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

Premium only

https://api.api-ninjas.com/v2/interestratehistorical

Returns historical interest rates for specific central banks or benchmark rates using a single rate parameter. You can specify a time range to retrieve data from. Data points are returned oldest first, and the maximum number returned per API call is 100. When more data is available the response includes a next cursor — pass it back as the page parameter to retrieve the following page.

History depth varies by publisher: the US and Canadian prime rates go back to 1990, Japan to 1989 and Brazil to 2011, while South Africa, China and Malaysia start from when we began collecting them, since their publishers only serve current values.

Parameters

`rate` required

The specific interest rate identifier. Supports both central bank rates and benchmark rates.

Central bank rates

Rate	Name
`central_bank_au`	Australia - Reserve Bank of Australia
`central_bank_br`	Brazil - Central Bank of Brazil
`central_bank_ca`	Canada - Bank of Canada
`central_bank_cn`	China - People's Bank of China
`central_bank_cz`	Czech Republic - Czech National Bank
`central_bank_dk`	Denmark - Danmarks Nationalbank
`central_bank_eu`	Eurozone - European Central Bank
`central_bank_hu`	Hungary - Hungarian National Bank
`central_bank_in`	India - Reserve Bank of India
`central_bank_il`	Israel - Bank of Israel
`central_bank_mx`	Mexico - Bank of Mexico
`central_bank_nz`	New Zealand - Reserve Bank of New Zealand
`central_bank_no`	Norway - Norges Bank
`central_bank_pl`	Poland - Narodowy Bank Polski
`central_bank_ru`	Russia - Central Bank of Russia
`central_bank_sa`	South Africa - South African Reserve Bank
`central_bank_sk`	South Korea - Bank of Korea
`central_bank_se`	Sweden - Sveriges Riksbank
`central_bank_ch`	Switzerland - Swiss National Bank
`central_bank_tr`	Türkiye - Central Bank of the Republic of Türkiye
`central_bank_gb`	United Kingdom - Bank of England
`central_bank_us`	United States - United States Federal Reserve

Benchmark rates

Rate	Name
`prime_us`	United States Prime Rate
`prime_ca`	Canada Prime Rate
`prime_jp`	Japan Short-Term Prime Rate — one point per rate change
`prime_za`	South Africa Prime Lending Rate
`lpr_cn_1y`	China Loan Prime Rate - 1 year
`lpr_cn_5y`	China Loan Prime Rate - over 5 years
`br_my`	Malaysia Average Base Rate
`blr_my`	Malaysia Average Base Lending Rate
`tpb_br`	Brazil Taxa Preferencial Brasileira
`euribor_1_week`	Euribor - 1 week
`euribor_1_month` (Euribor - 1 month)
`euribor_3_months` (Euribor - 3 months)
`euribor_6_months` (Euribor - 6 months)
`euribor_12_months` (Euribor - 12 months)
`ester`	ESTER
`sonia`	SONIA
`saron`	SARON
`tonar`	TONAR
`sofr`	SOFR - overnight
`sofr_30d_avg`	SOFR 30-day average
`sofr_90d_avg`	SOFR 90-day average
`sofr_180d_avg`	SOFR 180-day average
`effr`	Effective Federal Funds Rate - EFFR
`corra`	Canadian Overnight Repo Rate Average - CORRA
`livret_a` Livret A rate (France)
`usd_libor_overnight` (USD LIBOR Overnight)
`usd_libor_1_month`	USD LIBOR - 1 month
`usd_libor_3_months`	USD LIBOR - 3 months
`usd_libor_6_months`	USD LIBOR - 6 months
`usd_libor_12_months` (USD LIBOR - 12 months)

start_date optional
Start date for the data range (inclusive) in YYYY-MM-DD format, e.g. 2024-01-01. Dates are in UTC.
end_date optional
End date for the data range (inclusive) in YYYY-MM-DD format, e.g. 2024-12-31. Dates are in UTC.
start_time optional
Start time for the data range, specified as a UNIX timestamp in seconds. Alternative to start_date; do not set both.
end_time optional
End time for the data range, specified as a UNIX timestamp in seconds. Alternative to end_date; do not set both.
page optional
Pagination cursor. Pass the next value from a previous response to retrieve the following page of data points.

Headers

X-Api-Key required
API Key associated with your account.

Response

The /v2/interestratehistorical endpoint returns a JSON object with the following fields, or an error if the request is unsuccessful.

name
The name of the interest rate.
data
Array of historical rate data objects, oldest first (up to 100 per call), each containing timestamp (UNIX timestamp in seconds), date (the date the rate applies to, YYYY-MM-DD in UTC) and rate_pct (interest rate as a percentage). All rates are daily or less frequent, so date is the meaningful value; the time of day in timestamp carries no information.
next
Cursor for the next page of data points; pass it back as the page parameter. null on the last page.

Live Demo

Live demo

Query parameters

rate

start_date

end_date

Get a free API key to get started — no credit card required.

Headers

X-Api-KeyLog in or sign up to get your API key

GET

https://api.api-ninjas.com/v2/interestratehistorical?rate=central_bank_us

Sample response

{

"name": "United States Federal Reserve",

"data": [

{

"timestamp": 647827200,

"date": "1990-07-13",

"rate_pct": 8

{

"timestamp": 657158400,

"date": "1990-10-29",

"rate_pct": 7.75

{

"timestamp": 658454400,

"date": "1990-11-13",

"rate_pct": 7.5

{

"timestamp": 660528000,

"date": "1990-12-07",

"rate_pct": 7.25

{

"timestamp": 661478400,

"date": "1990-12-18",

"rate_pct": 7

{

"timestamp": 663379200,

"date": "1991-01-09",

"rate_pct": 6.75

{

"timestamp": 665366400,

"date": "1991-02-01",

"rate_pct": 6.25

{

"timestamp": 668390400,

"date": "1991-03-08",

"rate_pct": 6

"..."

"next": "eyJvIjogMTAwfQ=="

}

Code Examples

curl -X GET "https://api.api-ninjas.com/v2/interestratehistorical?rate=central_bank_us" \
  -H "X-Api-Key: YOUR_API_KEY"

Frequently Asked Questions

Can I use the Interest Rate API for commercial purposes?
Yes, but you must have a premium subscription. Commercial use of the Interest Rate API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
How do I get an API key and start using the Interest Rate API?
Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
What happens if I exceed my quota for the month?
Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
What happens if a request to the Interest Rate API fails?
The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
What rates can I retrieve with the Interest Rate API?
The API covers current central bank policy rates for 22 countries plus major benchmark and prime rates, including SOFR, EURIBOR, ESTER, SONIA, SARON, TONAR, CORRA, EFFR, and Livret A, all queried via the rate parameter on the /v2/interestrate endpoint. For LIBOR-specific tooling see the LIBOR API, and explore the full API catalog for related finance data.
What does the /v2/interestrate response include?
A request to /v2/interestrate returns a JSON object with rate_name (the name of the rate), rate_pct (the rate value as a percentage), and last_updated (the date the rate was last refreshed in MM-DD-YYYY format). See error codes for the response when a request is unsuccessful.
How do I get historical interest rate data?
Use the /v2/interestratehistorical endpoint with the same rate parameter plus an optional date range, either start_date and end_date in YYYY-MM-DD format or start_time and end_time UNIX timestamps (in seconds); it returns up to 100 data points per call as a data array of objects with timestamp, date (YYYY-MM-DD) and rate_pct. Both endpoints are Premium only, so check our pricing page for access details.
How fresh is the data and what can I build with it?
Rates are refreshed every 4 hours, making the API suitable for finance dashboards, mortgage and loan calculators, and macroeconomic monitoring tools. Pair it with the Mortgage Rate API, Inflation API, or Exchange Rate API for richer financial applications.

Explore API integration use cases for recommended APIs and workflow examples.

Interest Rate API

Parameters

`rate` required

Headers

`X-Api-Key` required

Response

`rate_name`

`rate_pct`

`last_updated`

Live Demo

Code Examples

Premium only

Parameters

`rate` required

`start_date` optional

`end_date` optional

`start_time` optional

`end_time` optional

`page` optional

Headers

`X-Api-Key` required

Response

`name`

`data`

`next`

Live Demo

Code Examples

Frequently Asked Questions

Interest Rate API

/v2/interestrateGET

Parameters

rate required

Headers

X-Api-Key required

Response

rate_name

rate_pct

last_updated

Live Demo

Code Examples

/v2/interestratehistoricalGETPremium only

Parameters

rate required

start_date optional

end_date optional

start_time optional

end_time optional

page optional

Headers

X-Api-Key required

Response

name

data

next

Live Demo

Code Examples

Frequently Asked Questions

`rate` required

`X-Api-Key` required

`rate_name`

`rate_pct`

`last_updated`

Premium only

`rate` required

`start_date` optional

`end_date` optional

`start_time` optional

`end_time` optional

`page` optional

`X-Api-Key` required

`name`

`data`

`next`