Cme
The trade dates the settlement archive actually holds for a product, each
6 endpoints493 calls6/6 passing
Settlement Dates
GET
/v1/finance:cme/settlement-datespassing · 0.7s30m cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| productId | number | query | Exchange product id. Default 437 (COMEX Gold futures). |
Example response
{"project":"finance:cme", "data": {"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 },"timestamp":"2026-08-21T02:21:49Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Products
The exchange product catalog — this is where a productId comes from.
GET
/v1/finance:cme/productspassing · 11.9s6h cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| query | string | query | Match against product name, clearing code or Globex code (case-insensitive substring). |
| exch | enum | query | Exchange to keep. One of CBOT, CME, COMEX, NYMEX. |
| group | number | query | 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 | Subgroup id within the group. Under Metals: 31 Base, 33 Ferrous, 34 Other, 35 Precious, 56 Battery Metals. |
| cleared | enum | query | Instrument type to keep. One of Futures, Options, Cleared Swaps, Cleared Forwards, Indices. |
| venue | enum | query | Trading venue: 1 ClearPort, 2 Floor, 3 Globex. One of 1, 2, 3. |
| sortField | enum | query | Column to sort on. Default oi. One of oi, vol, name, exch, cleared. |
| sortAsc | enum | query | Sort ascending. Default false. One of true, false. |
| page | number | query | Page number, 1-based. Default 1. |
| limit | number | query | Rows per page. Default 50, max 500 — the upstream cap. |
Example response
{"project":"finance:cme", "data": {"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 } ],"query":"gold","total":54,"venue":null,"cleared":null,"dataset":"products","hasMore":true,"sortAsc":false,"nextPage":2,"provider":"cme","subGroup":null,"sortField":"oi" },"timestamp":"2026-08-21T02:21:49Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Settlements
Daily settlement report for one product and one trade date: open, high, low,
GET
/v1/finance:cme/settlementspassing · 0.8s30m cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| productId | number | query | Exchange product id. Default 437 (COMEX Gold futures). |
| tradeDate | string | query | 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. |
Example response
{"project":"finance:cme", "data": {"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" },"timestamp":"2026-08-21T02:21:49Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Volume Oi
Daily volume and open interest for one product, split by execution venue —
GET
/v1/finance:cme/volume-oipassing · 0.7s30m cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| productId | number | query | Exchange product id. Default 437 (COMEX Gold futures). |
| tradeDate | string | query | Session to read, YYYY-MM-DD or YYYYMMDD. Default the newest session with a published settlement. |
Example response
{"project":"finance:cme", "data": {"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" },"timestamp":"2026-08-21T02:21:49Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Quotes
COMEX/CME futures quotes, one row per listed contract month.
GET
/v1/finance:cme/quotespassing · 0.6s1m cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| productId | number | query | Exchange product id. Default 437 (COMEX Gold futures). Look ids up with the products endpoint. |
Example response
{"project":"finance:cme", "data": {"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 } ],"dataset":"quotes","provider":"cme","productId":437,"tradeDate":"21 Aug 2026","quoteDelay":"10 minutes","productName":"Gold Futures","quoteDelayed":true },"timestamp":"2026-08-21T02:21:49Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Calendar
The listed contract months for a product and every date that matters for each:
GET
/v1/finance:cme/calendarpassing · 0.1s1d cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| productId | number | query | Exchange product id. Default 437 (COMEX Gold futures). |
Example response
{"project":"finance:cme", "data": {"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" } ],"dataset":"calendar","provider":"cme","productId":437 },"timestamp":"2026-08-21T02:21:49Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "finance:cme", "settlement-dates", { productId: 437 });
Cme
The trade dates the settlement archive actually holds for a product, each
6 endpoints493 calls6/6 passing
GET
/v1/…cme/settlement-datespassing · 0.7s30m cache
Try it
Parameters
productId
number · query · optional
Exchange product id. Default 437 (COMEX Gold futures).
Example response
{"project":"finance:cme", "data": {"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 },"timestamp":"2026-08-21T02:21:49Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "finance:cme", "settlement-dates", { productId: 437 });