Introduction

Welcome to the developer documentation for Fed Calendar, an API providing accurate and up-to-date information about when the Federal Reserve is closed due to banking holidays. In this documentation, you will find everything you need to know to integrate Fed Calendar into your application. To learn more about our data integrity process, visit our about page

Getting Started

To get started with Fed Calendar, you will need an API key. You can do this by emailing [email protected], we will get you live within 12 hours. Once you have your API key, you can start making requests to the Fed Calendar API.

Making Requests

To make a request to the Fed Calendar API, you will need to send an HTTP GET request to the following URL:

https://api.fedcalendar.com/calendars/us/federal_reserve?api_key=YOUR_API_KEY

The API will return a JSON object containing a list of all published federal reserve banking holidays.

Here is an example of how to make a request using Python:

import requests
 
api_key = "YOUR_API_KEY"
 
response = requests.get(f"https://www.fedcalendar.com/api/v1/holidays?api_key={api_key}")
 
if response.status_code == 200:
  holidays = response.json()
  print(holidays)

Response Format

The response from the API will be a JSON object with the following structure:

{
  "country": "us",
  "calendar": "federal_reserve",
  "updated_at": "2022-12-28T19:05:07.577Z",
  "audited_at": "2022-12-28T19:05:07.577Z",
  "banking_holidays": [
    "2023-01-02",
    "2023-01-16",
    ...
  ]
}

Rate Limiting

The Fed Calendar API has a rate limit of 100 requests per day for standard accounts. If you exceed this limit, you will receive a 429 Too Many Requests error. We offer 100 requests per second for enterprise customers.

Support

If you have any questions or need assistance, please don't hesitate to contact us at [email protected]. We're always happy to help.