Market · Status, sessions and calendar

Market holidays

Upcoming market closures and early closes.

GET/v1/market/holidaysmarketHolidays

On this page

Example request
Parameters
Response
Example response

Full closures and early closes of the US equity markets with the date, exchange and name; early closes carry the open and close times. Only upcoming dates are listed: a past year returns an empty list with meta.coverage.complete false.

Example request

curl -sS "https://api.ordermap.si/v1/market/holidays" \
  -H "Authorization: Bearer $ORDERMAP_API_KEY"

const res = await fetch("https://api.ordermap.si/v1/market/holidays", {
  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
`year`queryoptional	integermin 2000max 2100	Only holidays in this calendar year.

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
`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>required6 fields inside
- close_timeinteger | nullunix-msrequiredClosing time on an early-close day. Unix epoch milliseconds (UTC).
- datestringdaterequiredDate.
- exchangestringrequiredExchange, for example NYSE or NASDAQ.
- namestringrequiredHoliday name.
- open_timeinteger | nullunix-msrequiredOpening time on an early-close day. Unix epoch milliseconds (UTC).
- statusstringrequiredClosed all day or closing early.closedearly_close
metaobjectrequiredMeta object

Example response

{
  "data": [
    {
      "close_time": 1795802400000,
      "date": "2026-11-27",
      "exchange": "NYSE",
      "name": "Thanksgiving",
      "open_time": 1795789800000,
      "status": "early_close"
    }
  ],
  "meta": {
    "as_of": 1760659200123,
    "coverage": {
      "complete": true
    },
    "delay_ms": 0,
    "delayed": false,
    "request_id": "0199f0c2-5a1e-7c3b-9d4e-2b6f8a1c3d5e",
    "source": "derived"
  }
}

Values are illustrative. Missing values are null, never 0.