Futures · Products and sessions
Futures products
/v1/futures/productsfuturesProductsThe products catalog: every supported futures root with its listing exchange, tick size, point value (US dollars per one price point), quote unit, price precision and trading hours. status tells how the product is served now: active (the front contract is resolved and captured), available (activated on first use) or unavailable (outside the current data entitlement, or its feed is down). front_contract is the dated front month once it is resolved. Products whose tick depends on the contract (tick_rule contract_dependent) carry the rule in tick_notes.
Example request
curl -sS "https://api.ordermap.si/v1/futures/products" \
-H "Authorization: Bearer $ORDERMAP_API_KEY"const res = await fetch("https://api.ordermap.si/v1/futures/products", {
headers: { Authorization: `Bearer ${process.env.ORDERMAP_API_KEY}` },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { data, meta } = await res.json();
console.log(data, meta.coverage);Set ORDERMAP_API_KEY to your key. Replace the dates with a recent trading date.
Parameters
1 parameter, none required.
| Parameter | Type and limits | Description |
|---|---|---|
exchangequeryoptional | stringcmecbotnymexcomex | Only products listed on this exchange. |
Response
| Status | Meaning | Body |
|---|---|---|
200 | Successful response. | Schema below |
400 | Invalid, unknown or repeated parameters, or an invalid cursor. | Error object |
401 | Missing or invalid API key. | Error object |
403 | The plan, dataset release or account state does not allow this request. | Error object |
422 | The request is valid but no data exists for it. | Error object |
429 | Rate limit, burst limit or cooldown; wait Retry-After seconds.Retry-After | Error object |
500 | Internal error. | Error object |
503 | Data temporarily unavailable; retry after Retry-After seconds.Retry-After | Error object |
504 | The request timed out. | Error object |
Authenticated responses carry the X-RateLimit-* headers (see rate limits); 429 and 503 add Retry-After.
200 response body
dataarray<object>required14 fields insidecategorystringrequiredProduct category: equity_index, metals, energy, fx, interest_rates, agriculture, livestock or cryptocurrency.currencystringrequiredCurrency of point_value.exchangestringrequiredListing exchange.cmecbotnymexcomexfront_contractstring | nullrequiredDated front month, null until resolved.namestringrequiredProduct name.point_valuenumberrequiredUS dollars per one price point.price_precisionintegerrequiredDecimal places of a quoted price.quote_unitstringrequiredWhat the price is quoted in, for example index points.statusstringrequiredHow the product is served now.activeavailableunavailablesymbolstringrequiredProduct root, for example ES.tick_notesstring | nullrequiredHow a contract-dependent tick is determined.tick_rulestringrequiredfixed: one tick size for every contract; contract_dependent: the tradable increment depends on the contract.fixedcontract_dependenttick_sizenumberrequiredMinimum price increment of the canonical price unit.trading_hoursstringrequiredConfigured weekly trading pattern (Eastern Time).
metaobjectrequiredMeta object
Example response
{
"data": [
{
"category": "equity_index",
"currency": "USD",
"exchange": "cme",
"front_contract": "ESZ6",
"name": "E-Mini S&P 500",
"point_value": 50,
"price_precision": 2,
"quote_unit": "index points",
"status": "active",
"symbol": "ES",
"tick_notes": null,
"tick_rule": "fixed",
"tick_size": 0.25,
"trading_hours": "Sunday 18:00 to Friday 17:00 ET, with a daily break from 17:00 to 18:00 ET"
}
],
"meta": {
"as_of": 1760659200123,
"coverage": {
"complete": true
},
"delay_ms": 0,
"delayed": false,
"request_id": "0199f0c2-5a1e-7c3b-9d4e-2b6f8a1c3d5e",
"source": "cme"
}
}Values are illustrative. Missing values are null, never 0.