CME Group APIcmegroup.com ↗
Access CME FedWatch probabilities, futures quotes, settlements, options chains, volume/OI history, and product catalog across all CME asset classes.
What is the CME Group API?
This API covers 10 endpoints for CME Group market data, spanning FedWatch interest rate probabilities, futures quotes, settlement prices, options chains, and contract specifications. The get_fedwatch endpoint returns FOMC meeting dates alongside target rate probability distributions derived from 30-Day Federal Funds futures, while get_futures_quotes and get_settlements deliver per-contract-month OHLC and volume across metals, energy, equity indexes, FX, agriculture, and interest rates.
curl -X POST 'https://api.parse.bot/scraper/16d53d6b-f0dd-4ddd-b59b-fff50d2f3a5c/get_fedwatch' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"meeting_date": "28 Oct 2026"
}'Retrieves CME FedWatch Tool data: upcoming FOMC meeting dates, target rate probabilities (Ease/No Change/Hike), and a detailed probability distribution across rate ranges with current, 1-day, 1-week, and 1-month comparisons. Data sourced from 30-Day Federal Funds futures pricing. When meeting_date is provided, returns probabilities for that specific FOMC meeting; otherwise returns the nearest/front meeting. Returns a single snapshot object.
| Param | Type | Description |
|---|---|---|
| meeting_date | string | FOMC meeting date to retrieve probabilities for. Accepts short form like '28 Oct26' (as returned in meeting_dates) or long form like '28 Oct 2026'. Omitting returns the nearest/front meeting. |
{
"type": "object",
"fields": {
"meeting_dates": "array of strings - upcoming FOMC meeting dates",
"data_timestamp": "string or null - when data was last updated",
"current_meeting_info": "object with meeting_date, contract, expires, mid_price, prior_volume, prior_oi",
"current_probabilities": "object with ease, no_change, hike percentage values",
"target_rate_probabilities": "array of objects with target_rate_bps, is_current, now, 1_day, 1_week, 1_month"
},
"sample": {
"data": {
"meeting_dates": [
"17 Jun26",
"29 Jul26",
"16 Sep26"
],
"data_timestamp": "Data as of 10 Jun 2026 06:13:03 CT",
"current_meeting_info": {
"expires": "30 Jun 2026",
"contract": "ZQM6",
"prior_oi": "248,571",
"mid_price": "96.3800",
"meeting_date": "17 Jun 2026",
"prior_volume": "18,118"
},
"current_probabilities": {
"ease": "1.6 %",
"hike": "0.0 %",
"no_change": "98.4 %"
},
"target_rate_probabilities": [
{
"now": "1.6%",
"1_day": "0.8%",
"1_week": "2.7%",
"1_month": "6.6%",
"is_current": false,
"target_rate_bps": "325-350"
},
{
"now": "98.4%",
"1_day": "99.2%",
"1_week": "97.3%",
"1_month": "93.4%",
"is_current": true,
"target_rate_bps": "350-375"
}
]
},
"status": "success"
}
}About the CME Group API
FedWatch and Interest Rate Probabilities
The get_fedwatch endpoint returns a list of upcoming FOMC meeting dates, the underlying futures contract and its mid price, prior volume and open interest, and a breakdown of ease/no-change/hike probabilities as percentages. The target_rate_probabilities array gives a granular view of probability mass across individual rate ranges in basis points, with columns for now, 1-day, 1-week, and 1-month comparisons. You can pass a specific meeting_date string (e.g. '28 Oct26') to pin the response to one meeting.
Quotes, Settlements, and Volume
get_futures_quotes accepts a numeric product_id or a friendly name like gold, crude_oil, or natural_gas and returns all available contract months with last, open, high, low, close, change, percentage_change, volume, and trading limit fields. Data is delayed 10 minutes. get_settlements adds a settle price and prior_day_oi field per contract month, and accepts an optional trade_date in MM/DD/YYYY format to retrieve historical settlement dates. get_volume returns a configurable number of days of futures and options volume and open interest separately, controlled by the days parameter.
Options and Expirations
get_option_expirations lists every available option type for a product — American, weekly (Mon–Fri), and other styles — with contract dates, last trade dates, and the underlying futures code. get_options_quotes then retrieves near-the-money strikes for a chosen expiration_month, returning call and put objects per strike with last, change, prior_settle, and volume. The available_expirations field in the response mirrors what get_option_expirations exposes, so you can paginate through expirations without a separate call.
Instrument Search and Contract Specs
search_instruments accepts a text query and an optional product_type filter (e.g. metals, interest_rates, crypto) and returns up to 500 instruments sorted by open interest, each with a numeric instrument_id. That ID feeds into get_instrument_details for full contract specs — tick size, contract size, Globex code, clearing code, settlement method, and trading hours by venue — and into get_historical_quotes for daily OHLC, settlement, volume, and open interest rows. Historical data availability is limited to approximately five recent business days. get_product_catalog lists all products for a given asset class with their CME page URLs, useful for bulk discovery.
The CME Group API is a managed, monitored endpoint for cmegroup.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when cmegroup.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official cmegroup.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track real-time FOMC rate hike/cut probabilities for a fixed-income trading dashboard using
get_fedwatch. - Build a settlement price monitor for Gold, Crude Oil, or E-mini S&P 500 futures using
get_settlementswith historical trade dates. - Scan near-the-money options chains for multiple expirations using
get_options_quotesandget_option_expirations. - Monitor daily futures and options open interest trends for a specific product using
get_volumeover a rolling window. - Discover all CME products in an asset class (e.g. agriculture) with their symbols via
get_product_catalog. - Build a contract spec reference tool that maps Globex codes to tick sizes and trading hours using
get_instrument_details. - Rank futures products by open interest within an asset class by combining
search_instrumentsresults withget_historical_quotesdata.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does CME Group offer an official developer API?+
What does `get_fedwatch` return and how do I filter by a specific FOMC meeting?+
target_rate_probabilities array showing probability percentages per rate range in basis points — including now, 1-day, 1-week, and 1-month columns. Pass the meeting_date parameter as a short-form string matching the format returned in the meeting_dates array (e.g. '28 Oct26') to scope the response to one meeting.How far back does historical data go in `get_historical_quotes`?+
start_date and end_date parameters can narrow the returned window, but cannot extend it beyond what is available. If you need deeper historical depth, you can fork this API on Parse and revise it to target a different CME data surface.Does the API cover CME cryptocurrency futures like Bitcoin or Ether?+
search_instruments endpoint accepts crypto as a product_type filter and will return CME-listed crypto futures instruments. However, the friendly-name shortcuts in get_futures_quotes and related endpoints do not include pre-set names for crypto products — you need to use the numeric product_id obtained from search_instruments. You can fork the API on Parse and revise it to add friendly-name aliases for BTC or ETH futures.Are quotes real-time or delayed?+
get_futures_quotes and get_options_quotes are delayed by 10 minutes, as indicated by the quote_delayed: true field in their responses. Settlement data from get_settlements reflects end-of-day official settlement prices rather than intraday prices.