The CME FedWatch API is a REST API that provides access to rate probability for upcoming Federal Open Markets Committee (FOMC) meetings along with historical rates.

Contents

1 Onboarding
2 Testing and Certification
3 Availability
4 Accessing CME FedWatch API
- 4.1 FedWatch API URLs
- 4.2 Message Specifications
- 4.3 Response Metadata fields

Additional Resources

Additional Resources

CME Fedwatch Tool

CME Fedwatch Tool User Guide

Onboarding

CME FedWatch API requires an OAuth API ID. OAuth is an open protocol that supports secure authorization in a simple, standard method and decouples authentication from authorization. More details about OAuth API ID authorization and authentication are available in Client API Service Adoption using OAuth 2.0 Protocol.

To access the CME FedWatch API, client API IDs must be entitled. Request access from the CME Group Market Data API self-service onboarding page or contact Global Account Management (GAM).

Testing and Certification

Certification for CME FedWatch API is not required.

Availability

The CME FedWatch API is available 24 hours a day, 7 days a week. Clients systems should consider all returned data to be accurate at the time of the request submission.

Accessing CME FedWatch API

This section describes the message specifications and URLs to access CME FedWatch API.

FedWatch API URLs

Below are the base URLs to access the CME FedWatch API endpoints:

Environment	Endpoint URL
Production	https://markets.api.cmegroup.com/fedwatch/v1

Message Specifications

CME FedWatch API business message specifications are detailed below.

The Path value with Base URL prefix will be a specific end point for the HTTPS GET call.
Each HTTPS GET call must have the header parameter "Authorization" with value "Bearer" pre-pended to the OAuth token (including a space separator).
example: "Bearer <Oauth Access token>"

Forecasts are updated on business days at 01:45 UTC, excluding holidays.

Name	Path	Method	Description
Get Forecasts	/forecasts	GET	Gets the forecasted Fed Funds Rate Range for Federal Open Market Committee (FOMC) meetings. Accepts the below requests/inputs: No arguments -> fetches the upcoming FOMC meeting with the most recent rate forecast. Meeting dates (`meetingDt`) and reporting dates (reportingDt) provided -> fetches the specified meeting dates with the requested forecasts for each. Only Meeting dates (`meetingDt`) provided -> fetches the requested meetingDts with the latest rates forecast for each. Only reporting dates (`reportingDt`) provided -> fetches the specified reportingDts for the upcoming FOMC meeting.
Get Meetings - Future	/meetings/future	GET	Gets future FOMC meeting dates with days remaining until the meeting. By default returns all future FOMC meeting dates from current date/time.
Get Meetings - History	/meetings/history	GET	Gets past FOMC meeting dates with days since the meeting. By default returns all past FOMC meeting dates from current date/time.

Response Metadata fields

The following information describes the metadata JSON element on the response payload to client systems.

Field	Description	Usage
pageSize	Maximum number of data elements in the JSON result set or page.	Defaults to 1000 with a maximum of 2000. Can be used as a query parameter to limit the number of elements returned per request. E.g. /history?pageSize=500
totalPages	Total number of pages in the full result set.
pageNumber	The current page in the set of pages.	If totalPages is greater than 1, pageNumber is used to navigate to the next page of the result set. E.g. /history?pageNumber=2 (retrieve the second page in the data set)
totalElements	Value indicates the total Elements in the full data set.
type	Type of JSON data set	Always set to value “page”
elementsInReponse	Number of data elements in the JSON result set or page.