Skip to content

Market · Status, sessions and calendar

Market calendar

The equity market schedule of one date: open, early close or closed.
GET/v1/market/calendarmarketCalendar
On this page

Whether the US equity market is open on a date, closes early, or is closed (weekend or holiday), with the open and close times when it trades. Options on indexes and ETFs trade 15 minutes beyond the equity close; the overnight index session is described by /v1/options/sessions. The default is today.

Example request

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

Set ORDERMAP_API_KEY to your key. Replace the dates with a recent trading date.

Parameters

1 parameter, none required.

ParameterType and limitsDescription
datequeryoptionalstringdateCalendar date, YYYY-MM-DD; the default is today in New York.

Response

StatusMeaningBody
200Successful response.Schema below
400Invalid, unknown or repeated parameters, or an invalid cursor.Error object
401Missing or invalid API key.Error object
403The plan, dataset release or account state does not allow this request.Error object
429Rate limit, burst limit or cooldown; wait Retry-After seconds.Retry-AfterError object
500Internal error.Error object
503Data temporarily unavailable; retry after Retry-After seconds.Retry-AfterError object
504The request timed out.Error object

Authenticated responses carry the X-RateLimit-* headers (see rate limits); 429 and 503 add Retry-After.

200 response body

  • dataobjectrequiredThe schedule of one date.4 fields inside
    • close_timestampinteger | nullunix-msrequiredClosing time of the equity market. Unix epoch milliseconds (UTC).
    • datestringdaterequiredThe date asked for.
    • open_timestampinteger | nullunix-msrequiredOpening time of the equity market. Unix epoch milliseconds (UTC).
    • statusstringrequiredopen: a regular day; early_close: closes before 16:00 ET; closed: a weekend or holiday.openearly_closeclosed
  • metaobjectrequiredMeta object

Example response

{
  "data": {
    "date": "2026-11-27",
    "status": "early_close",
    "open_timestamp": 1795789800000,
    "close_timestamp": 1795802400000
  },
  "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.