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.

Pricing

Access to our API is $299.00 per month with a 20% discount for annual payment.

Authentication

The Fed Calendar API uses HTTP Basic Authentication. Include your API key in the Authorization header using the Basic auth scheme, with the API key as the password (username can be any value):

Authorization: Basic base64(username:YOUR_API_KEY)

Making Requests

To make a request to the Fed Calendar API, send an HTTP GET request to:

https://api.fedcalendar.com/calendars/us/federal_reserve

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

Filtering by Year

You can filter holidays by a specific year using the year query parameter:

https://api.fedcalendar.com/calendars/us/federal_reserve?year=2024

The year must be a 4-digit value (e.g., 2024). Invalid year formats will return a 400 error.

Example Request

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

import requests
 
api_key = "YOUR_API_KEY"
 
response = requests.get(
    "https://api.fedcalendar.com/calendars/us/federal_reserve",
    auth=("user", api_key)
)
 
if response.status_code == 200:
    holidays = response.json()
    print(holidays)

Here is an example filtering by year:

import requests
 
api_key = "YOUR_API_KEY"
 
response = requests.get(
    "https://api.fedcalendar.com/calendars/us/federal_reserve?year=2024",
    auth=("user", api_key)
)
 
if response.status_code == 200:
    holidays = response.json()
    print(holidays)

Using cURL:

curl -u user:YOUR_API_KEY "https://api.fedcalendar.com/calendars/us/federal_reserve"
 
# With year filtering
curl -u user:YOUR_API_KEY "https://api.fedcalendar.com/calendars/us/federal_reserve?year=2024"

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",
    ...
  ]
}

Health Check

You can verify the API is operational using the unauthenticated health check endpoint:

GET https://api.fedcalendar.com/up

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.