CME Reference Data API - CME Globex Trading Hours and Holiday Schedules
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.
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:
Check for unplanned changes via a banner located on CME Group Holiday and Trading Hours
Subscribe to Special Executive Orders (SER) at Subscription Center
Targeted 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.”
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 |
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 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 |
How was your Client Systems Wiki Experience? Submit Feedback
Copyright © 2024 CME Group Inc. All rights reserved.