CLclear-street
Calendar

Get Market Hours Calendar.

Changed on

Retrieves comprehensive trading hours including pre-market, regular, and after-hours sessions. Returns market status, session times, and next session schedules.

get/v1/calendars/market-hours

Request

  • Base URL
    https://api.clearstreet.com
  • Auth
    HTTP bearer

Query parameters

datestring

The date to query market hours for (YYYY-MM-DD). Defaults to today.

market'us_equities' | 'us_options' | 'us_event_contracts'

Market type for market hours calendar endpoint

Market type to query (us_equities, us_options, us_event_contracts). If omitted, returns us_equities and us_options.

Response

Market hours calendar

Example response

{
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero"
  },
  "metadata": {
    "page_number": 1,
    "total_items": 42,
    "total_pages": 5
  },
  "data": [
    {
      "current_time": "2025-10-15T14:30:00-04:00",
      "date": "2025-10-15",
      "market": "us_equities",
      "market_name": "US Equities",
      "next_sessions": {
        "after_hours": {
          "close": "2025-10-16T20:00:00-04:00",
          "open": "2025-10-16T16:00:00-04:00"
        },
        "overnight": {
          "close": "2025-10-16T04:00:00-04:00",
          "open": "2025-10-15T20:00:00-04:00"
        },
        "pre_market": {
          "close": "2025-10-16T09:30:00-04:00",
          "open": "2025-10-16T04:00:00-04:00"
        },
        "regular": {
          "close": "2025-10-16T16:00:00-04:00",
          "open": "2025-10-16T09:30:00-04:00"
        }
      },
      "status": {
        "current_session": "regular",
        "day_type": "TRADING_DAY",
        "is_open": true
      },
      "timezone": "America/New_York",
      "today_sessions": {
        "after_hours": {
          "close": "2025-10-15T20:00:00-04:00",
          "open": "2025-10-15T16:00:00-04:00",
          "time_until_open": "PT1H30M"
        },
        "overnight": {
          "close": "2025-10-15T04:00:00-04:00",
          "open": "2025-10-14T20:00:00-04:00"
        },
        "pre_market": {
          "close": "2025-10-15T09:30:00-04:00",
          "open": "2025-10-15T04:00:00-04:00"
        },
        "regular": {
          "close": "2025-10-15T16:00:00-04:00",
          "open": "2025-10-15T09:30:00-04:00",
          "time_until_close": "PT1H30M"
        }
      }
    }
  ]
}

Changes

  • 49c5c6b23633Revision changes
    • warning

      added the new us_event_contracts enum value to the /// response property for the response status

    • info

      added the new enum value us_event_contracts to the query request parameter market

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

  • 1bd9eddeffc8Revision changes
    • warning

      added the new overnight enum value to the //////// response property for the response status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status