# Cme — Zapi reference

> The trade dates the settlement archive actually holds for a product, each

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ content, message, errors }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/finance/cme
- Endpoint catalog: https://zpi.web.id/category/finance
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## Cme

**Category:** finance · **Slug:** `cme`
**Detail page:** https://zpi.web.id/api/finance/cme

The trade dates the settlement archive actually holds for a product, each

**Tags:** finance, cme

### Settlement Dates

The trade dates the settlement archive actually holds for a product, each

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:cme/settlement-dates`
- **Cache TTL:** 1800s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `productId` | number | query | no | Exchange product id. Default 437 (COMEX Gold futures) |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:cme/settlement-dates?productId=437" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:cme/settlement-dates?productId=437", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:cme/settlement-dates?productId=437",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 5,
  "items": [
    {
      "date": "2026-08-19",
      "tradeDate": "08/19/2026",
      "reportType": "Final"
    },
    {
      "date": "2026-08-18",
      "tradeDate": "08/18/2026",
      "reportType": "Final"
    },
    {
      "date": "2026-08-17",
      "tradeDate": "08/17/2026",
      "reportType": "Final"
    },
    {
      "date": "2026-08-14",
      "tradeDate": "08/14/2026",
      "reportType": "Final"
    },
    {
      "date": "2026-08-13",
      "tradeDate": "08/13/2026",
      "reportType": "Final"
    }
  ],
  "dataset": "settlement-dates",
  "provider": "cme",
  "productId": 437
}
```

---

### Products

The exchange product catalog — this is where a productId comes from.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:cme/products`
- **Cache TTL:** 21600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | no | Match against product name, clearing code or Globex code (case-insensitive substring) |
| `exch` | enum(CBOT|CME|COMEX|NYMEX) | query | no | Exchange to keep |
| `group` | number | query | no | Product group id: 1 Interest Rate, 2 Agriculture, 3 FX, 4 Equities, 5 Weather, 7 Energy, 8 Metals, 11 Real Estate, 16 Cryptocurrencies |
| `subGroup` | number | query | no | Subgroup id within the group. Under Metals: 31 Base, 33 Ferrous, 34 Other, 35 Precious, 56 Battery Metals |
| `cleared` | enum(Futures|Options|Cleared Swaps|Cleared Forwards|Indices) | query | no | Instrument type to keep |
| `venue` | enum(1|2|3) | query | no | Trading venue: 1 ClearPort, 2 Floor, 3 Globex |
| `sortField` | enum(oi|vol|name|exch|cleared) | query | no | Column to sort on. Default oi |
| `sortAsc` | enum(true|false) | query | no | Sort ascending. Default false |
| `page` | number | query | no | Page number, 1-based. Default 1 |
| `limit` | number | query | no | Rows per page. Default 50, max 500 — the upstream cap |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:cme/products?query=gold&exch=COMEX&group=8&subGroup=35&cleared=Futures&venue=3&sortField=oi&sortAsc=false&page=1&limit=50" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:cme/products?query=gold&exch=COMEX&group=8&subGroup=35&cleared=Futures&venue=3&sortField=oi&sortAsc=false&page=1&limit=50", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:cme/products?query=gold&exch=COMEX&group=8&subGroup=35&cleared=Futures&venue=3&sortField=oi&sortAsc=false&page=1&limit=50",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "exch": null,
  "page": 1,
  "count": 50,
  "group": null,
  "items": [
    {
      "url": "/markets/metals/precious/gold_contractSpecs_options.html?optionProductId=192",
      "name": "Gold Option",
      "group": "Metals",
      "venues": "Globex ClearPort",
      "volume": 102100,
      "cleared": "Options",
      "groupId": 8,
      "exchange": "COMEX",
      "subGroup": "Precious",
      "floorCode": null,
      "productId": 192,
      "globexCode": "OG",
      "subGroupId": 35,
      "floorTraded": false,
      "floorVolume": 0,
      "clearingCode": "OG",
      "globexTraded": true,
      "globexVolume": 92108,
      "openInterest": 840892,
      "clearPortVolume": 9992
    },
    {
      "url": "/markets/metals/precious/gold_contract_specifications.html",
      "name": "Gold Futures",
      "group": "Metals",
      "venues": "Globex ClearPort",
      "volume": 303458,
      "cleared": "Futures",
      "groupId": 8,
      "exchange": "COMEX",
      "subGroup": "Precious",
      "floorCode": null,
      "productId": 437,
      "globexCode": "GC",
      "subGroupId": 35,
      "floorTraded": false,
      "floorVolume": 0,
      "clearingCode": "GC",
      "globexTraded": true,
      "globexVolume": 296042,
      "openInterest": 420408,
      "clearPortVolume": 7416
    },
    {
      "url": "/markets/metals/precious/e-micro-gold_contract_specifications.html",
      "name": "Micro Gold Futures",
      "group": "Metals",
      "venues": "Globex ClearPort",
      "volume": 392384,
      "cleared": "Futures",
      "groupId": 8,
      "exchange": "COMEX",
      "subGroup": "Precious",
      "floorCode": null,
      "productId": 5224,
      "globexCode": "MGC",
      "subGroupId": 35,
      "floorTraded": false,
      "floorVolume": 0,
      "clearingCode": "MGC",
      "globexTraded": true,
      "globexVolume": 392384,
      "openInterest": 66327,
      "clearPortVolume": 0
    },
    {
      "url": "/markets/metals/precious/1-ounce-gold_contract_specifications.html",
      "name": "1-Ounce Gold Futures",
      "group": "Metals",
      "venues": "Globex",
      "volume": 96023,
      "cleared": "Futures",
      "groupId": 8,
      "exchange": "COMEX",
      "subGroup": "Precious",
      "floorCode": null,
      "productId": 10907,
      "globexCode": "1OZ",
      "subGroupId": 35,
      "floorTraded": false,
      "floorVolume": 0,
      "clearingCode": "1OZ",
      "globexTraded": true,
      "globexVolume": 96023,
      "openInterest": 50465,
      "clearPortVolume": 0
    },
    {
      "url": "/markets/metals/precious/gold_contractSpecs_options.html?optionProductId=7490",
      "name": "Gold Weekly Friday Option - Week 3",
      "group": "Metals",
      "venues": "Globex ClearPort",
      "volume": 7299,
      "cleared": "Options",
      "groupId": 8,
      "exchange": "COMEX",
      "subGroup": "Precious",
      "floorCode": null,
      "productId": 7490,
      "globexCode": "OG3",
      "subGroupId": 35,
      "floorTraded": false,
      "floorVolume": 0,
      "clearingCode": "OG3",
      "globexTraded": true,
      "globexVolume": 6999,
      "openInterest": 9903,
      "clearPortVolume": 300
    },
    {
      "url": "/markets/metals/precious/e-mini-gold_contract_specifications.html",
      "name": "E-mini Gold Futures",
      "group": "Metals",
      "venues": "Globex ClearPort",
      "volume": 4965,
      "cleared": "Futures",
      "groupId": 8,
      "exchange": "COMEX",
      "subGroup": "Precious",
      "floorCode": null,
      "productId": 454,
      "globexCode": "QO",
      "subGroupId": 35,
      "floorTraded": false,
      "floorVolume": 0,
      "clearingCode": "QO",
      "globexTraded": true,
      "globexVolume": 4165,
      "openInterest": 7486,
      "clearPortVolume": 800
    },
    {
      "url": "/markets/metals/precious/gold_contractSpecs_options.html?optionProductId=10628",
      "name": "Gold Weekly Thursday Option - Week 3",
      "group": "Metals",
      "venues": "Globex ClearPort",
      "volume": 4987,
      "cleared": "Options",
      "groupId": 8,
      "exchange": "COMEX",
      "subGroup": "Precious",
      "floorCode": null,
      "productId": 10628,
      "globexCode": "G3R",
      "subGroupId": 35,
      "floorTraded": false,
      "floorVolume": 0,
      "clearingCode": "G3R",
      "globexTraded": true,
      "globexVolume": 4987,
      "openInterest": 5062,
      "clearPortVolume": 0
    },
    {
      "url": "/markets/metals/precious/gold_contractSpecs_options.html?optionProductId=7491",
      "name": "Gold Weekly Friday Option - Week 4",
      "group": "Metals",
      "venues": "Globex ClearPort",
      "volume": 1785,
      "cleared": "Options",
      "groupId": 8,
      "exchange": "COMEX",
      "subGroup": "Precious",
      "floorCode": null,
      "productId": 7491,
      "globexCode": "OG4",
      "subGroupId": 35,
      "floorTraded": false,
      "floorVolume": 0,
      "clearingCode": "OG4",
      "globexTraded": true,
      "globexVolume": 1685,
      "openInterest": 4626,
      "clearPortVolume": 100
    }
  ],
  "query": "gold",
  "total": 54,
  "venue": null,
  "cleared": null,
  "dataset": "products",
  "hasMore": true,
  "sortAsc": false,
  "nextPage": 2,
  "provider": "cme",
  "subGroup": null,
  "sortField": "oi"
}
```

---

### Settlements

Daily settlement report for one product and one trade date: open, high, low,

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:cme/settlements`
- **Cache TTL:** 1800s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `productId` | number | query | no | Exchange product id. Default 437 (COMEX Gold futures) |
| `tradeDate` | string | query | no | Session to read, YYYY-MM-DD or MM/DD/YYYY. Default the newest published session. Only the last few sessions exist — list them with settlement-dates |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:cme/settlements?productId=437&tradeDate=2026-08-19" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:cme/settlements?productId=437&tradeDate=2026-08-19", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:cme/settlements?productId=437&tradeDate=2026-08-19",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 34,
  "items": [
    {
      "low": 4327.6,
      "high": 4524.1,
      "last": 4524.1,
      "open": 4339.8,
      "month": "AUG 26",
      "change": 123.4,
      "settle": 4489.4,
      "volume": 1336,
      "openInterest": 1119,
      "lastQualifier": "A"
    },
    {
      "low": null,
      "high": 4530.7,
      "last": 4530.7,
      "open": 4343,
      "month": "SEP 26",
      "change": 122.9,
      "settle": 4495.1,
      "volume": 5968,
      "openInterest": 5753,
      "lastQualifier": "B"
    },
    {
      "low": 4345.8,
      "high": 4548.6,
      "last": 4546.8,
      "open": 4356.4,
      "month": "OCT 26",
      "change": 123.5,
      "settle": 4511.3,
      "volume": 32932,
      "openInterest": 52856,
      "lastQualifier": "A"
    },
    {
      "low": 4365.7,
      "high": 4564.9,
      "last": 4564.9,
      "open": 4370.6,
      "month": "NOV 26",
      "change": 124.1,
      "settle": 4529.1,
      "volume": 212,
      "openInterest": 628,
      "lastQualifier": "B"
    },
    {
      "low": 4378,
      "high": 4582.8,
      "last": 4580.7,
      "open": 4391.4,
      "month": "DEC 26",
      "change": 124.7,
      "settle": 4545.3,
      "volume": 250482,
      "openInterest": 312507,
      "lastQualifier": null
    },
    {
      "low": 4477,
      "high": 4581.1,
      "last": 4581.1,
      "open": 4477,
      "month": "JAN 27",
      "change": 125.3,
      "settle": 4565.1,
      "volume": 69,
      "openInterest": 458,
      "lastQualifier": "A"
    },
    {
      "low": 4412.8,
      "high": null,
      "last": 4617.5,
      "open": 4428.7,
      "month": "FEB 27",
      "change": 125.8,
      "settle": 4581.2,
      "volume": 8271,
      "openInterest": 21076,
      "lastQualifier": "B"
    },
    {
      "low": 4550,
      "high": 4594.7,
      "last": 4594.7,
      "open": 4550,
      "month": "MAR 27",
      "change": 126.3,
      "settle": 4597.2,
      "volume": 4,
      "openInterest": 28,
      "lastQualifier": "B"
    }
  ],
  "totals": {
    "volume": 303458,
    "openInterest": 406260
  },
  "dataset": "settlements",
  "provider": "cme",
  "productId": 437,
  "tradeDate": "2026-08-19",
  "reportType": "Final",
  "updateTime": "Wednesday, 19 Aug 2026 11:55 PM"
}
```

---

### Volume Oi

Daily volume and open interest for one product, split by execution venue —

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:cme/volume-oi`
- **Cache TTL:** 1800s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `productId` | number | query | no | Exchange product id. Default 437 (COMEX Gold futures) |
| `tradeDate` | string | query | no | Session to read, YYYY-MM-DD or YYYYMMDD. Default the newest session with a published settlement |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:cme/volume-oi?productId=437&tradeDate=2026-08-19" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:cme/volume-oi?productId=437&tradeDate=2026-08-19", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:cme/volume-oi?productId=437&tradeDate=2026-08-19",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 28,
  "items": [
    {
      "month": "AUG 2026",
      "change": -745,
      "efpVol": 0,
      "efrVol": 0,
      "efsVol": 0,
      "eooVol": 0,
      "globex": 1336,
      "pntVol": 0,
      "subVol": 0,
      "tasVol": 0,
      "atClose": 374,
      "exercises": 0,
      "deliveries": 184,
      "openOutcry": 0,
      "blockVolume": 0,
      "totalVolume": 1336
    },
    {
      "month": "SEP 2026",
      "change": -1339,
      "efpVol": 0,
      "efrVol": 0,
      "efsVol": 0,
      "eooVol": 0,
      "globex": 5968,
      "pntVol": 0,
      "subVol": 0,
      "tasVol": 0,
      "atClose": 4414,
      "exercises": 0,
      "deliveries": 0,
      "openOutcry": 0,
      "blockVolume": 0,
      "totalVolume": 5968
    },
    {
      "month": "OCT 2026",
      "change": 1186,
      "efpVol": 500,
      "efrVol": 0,
      "efsVol": 0,
      "eooVol": 0,
      "globex": 32326,
      "pntVol": 606,
      "subVol": 0,
      "tasVol": 7,
      "atClose": 54042,
      "exercises": 0,
      "deliveries": 0,
      "openOutcry": 0,
      "blockVolume": 106,
      "totalVolume": 32932
    },
    {
      "month": "NOV 2026",
      "change": 1,
      "efpVol": 0,
      "efrVol": 0,
      "efsVol": 0,
      "eooVol": 0,
      "globex": 212,
      "pntVol": 0,
      "subVol": 0,
      "tasVol": 0,
      "atClose": 629,
      "exercises": 0,
      "deliveries": 0,
      "openOutcry": 0,
      "blockVolume": 0,
      "totalVolume": 212
    },
    {
      "month": "DEC 2026",
      "change": 14888,
      "efpVol": 6325,
      "efrVol": 0,
      "efsVol": 0,
      "eooVol": 0,
      "globex": 243873,
      "pntVol": 6609,
      "subVol": 0,
      "tasVol": 980,
      "atClose": 327395,
      "exercises": 0,
      "deliveries": 0,
      "openOutcry": 0,
      "blockVolume": 284,
      "totalVolume": 250482
    },
    {
      "month": "JAN 2027",
      "change": 3,
      "efpVol": 0,
      "efrVol": 0,
      "efsVol": 0,
      "eooVol": 0,
      "globex": 69,
      "pntVol": 0,
      "subVol": 0,
      "tasVol": 0,
      "atClose": 461,
      "exercises": 0,
      "deliveries": 0,
      "openOutcry": 0,
      "blockVolume": 0,
      "totalVolume": 69
    },
    {
      "month": "FEB 2027",
      "change": 1116,
      "efpVol": 0,
      "efrVol": 0,
      "efsVol": 0,
      "eooVol": 0,
      "globex": 8264,
      "pntVol": 7,
      "subVol": 0,
      "tasVol": 86,
      "atClose": 22192,
      "exercises": 0,
      "deliveries": 0,
      "openOutcry": 0,
      "blockVolume": 7,
      "totalVolume": 8271
    },
    {
      "month": "MAR 2027",
      "change": 1,
      "efpVol": 0,
      "efrVol": 0,
      "efsVol": 0,
      "eooVol": 0,
      "globex": 4,
      "pntVol": 0,
      "subVol": 0,
      "tasVol": 0,
      "atClose": 29,
      "exercises": 0,
      "deliveries": 0,
      "openOutcry": 0,
      "blockVolume": 0,
      "totalVolume": 4
    }
  ],
  "totals": {
    "change": 15461,
    "efpVol": 6825,
    "efrVol": 0,
    "efsVol": 0,
    "eooVol": 0,
    "globex": 296042,
    "pntVol": 7416,
    "subVol": 0,
    "tasVol": 1108,
    "atClose": 421721,
    "exercises": 0,
    "deliveries": 184,
    "openOutcry": 0,
    "blockVolume": 591,
    "totalVolume": 303458
  },
  "dataset": "volume-oi",
  "provider": "cme",
  "productId": 437,
  "tradeDate": "2026-08-19",
  "updateTime": "2026-08-20T05:20:07.000Z"
}
```

---

### Quotes

COMEX/CME futures quotes, one row per listed contract month.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:cme/quotes`
- **Cache TTL:** 60s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `productId` | number | query | no | Exchange product id. Default 437 (COMEX Gold futures). Look ids up with the products endpoint |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:cme/quotes?productId=437" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:cme/quotes?productId=437", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:cme/quotes?productId=437",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 35,
  "items": [
    {
      "low": null,
      "code": "GCQ6",
      "high": null,
      "last": null,
      "open": null,
      "close": null,
      "month": "AUG 2026",
      "change": null,
      "volume": 0,
      "updated": "2026-08-21T00:31:15.640Z",
      "priorSettle": null,
      "productCode": "GC",
      "exchangeCode": "XCEC",
      "isFrontMonth": false,
      "lastQualifier": null,
      "lastTradeDate": "2026-08-27T05:00:00Z",
      "notionalValue": null,
      "expirationDate": "2026-08-01",
      "percentageChange": null
    },
    {
      "low": 4517.4,
      "code": "GCU6",
      "high": 4549,
      "last": 4525.1,
      "open": 4526.9,
      "close": null,
      "month": "SEP 2026",
      "change": 4.4,
      "volume": 1106,
      "updated": "2026-08-21T02:12:19.425Z",
      "priorSettle": null,
      "productCode": "GC",
      "exchangeCode": "XCEC",
      "isFrontMonth": false,
      "lastQualifier": null,
      "lastTradeDate": "2026-09-28T05:00:00Z",
      "notionalValue": 452510,
      "expirationDate": "2026-09-01",
      "percentageChange": 0.1
    },
    {
      "low": 4531.9,
      "code": "GCV6",
      "high": 4565.5,
      "last": 4540,
      "open": 4543.3,
      "close": null,
      "month": "OCT 2026",
      "change": 2.9,
      "volume": 1907,
      "updated": "2026-08-21T02:12:58.125Z",
      "priorSettle": null,
      "productCode": "GC",
      "exchangeCode": "XCEC",
      "isFrontMonth": true,
      "lastQualifier": null,
      "lastTradeDate": "2026-10-28T05:00:00Z",
      "notionalValue": 454000,
      "expirationDate": "2026-10-01",
      "percentageChange": 0.06
    },
    {
      "low": 4571.3,
      "code": "GCX6",
      "high": 4571.3,
      "last": 4571.3,
      "open": 4571.3,
      "close": null,
      "month": "NOV 2026",
      "change": 16.1,
      "volume": 6,
      "updated": "2026-08-21T02:10:45.161Z",
      "priorSettle": null,
      "productCode": "GC",
      "exchangeCode": "XCEC",
      "isFrontMonth": false,
      "lastQualifier": null,
      "lastTradeDate": "2026-11-25T06:00:00Z",
      "notionalValue": 457130,
      "expirationDate": "2026-11-01",
      "percentageChange": 0.35
    },
    {
      "low": 4565.5,
      "code": "GCZ6",
      "high": 4600.3,
      "last": 4574,
      "open": 4577,
      "close": null,
      "month": "DEC 2026",
      "change": 2.6,
      "volume": 18058,
      "updated": "2026-08-21T02:12:59.202Z",
      "priorSettle": null,
      "productCode": "GC",
      "exchangeCode": "XCEC",
      "isFrontMonth": false,
      "lastQualifier": null,
      "lastTradeDate": "2026-12-29T06:00:00Z",
      "notionalValue": 457400,
      "expirationDate": "2026-12-01",
      "percentageChange": 0.06
    },
    {
      "low": null,
      "code": "GCF7",
      "high": null,
      "last": null,
      "open": null,
      "close": null,
      "month": "JAN 2027",
      "change": null,
      "volume": 4,
      "updated": "2026-08-21T02:12:14.043Z",
      "priorSettle": null,
      "productCode": "GC",
      "exchangeCode": "XCEC",
      "isFrontMonth": false,
      "lastQualifier": null,
      "lastTradeDate": "2027-01-27T06:00:00Z",
      "notionalValue": null,
      "expirationDate": "2027-01-01",
      "percentageChange": null
    },
    {
      "low": 4602,
      "code": "GCG7",
      "high": 4634.7,
      "last": 4611.3,
      "open": 4613.9,
      "close": null,
      "month": "FEB 2027",
      "change": 4.5,
      "volume": 377,
      "updated": "2026-08-21T02:12:58.124Z",
      "priorSettle": null,
      "productCode": "GC",
      "exchangeCode": "XCEC",
      "isFrontMonth": false,
      "lastQualifier": null,
      "lastTradeDate": "2027-02-24T06:00:00Z",
      "notionalValue": 461130,
      "expirationDate": "2027-02-01",
      "percentageChange": 0.1
    },
    {
      "low": null,
      "code": "GCH7",
      "high": null,
      "last": null,
      "open": null,
      "close": null,
      "month": "MAR 2027",
      "change": null,
      "volume": 3,
      "updated": "2026-08-21T02:12:14.057Z",
      "priorSettle": null,
      "productCode": "GC",
      "exchangeCode": "XCEC",
      "isFrontMonth": false,
      "lastQualifier": null,
      "lastTradeDate": "2027-03-29T05:00:00Z",
      "notionalValue": null,
      "expirationDate": "2027-03-01",
      "percentageChange": null
    }
  ],
  "dataset": "quotes",
  "provider": "cme",
  "productId": 437,
  "tradeDate": "21 Aug 2026",
  "quoteDelay": "10 minutes",
  "productName": "Gold Futures",
  "quoteDelayed": true
}
```

---

### Calendar

The listed contract months for a product and every date that matters for each:

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:cme/calendar`
- **Cache TTL:** 86400s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `productId` | number | query | no | Exchange product id. Default 437 (COMEX Gold futures) |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:cme/calendar?productId=437" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:cme/calendar?productId=437", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:cme/calendar?productId=437",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 35,
  "items": [
    {
      "lastTrade": "2026-08-27",
      "expiration": "2026-08-01",
      "firstTrade": "2024-09-30",
      "lastNotice": "2026-08-28",
      "settlement": "2026-08-27",
      "firstNotice": "2026-07-31",
      "lastHolding": null,
      "productCode": "GCQ26",
      "firstHolding": null,
      "lastDelivery": "2026-08-31",
      "lastPosition": "2026-08-28",
      "contractMonth": "Aug 2026",
      "firstDelivery": "2026-08-03",
      "firstPosition": "2026-07-30",
      "expirationTime": "August 01, 2026 12:00:00 AM CDT"
    },
    {
      "lastTrade": "2026-09-28",
      "expiration": "2026-09-01",
      "firstTrade": "2025-02-10",
      "lastNotice": "2026-09-29",
      "settlement": "2026-09-28",
      "firstNotice": "2026-08-31",
      "lastHolding": null,
      "productCode": "GCU26",
      "firstHolding": null,
      "lastDelivery": "2026-09-30",
      "lastPosition": "2026-09-29",
      "contractMonth": "Sep 2026",
      "firstDelivery": "2026-09-01",
      "firstPosition": "2026-08-28",
      "expirationTime": "September 01, 2026 12:00:00 AM CDT"
    },
    {
      "lastTrade": "2026-10-28",
      "expiration": "2026-10-01",
      "firstTrade": "2024-11-29",
      "lastNotice": "2026-10-29",
      "settlement": "2026-10-28",
      "firstNotice": "2026-09-30",
      "lastHolding": null,
      "productCode": "GCV26",
      "firstHolding": null,
      "lastDelivery": "2026-10-30",
      "lastPosition": "2026-10-29",
      "contractMonth": "Oct 2026",
      "firstDelivery": "2026-10-01",
      "firstPosition": "2026-09-29",
      "expirationTime": "October 01, 2026 12:00:00 AM CDT"
    },
    {
      "lastTrade": "2026-11-25",
      "expiration": "2026-11-01",
      "firstTrade": "2025-02-10",
      "lastNotice": "2026-11-27",
      "settlement": "2026-11-25",
      "firstNotice": "2026-10-30",
      "lastHolding": null,
      "productCode": "GCX26",
      "firstHolding": null,
      "lastDelivery": "2026-11-30",
      "lastPosition": "2026-11-27",
      "contractMonth": "Nov 2026",
      "firstDelivery": "2026-11-02",
      "firstPosition": "2026-10-29",
      "expirationTime": "November 01, 2026 12:00:00 AM CDT"
    },
    {
      "lastTrade": "2026-12-29",
      "expiration": "2026-12-01",
      "firstTrade": "2020-12-31",
      "lastNotice": "2026-12-30",
      "settlement": "2026-12-29",
      "firstNotice": "2026-11-30",
      "lastHolding": null,
      "productCode": "GCZ26",
      "firstHolding": null,
      "lastDelivery": "2026-12-31",
      "lastPosition": "2026-12-30",
      "contractMonth": "Dec 2026",
      "firstDelivery": "2026-12-01",
      "firstPosition": "2026-11-27",
      "expirationTime": "December 01, 2026 12:00:00 AM CST"
    },
    {
      "lastTrade": "2027-01-27",
      "expiration": "2027-01-01",
      "firstTrade": "2025-02-10",
      "lastNotice": "2027-01-28",
      "settlement": "2027-01-27",
      "firstNotice": "2026-12-31",
      "lastHolding": null,
      "productCode": "GCF27",
      "firstHolding": null,
      "lastDelivery": "2027-01-29",
      "lastPosition": "2027-01-28",
      "contractMonth": "Jan 2027",
      "firstDelivery": "2027-01-04",
      "firstPosition": "2026-12-30",
      "expirationTime": "January 01, 2027 12:00:00 AM CST"
    },
    {
      "lastTrade": "2027-02-24",
      "expiration": "2027-02-01",
      "firstTrade": "2025-02-28",
      "lastNotice": "2027-02-25",
      "settlement": "2027-02-24",
      "firstNotice": "2027-01-29",
      "lastHolding": null,
      "productCode": "GCG27",
      "firstHolding": null,
      "lastDelivery": "2027-02-26",
      "lastPosition": "2027-02-25",
      "contractMonth": "Feb 2027",
      "firstDelivery": "2027-02-01",
      "firstPosition": "2027-01-28",
      "expirationTime": "February 01, 2027 12:00:00 AM CST"
    },
    {
      "lastTrade": "2027-03-29",
      "expiration": "2027-03-01",
      "firstTrade": "2025-03-28",
      "lastNotice": "2027-03-30",
      "settlement": "2027-03-29",
      "firstNotice": "2027-02-26",
      "lastHolding": null,
      "productCode": "GCH27",
      "firstHolding": null,
      "lastDelivery": "2027-03-31",
      "lastPosition": "2027-03-30",
      "contractMonth": "Mar 2027",
      "firstDelivery": "2027-03-01",
      "firstPosition": "2027-02-25",
      "expirationTime": "March 01, 2027 12:00:00 AM CST"
    }
  ],
  "dataset": "calendar",
  "provider": "cme",
  "productId": 437
}
```

---


_Generated: 2026-08-21T07:38:55.067Z_