Central Bank Calendar API: 14 Rate Decision Schedules

Central bank calendar API

The central bank calendar API returns recorded rate-decision schedules for the Fed, ECB, Bank of England, Bank of Japan, Bank of Canada, RBA, RBNZ, SNB, Norges Bank, Riksbank and PBoC, plus FOMC minutes, the Beige Book and Fed testimony, as JSON, with UTC and display times where known. Filter the category to query the scheduled meetings in date order, then inspect the coverage directory for each bank and any supported numerical observations.

Authenticated request
curl --fail-with-body \
  "https://www.financecalendar.com/wp-json/fc/v1/calendar?category=central-banks-monetary-policy&limit=5" \
  -H "X-API-Key: $FC_API_KEY"

Keep your API key in private server configuration. Data requests share your account allowance.

Forecasts and results

Paid plans add release forecasts for 60 headline measures across 10 economies in the forecasts field, refreshed hourly, frozen at release time and labelled with their update time and source count. Build richer release briefings and dashboards with provider consensus forecasts across 12 selected US headline release series: US headline CPI, nonfarm payrolls, PPI, retail sales, PCE, ISM Manufacturing, industrial production, Conference Board Consumer Confidence, JOLTS, ADP employment, ISM Services PMI and goods-and-services Trade Balance. Compare recorded forecasts with published results on covered releases, alongside dates, impact ratings and source links.

Actual and prior values combine validated official observations with matched provider data. Each value retains its metric, reference period and source evidence. Review coverage and source evidence or query /quality for the current records; a value without recorded evidence remains null. The public calendar is free to browse; programmatic access uses a paid API plan.

Historical response examples: the examples below illustrate the response structure. Query the authenticated endpoints for current forecasts and results; recorded history represents the captured vintage.

The category/series-specific and other-format examples below use paid API access. Free Developer includes economic-release and central-bank schedules in its bounded /calendar and /today JSON scope, without those richer filters or results.

Authentication and account allowances

Account and API key required

Use a verified account key for authenticated data requests, in X-API-Key or Authorization: Bearer. Choose Free Developer for its bounded schedule JSON or a paid plan for numerical figures, wider dates, richer routes and tools. The OpenAPI schema, current product offer and fixed recorded sample are public without a key. Create and manage keys in your account; anonymous key creation is not supported.

Authentication and account allowances

Browse the public economic calendar free. Connect apps and AI tools with paid API access from US$4.99/month or US$53.89/year. Starter includes 250 requests per UTC day and 5,000 per UTC calendar month. Build is US$9.99/month or US$95.90/year, with 100,000 requests per UTC day. Scale is US$29.00/month or US$278.40/year, with 1,000,000 requests per UTC day and the complete current dataset download. Free Developer provides 100 successful schedule JSON responses per UTC calendar month, up to 10 per UTC day, with one key issued after approval of your request (allow up to 168 hours for review). Use /calendar and /today for economic-release and central-bank schedules from UTC today through today+6, with country/impact filters, bounded date narrowing and up to 20 records per response. The allowance renews monthly; no card, fixed expiry or automatic paid subscription. Figures, history, wider dates/routes, CSV/ICS, hosted MCP, Data explorer and webhooks require a paid plan. Personal and customer-facing projects are allowed within these limits and applicable source terms. Annual prices are charged upfront. Paid plans renew at their selected interval until cancelled; applicable tax is included. Linked keys share one account allowance.

Inspect the recorded sample · Compare current plans. Existing subscription agreements and paid-through migration access retain their confirmed terms.

Keep keys in private server or application configuration. Do not put them in public HTML, client JavaScript, spreadsheet cells, iframe URLs or query strings. For the shell examples below, enter your real key privately:

read -r -s FC_API_KEY
export FC_API_KEY

Missing or invalid credentials return 401; revoked or disallowed access returns 403; exhausted allowance returns 429. Key validation or data unavailability can return 503. Respect Retry-After when supplied. Credentialed responses are private/no-store; do not treat them as public CDN content. Retain Finance Calendar attribution and each record’s source rights.

Central bank rows share the category central-banks-monetary-policy in the Finance Calendar API. Each bank is its own series code, so you can ask for one, several or all. For the Fed in detail see the FOMC dates API.

Series codes

Central bank Code Aliases Country Unit Recurrence
Federal Reserve (FOMC) fomc fed, fed-decision, fed-funds US % target range 8x/year
European Central Bank ecb ecb-decision EU % deposit rate 8x/year
Bank of England MPC boe bank-of-england, mpc GB % bank rate 8x/year
Bank of Japan boj bank-of-japan JP % policy rate 8x/year
Bank of Canada boc bank-of-canada CA % policy rate 8x/year
Reserve Bank of Australia rba reserve-bank-of-australia AU % cash rate 8x/year
Reserve Bank of New Zealand rbnz reserve-bank-of-new-zealand, ocr NZ % OCR 8x/year
Swiss National Bank snb swiss-national-bank CH % policy rate Quarterly
Norges Bank norges norges-bank NO % policy rate 8x/year
Riksbank riksbank SE % policy rate 8x/year
PBoC loan prime rate pboc-lpr pboc, lpr, loan-prime-rate CN % 1y LPR Monthly
FOMC minutes fomc-minutes fed-minutes US 8x/year
Beige Book beige-book US 8x/year
Fed chair testimony fed-testimony humphrey-hawkins, powell-testimony US Annual

Recurrence is the value the API reports for each series; the API reads each bank’s own calendar every hour, so the rows are what the bank has announced, not a rule. /series?category=central-banks-monetary-policy returns the live list with each series’ next date, and may include further Fed events as they are added.

Every decision in date order

curl -H "X-API-Key: $FC_API_KEY" "https://www.financecalendar.com/wp-json/fc/v1/calendar?category=central-banks-monetary-policy&to=2026-12-31"

The first 2 of 25 rows between 19 October and 31 December 2026:

{
  "from": "2026-10-19",
  "to": "2026-12-31",
  "count": 2,
  "total": 25,
  "events": [
    { "id": "pboc-loan-prime-rate-october-2026", "series_code": "pboc-lpr", "name": "PBoC Loan Prime Rate", "country": "CN", "impact": "medium", "date": "2026-10-19", "time_utc": "2026-10-20T01:00:00+00:00", "time_et": "21:00", "status": "confirmed", "consensus": null, "prior": "Held at 3.0% (1-year) / 3.5% (5-year), September 2026", "unit": "% 1y LPR", "source_name": "People's Bank of China", "note": "[source calendar says 2026-10-20]", ... },
    { "id": "rbnz-rate-decision-october-2026", "series_code": "rbnz", "name": "RBNZ Rate Decision", "country": "NZ", "impact": "medium", "date": "2026-10-27", "time_utc": "2026-10-28T01:00:00+00:00", "time_et": "21:00", "status": "confirmed", "consensus": null, "prior": "Held at 2.75% (September 2026)", "unit": "% OCR", "note": "Monetary Policy Review [source calendar says 2026-10-28]", ... }
    // 23 more rows
  ],
  "attribution": { ... }
}

Both rows show the note field flagging a difference between the row’s date and the bank’s own calendar date: the PBoC fixing is at 09:00 Beijing time on 20 October, which is 21:00 Eastern on 19 October, and the row is filed under the New York date. time_utc is the instant to use. Add impact=high to keep the Fed, ECB, BoE, BoJ, Bank of Canada and RBA and drop the medium-impact banks, or name the banks you want:

curl -H "X-API-Key: $FC_API_KEY" "https://www.financecalendar.com/wp-json/fc/v1/calendar?series=fomc,ecb,boe,boj&to=2027-01-19&tz=Europe/London"

Next decision for one bank

curl -H "X-API-Key: $FC_API_KEY" "https://www.financecalendar.com/wp-json/fc/v1/next?series=boe&tz=Europe/London"

This returns the Bank of England decision on 5 November 2026 with "time_utc": "2026-11-05T12:00:00+00:00", "time_local": "12:00" and "note": "November Monetary Policy Report". The note field flags meetings that come with projections, a press conference or a policy report. Two-day meetings (Fed, ECB, BoJ) carry starts_on for the first day.

The Bank of Japan row shows why the time matters: the decision is “announced around midday JST” (its note), which the API records as "time_utc": "2026-10-30T03:00:00+00:00" and "time_et": "23:00" on 29 October in New York. date stays 30 October, the publisher’s local date.

Download an authenticated calendar file

ICS uses the same required account key. Download it from a trusted server or local shell, then import the file into your calendar. A calendar application that cannot send an authentication header cannot use the REST URL as an anonymous subscription. Do not put a key in the subscription URL.

curl -H "X-API-Key: $FC_API_KEY" "https://www.financecalendar.com/wp-json/fc/v1/calendar?category=central-banks-monetary-policy&format=ics" -o financecalendar.ics

The calendar API allows at most a 92-day date difference per request. Use separate authenticated windows for a longer range; consult the schedule hub for ordinary browsing. Preserve timing precision and source evidence; unavailable exact times must not be converted to an invented instant.

Outcomes and history

/history?series=ecb&limit=8 returns up to 8 recorded ECB decisions with nullable result fields. Inspect series coverage and official numerical observations rather than inferring complete outcome coverage from meeting dates. /series/fomc also includes its separately recorded long-run dataset where available. /changes records retained field changes; it does not guarantee original first prints.

Frequently asked questions

Which banks are high impact?

The Fed, ECB, Bank of England, Bank of Japan, Bank of Canada and RBA are flagged high. The RBNZ, SNB, Norges Bank, Riksbank, PBoC and FOMC minutes are medium; the Beige Book is low. Filter with impact=.

Are unscheduled decisions included?

The calendar holds scheduled meetings. Emergency decisions appear in the Fed’s long-run dataset under /series/fomc, marked in note.

Is the consensus the market’s or yours?

The API now includes provider consensus for 12 selected US economic-release series, including CPI, nonfarm payrolls and PCE. This expansion concerns economic indicators; policy-rate consensus is outside that coverage. For central bank decisions, use the recorded schedule, supported policy-rate observations and publisher source links, rather than treating a prior rate or article expectation as a consensus forecast. See the current coverage directory.

Why is the PBoC a monthly row?

China’s loan prime rate is fixed monthly, around the 20th, so pboc-lpr has recurrence Monthly rather than 8x/year.

Attribution

The public calendar is free to browse. API access requires an active paid subscription. Starter, Build and Scale all include API access for your own tools, apps and products. Retain a visible FinanceCalendar.com link and the source credits and rights notices supplied with each record. See the API service terms. Earnings dates are not included.

Build with the calendar behind the data.

Choose a plan, confirm your account and create an API key. Check the source coverage for the records your workflow needs.