Versions Compared

Old Version 1

changes.mady.by.user CME Group

Saved on

compared with

New Version Current

changes.mady.by.user CME Group

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The CME Term SOFR API is a REST API that provides access to daily set of forward-looking interest rate estimates, calculated and published for 1-month, 3-month, 6-month and 12-month tenors in real-time, along with complete history of CME Term SOFR Reference Rates.

Contents

Table of Contents
excludeContents

Additional Resources

CME Term SOFR

Revision History

DateDescription
August 21, 2024Initial release

Key Events and Dates

DateMilestone
September 1, 2024Production

Onboarding

CME Term SOFR API uses OAuth, an open protocol that supports secure authorization in a simple, standard method and decouples authentication from authorization.

See also: Client API Service Adoption using OAuth 2.0 Protocol

Authorization and Entitlement

A registered

Anchor
oauth
oauth
OAuth API ID is required to access the CME Term SOFR API services. API IDs for CME Group Logins are created and managed in the CME Customer Center - My Profile menu. Client API IDs must also be entitled prior to accessing CME Term SOFR API.

Complete the step(s) that are applicable to your account:

New ClientsClients with Existing CME Group Logins
  1. Create a CME Group Login.
  2. After creating and activating a CME Group Login ID, login to CME Customer Center under My Profile and create an OAuth API ID.
  1. Login to CME Customer Center and under My Profile create an OAuth API ID.
Info

Client API ID's must be entitled to access the CME Term SOFR API. To request access to the CME Term SOFR API client can use self-service onboarding  or contact Global Account Management (GAM).

 Testing and Certification

Certification for CME Term SOFR API is not required. 

Access CME Term SOFR API

To access the CME Term SOFR API endpoints in the Production environment, an OAuth API ID and access token are required.

OAuth 2.0 Authorization Server Access Token Retrieval Endpoints

The below OAuth 2.0 authorization server endpoint is available to request and refresh access tokens in the Production environment:

DetailProduction
OAuth Token Endpoint

https://auth.cmegroup.com/as/token.oauth2


Info

Tokens will expire after 30 minutes.

Base URL for Term SOFR API

Below are the base URLs to access the CME Term SOFR API endpoints:

EnvironmentEndpoint Base URL
Productionhttps://markets.api.cmegroup.com/term-sofr-rates/v1

Availability

The CME Term SOFR 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.

The latest rates will publish and be available around 10:00 AM UTC.

Message Specifications

The business message specifications for CME Term SOFR API are available below.

  • The Path value, prefixed with Base URL, will be a specific end point for the HTTPS GET request.
  • 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>"
NamePathMethodDescription
Get Term SOFR Rates - Latest/latestGET

Gets the Latest Term SOFR Rates for the current date. By default returns the Latest Term SOFR rates for all four products.

Accepts the below requests/inputs: 

  1. If no arguments / parameters are provided -> Returns all four of the latest Term SOFR rates for the current date.
  2. If only one Product (productCodes) is provided -> Returns the requested product with the latest Term SOFR rate.
  3. If multiple Products (productCodes) are provided, separated by "," (comma) -> Returns the requested products with the latest Term SOFR rate for each.
Get Term SOFR Rates - History/historyGET

Gets historical Term SOFR rates based on a single date or range of dates provided by the customer. By default returns all historical Term SOFR rates.

Accepts the below requests/inputs:

  1. If both (startDate) and (endDate) fields are provided -> Returns an inclusive range between customer-provided (startDate) and (endDate).
  2. If (startDate) field is provided but no (endDate) field -> The (endDate) field will be defaulted to today/current-date. Returns Term SOFR rates between the range of the specified (startDate) and today/current-date.
  3. If (endDate) field provided but no (startDate) field -> Returns all Term SOFR rates up to customer-provided (endDate).
  4. If no Date fields are provided -> Returns all historical Term SOFR rates based on the customer-provided product codes leading up to today/current-date.
  5. If no arguments / parameters are provided -> Returns all historical Term SOFR rates leading up to today/current-date.
  6. If only (date) field is provided -> Returns the SOFR Term Rate for the customer-provided date.
  7. If date (field) is provided with (startDate) or (endDate) -> The date field takes precedence. Returns the SOFR Term Rate for the customer-provided date.
  8. If all 3 Date fields are provided -> The (date) field takes precedence. Returns the SOFR Term Rate for the customer-provided date.
  9. If only one Product (productCodes) is provided -> Returns the requested product with the historical Term SOFR rate.
  10. If multiple Products (productCodes) are provided, separated by "," (comma) -> Returns the requested products with the historical Term SOFR rate for each.

Pagination

To make responses more manageable, CME Term SOFR API returns results in pages.
The metadata "type" will return page.

By default, 1000 results per page are included, displayed results per page can be requested (up to 2000) using the pagesize parameter. 

CME Term SOFR API also supports a pagenumber parameter to allow clients to view a specific page in the result set.

If pagination (page and size values) is passed in the URL explicitly, then the same will be used to retrieve data.

Name

Description

Additional Details

pagesizeNumber of results returned per page

Optional query parameter.

  • The maximum size value is 2000 and the minimum size value is 1.
  • If size is not specified, the default is 1000.
  • If size is specified but is less than 1 (e.g., size=0 or size=-9 ), the default of 1000 is used.
  • If size is specified but is greater than 2000 (e.g., 3000), 2000 will be used.

Contact Information

For production requests, contact the Global Command Center (GCC).

For other inquiries, contact Global Account Management (GAM).