Versions Compared

Key

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

The API service provides a repeating group of attributes that include the relevant information on the market state of futures and option products traded on CME Globex.

Info

Clients should not expect the JSON messages in the new release and production environment data to align; and should consider the production data as accurate.

Clients can access two years of trading schedules, including 1 year of historical schedules and 1 year forward-looking schedules.

Prior notification of unplanned holidays and/or schedule changes via the following methods:

To receive GCC Targeted Messaging, or to update your existing subscription, please complete the GCC Targeted Messaging Subscription Form and return it as an attachment to GCC@cmegroup.com. Ensure your email includes “Subscribe” in the subject line.”

Trading Schedules URL by Environment

Client systems will send Query Requests by invoking the HTTPS GET method to a URL using pagination. The query must include page and size parameter must be less than 30. If pagination (page and size values) is passed in the URL explicitly, then the same will be used to retrieve data.

...

Environment

URL

New Release

https://refdata.api.uat.cmegroup.com/refdata/v3/tradingSchedules

Production

https://refdata.api.cmegroup.com/refdata/v3/tradingSchedules

Info

Clients should not expect the JSON messages in the new release and production environment data to align; and should consider the production data as accurate.

Message Specifications

ATTRIBUTE NAME

DESCRIPTION

TYPE

tradingScheduleId

Trading Schedule ID

Info

Note: This field is used for internal purposes only; clients should not use this field for coding logic.

 Number

applicableGlobexGroupCodes

Repeating group of CME Globex group code that is affected by the market events. 

String

quadrants

Repeating group of related contracts traded on a given Exchange

String

scheduleNames

Repeating group of schedule names

String

marketEventsByDate

Repeating Group of listing trading date and market events by type and time.

String

tradingDate

Business Trade Date in MMDDYY 

Date

marketEvents

Repeating group listing market event by type and market event time.

String

marketEventType

  • preopen

  • open

  • paused

  • pcp (post close - preopen)

  • closed

String

marketEventTime

The start time of the market state. (expressed in "GMT")

Date Time Format
DDMMYYYY-HH:MM:SS.SSSZ