Quick start
curl https://interestratedecision.com/api/v1/rates?bank=fedA real answer, as of Nov 12, 2026:
{
"source": "https://interestratedecision.com/fed/",
"asOf": "2026-11-12T08:19:22.694Z",
"licence": "Free to reuse with a link to https://interestratedecision.com",
"data": {
"bank": "fed",
"name": "Federal Reserve",
"rateName": "federal funds rate (target range)",
"rate": 4,
"rangeLow": 3.75,
"lastChange": "2026-09-16T18:00:00.000Z",
"nextDecision": "2026-12-09T19:00:00.000Z",
"page": "https://interestratedecision.com/fed/",
"history": "https://interestratedecision.com/fed/rate-history.csv"
}
}Every answer has the same four parts: source (the page the figures are on), asOf (when they are as of), licence and data. Quote the source.
Endpoints
| Address (GET) | Parameters | What it gives |
|---|---|---|
/api/v1/rates | ?bank=fed | The rate now, the date of the last change and the next decision. All ten banks when no bank is given. |
/api/v1/next | ?bank=fed | The next decision: time in UTC, whether the time is an estimate, press conference, projections and the rate before it. Soonest first when no bank is given. |
/api/v1/history | ?bank=fed&limit=20&since=2024-01-01 | Past decisions since 2008, newest first: the rate after each and the change in basis points. limit 1 to 200 (default 20). |
/api/v1/odds | ?bank=fed | The odds of a cut, hold or hike at the next meetings, counted from the record by fixed rules. Not market prices. |
The banks are fed, ecb, boe, boj, boc, rba, rbnz, snb, norges, riksbank. https://interestratedecision.com/api/v1 lists the endpoints and the banks. A bad bank, limit or date gets a 400 that says what is allowed.
MCP server for AI assistants
The same four answers are tools on a remote MCP server: https://interestratedecision.com/mcp (Streamable HTTP, JSON replies, no authentication). Add that address as a remote server in an MCP client. A client that only runs local servers can reach it through a bridge such as mcp-remote.
| Tool | Arguments | What it gives |
|---|---|---|
get_current_rate | bank (optional) | The rate now, the last change and the next decision. |
get_next_decision | bank (optional) | The next decision, with its time in UTC. |
get_rate_history | bank, limit, since | Past decisions, newest first. |
get_rate_odds | bank (optional) | Odds from the record for the next meetings. |
All four are read-only. Their results carry the same source, asOf and licence, and the odds tool says in its description that its numbers are not market prices.
Limits
- 60 requests a minute for each address, shared by the API and the MCP server. Over it you get a 429 with
Retry-After. The address is hashed and held in memory for a minute: nothing is stored. - Answers are cached for five minutes and the data is refreshed every two hours, and within minutes of a decision. Do not poll faster than that.
- Open to browsers (CORS) from any site. No cookies.
What is not served, and why
- Market prices (prediction markets, futures-implied odds). The site has no permission to redistribute them, so none are served. The odds it serves are its own, counted from the record: say “odds from the record”.
- The calendar’s consensus. It is the calendar’s own data and stays out of the open data. Rates, dates and changes are free.
The same data as files: the free data page (CSV and JSON), the calendar file and /llms.txt.
Questions
Do I need an API key?
No. There is no key, no sign-up and no cost. Requests are limited to 60 a minute for each address, and answers are cached for five minutes.
Where do the figures come from?
From the same published data as the pages of this site: the economic calendar for decisions and rates, and the site’s own odds counted from the record. An answer can never disagree with a page, because it is read from the files the build publishes. Every answer names its source page and the date it is as of.
Does it serve market prices, such as prediction markets or futures-implied odds?
No. The site has no permission to redistribute them, so none are served. The odds it does serve are its own, counted from the record of past decisions by fixed rules; call them “odds from the record”, not market odds.
Why is the calendar’s consensus not in the history?
The expected rate in the calendar is its own data and is not passed on in the open data, here or in the other open files. Rates, dates and changes are.
Can I use the answers in my own product?
Yes, free, with a link to https://interestratedecision.com. Say when the figures are as of, and that rates and dates should be checked against the central bank’s own site before anyone acts on them.
Is this investment advice?
No. It states what was decided and when the next decision is.