# CME Group — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Get CME Group market data including FedWatch interest-rate probabilities, futures quotes and settlements, volume/open interest history, and options expirations and near-the-money option chains.

**Category:** Finance & Markets | **Website:** [cmegroup.com/](https://cmegroup.com/) | **Docs:** [parse.bot/marketplace/fa9a54e0-7b60-4524-8687-ea82d6e5ea83/cmegroup-com-api](https://parse.bot/marketplace/fa9a54e0-7b60-4524-8687-ea82d6e5ea83/cmegroup-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-cmegroup-com-api-fa9a54e0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_fedwatch

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `meeting_date` | string | No | 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. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cmegroup-com-api-fa9a54e0/get_fedwatch \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"meeting_date":"<string>"}'
```

### get_futures_quotes

Retrieves live futures quotes for any CME Group product. Returns all available contract months with prices (last, open, high, low, close), volume, change, percentage change, and trading limits. Data is delayed by 10 minutes. Accepts a numeric CME product ID or a supported friendly name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | No | Numeric CME product ID (e.g. '437') or a supported friendly name. Supported names: gold, silver, crude_oil, natural_gas, corn, soybeans, wheat, e_mini_sp500, euro_fx, yen, british_pound, 10y_treasury, 30y_treasury, fed_funds, sofr, micro_gold, copper, e_mini_nasdaq, e_mini_dow. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cmegroup-com-api-fa9a54e0/get_futures_quotes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### get_option_expirations

Retrieves all available option types and their expiration dates for a product. Returns American options, weekly options (Mon/Tue/Wed/Thu/Fri), and other option styles with their contract dates, last trade dates, and underlying futures. Use to discover valid expiration_month values for get_options_quotes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | No | Numeric CME product ID or supported friendly name (see get_futures_quotes for the full list of supported names). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cmegroup-com-api-fa9a54e0/get_option_expirations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### get_options_quotes

Retrieves options chain data (calls and puts) for any CME Group product at the nearest at-the-money strikes. Returns strike prices with call/put last, change, prior settle, volume, and more. Supports selecting specific expiration months. Use get_option_expirations to discover available expirations.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `expiration_month` | string | No | Expiration month label like 'Jun 2026' or underlying future code like 'GCM6'. Omitting selects the nearest expiration. |
| `product_id` | string | No | Numeric CME product ID or supported friendly name (see get_futures_quotes for the full list of supported names). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cmegroup-com-api-fa9a54e0/get_options_quotes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expiration_month":"<string>","product_id":"<string>"}'
```

### get_product_catalog

Retrieves the list of available products for a given asset class. Returns product codes, names, and page URLs organized by category. Useful for discovering product codes to use with other endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset_class` | string | No | Asset class identifier. Accepted values: metals, energy, agriculture, interest-rates, equity-index, fx. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cmegroup-com-api-fa9a54e0/get_product_catalog \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_class":"<string>"}'
```

### get_settlements

Retrieves futures settlement prices for any CME Group product. Returns open, high, low, last, settle price, estimated volume, and prior day open interest for all contract months. Optionally accepts a trade date; omitting returns the most recent settlement date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | No | Numeric CME product ID or supported friendly name (see get_futures_quotes for the full list of supported names). |
| `trade_date` | string | No | Trade date in MM/DD/YYYY format. Omitting returns the most recent settlement date. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cmegroup-com-api-fa9a54e0/get_settlements \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>","trade_date":"<string>"}'
```

### get_volume

Retrieves daily trading volume and open interest data for any CME Group product over a configurable number of days. Returns futures and options volume/OI separately for each trading day.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `days` | string | No | Number of days of data to retrieve. |
| `product_id` | string | No | Numeric CME product ID or supported friendly name (see get_futures_quotes for the full list of supported names). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cmegroup-com-api-fa9a54e0/get_volume \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"days":"<string>","product_id":"<string>"}'
```