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.
Trading schedules can contain schedules up to 18 months. However, this is not guaranteed and is subject to change.
Trading schedules are forward looking and contain limited historical data (currently year through the duration of listed schedules).
Clients can receive prior notification of unplanned holidays/schedule changes via the following methods:
Check for unplanned changes via a banner located on CME Group Holiday and Trading Hours
Subscribe to Special Executive Orders (SER) at CME subscription center
Sign up for Xmatters - Target Messaging
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.
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.
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.
Trading Schedules URL by Environment
Environment | URL |
|---|---|
New Release | https://refdata.api.uat.cmegroup.com/refdata/v3/tradingSchedules |
Production | https://refdata.api.cmegroup.com/refdata/v3/tradingSchedules |
Message Specifications
ATTRIBUTE NAME | DESCRIPTION | TYPE |
|---|---|---|
tradingScheduleId | Trading Schedule ID 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 |
| String |
marketEventTime | The start time of the market state. (expressed in "GMT") | Date Time Format |