Skip to content
Clear Street Clear Street
Get started
API Reference
V1
Calendar

Get Market Hours Calendar.

v1.calendar.get_market_hours_calendar(CalendarGetMarketHoursCalendarParams**kwargs) -> CalendarGetMarketHoursCalendarResponse
GET/v1/calendars/market-hours

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

ParametersExpand Collapse
date: str

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

market: Optional[MarketType]

Market type to query (us_equities, us_options). If omitted, returns all markets.

One of the following:
"us_equities"
"us_options"
ReturnsExpand Collapse
class CalendarGetMarketHoursCalendarResponse: …
current_time: datetime

Current time in market timezone with offset

formatdate-time
date: date

The date for which market hours are provided

formatdate
market: MarketType

Market type identifier

One of the following:
"us_equities"
"us_options"
market_name: str

Human-readable market name

next_sessions: TradingSessions

Next trading day’s session schedules (without time_until fields)

after_hours: Optional[SessionSchedule]

After-hours session schedule, null if not available

close: datetime

Session close timestamp with timezone offset

formatdate-time
open: datetime

Session open timestamp with timezone offset

formatdate-time
time_until_close: Optional[str]

ISO 8601 duration until session closes. Null if session is not currently open.

formatduration
time_until_open: Optional[str]

ISO 8601 duration until session opens. Null if session has already started or closed.

formatduration
pre_market: Optional[SessionSchedule]

Pre-market session schedule, null if not available

close: datetime

Session close timestamp with timezone offset

formatdate-time
open: datetime

Session open timestamp with timezone offset

formatdate-time
time_until_close: Optional[str]

ISO 8601 duration until session closes. Null if session is not currently open.

formatduration
time_until_open: Optional[str]

ISO 8601 duration until session opens. Null if session has already started or closed.

formatduration
regular: Optional[SessionSchedule]

Regular trading session schedule, null if holiday/weekend

close: datetime

Session close timestamp with timezone offset

formatdate-time
open: datetime

Session open timestamp with timezone offset

formatdate-time
time_until_close: Optional[str]

ISO 8601 duration until session closes. Null if session is not currently open.

formatduration
time_until_open: Optional[str]

ISO 8601 duration until session opens. Null if session has already started or closed.

formatduration
status: MarketStatus

Market status information

day_type: DayType

The type of trading day

One of the following:
"TRADING_DAY"
"EARLY_CLOSE"
"HOLIDAY"
"WEEKEND"
is_open: bool

Whether the market is currently open (real-time)

current_session: Optional[MarketSessionType]

Current session type if market is open, null if closed

One of the following:
"pre_market"
"regular"
"after_hours"
timezone: str

IANA timezone identifier for the market

today_sessions: TradingSessions

Trading session schedules for the requested date with time_until fields

after_hours: Optional[SessionSchedule]

After-hours session schedule, null if not available

close: datetime

Session close timestamp with timezone offset

formatdate-time
open: datetime

Session open timestamp with timezone offset

formatdate-time
time_until_close: Optional[str]

ISO 8601 duration until session closes. Null if session is not currently open.

formatduration
time_until_open: Optional[str]

ISO 8601 duration until session opens. Null if session has already started or closed.

formatduration
pre_market: Optional[SessionSchedule]

Pre-market session schedule, null if not available

close: datetime

Session close timestamp with timezone offset

formatdate-time
open: datetime

Session open timestamp with timezone offset

formatdate-time
time_until_close: Optional[str]

ISO 8601 duration until session closes. Null if session is not currently open.

formatduration
time_until_open: Optional[str]

ISO 8601 duration until session opens. Null if session has already started or closed.

formatduration
regular: Optional[SessionSchedule]

Regular trading session schedule, null if holiday/weekend

close: datetime

Session close timestamp with timezone offset

formatdate-time
open: datetime

Session open timestamp with timezone offset

formatdate-time
time_until_close: Optional[str]

ISO 8601 duration until session closes. Null if session is not currently open.

formatduration
time_until_open: Optional[str]

ISO 8601 duration until session opens. Null if session has already started or closed.

formatduration

Get Market Hours Calendar.

from clear_street import ClearStreet

client = ClearStreet(
    api_key="My API Key",
)
response = client.v1.calendar.get_market_hours_calendar(
    date="date",
)
print(response)
{
  "data": [
    {
      "current_time": "2025-11-28T11:00:00-05:00",
      "date": "2025-11-28",
      "market": "us_equities",
      "market_name": "US Equities",
      "next_sessions": {
        "after_hours": {
          "close": "2025-12-01T20:00:00-05:00",
          "open": "2025-12-01T16:00:00-05:00"
        },
        "pre_market": {
          "close": "2025-12-01T09:30:00-05:00",
          "open": "2025-12-01T04:00:00-05:00"
        },
        "regular": {
          "close": "2025-12-01T16:00:00-05:00",
          "open": "2025-12-01T09:30:00-05:00"
        }
      },
      "status": {
        "current_session": "regular",
        "day_type": "EARLY_CLOSE",
        "is_open": true
      },
      "timezone": "America/New_York",
      "today_sessions": {
        "pre_market": {
          "close": "2025-11-28T09:30:00-05:00",
          "open": "2025-11-28T04:00:00-05:00"
        },
        "regular": {
          "close": "2025-11-28T13:00:00-05:00",
          "open": "2025-11-28T09:30:00-05:00",
          "time_until_close": "PT2H"
        }
      }
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "3d4e5f6a-7b8c-9d0e-1f2a-3b4c5d6e7f8a"
  }
}
{
  "data": [
    {
      "current_time": "2025-12-25T10:00:00-05:00",
      "date": "2025-12-25",
      "market": "us_equities",
      "market_name": "US Equities",
      "next_sessions": {
        "after_hours": {
          "close": "2025-12-26T20:00:00-05:00",
          "open": "2025-12-26T16:00:00-05:00"
        },
        "pre_market": {
          "close": "2025-12-26T09:30:00-05:00",
          "open": "2025-12-26T04:00:00-05:00"
        },
        "regular": {
          "close": "2025-12-26T16:00:00-05:00",
          "open": "2025-12-26T09:30:00-05:00"
        }
      },
      "status": {
        "day_type": "HOLIDAY",
        "is_open": false
      },
      "timezone": "America/New_York",
      "today_sessions": {}
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "2c3d4e5f-6a7b-8c9d-0e1f-2a3b4c5d6e7f"
  }
}
{
  "data": [
    {
      "current_time": "2025-10-15T14:30:45-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"
        },
        "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": "PT1H29M15S"
        },
        "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": "PT1H29M15S"
        }
      }
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "1b2c3d4e-5f6a-7b8c-9d0e-1f2a3b4c5d6e"
  }
}
{
  "data": [
    {
      "current_time": "2025-10-18T12:00:00-04:00",
      "date": "2025-10-18",
      "market": "us_equities",
      "market_name": "US Equities",
      "next_sessions": {
        "after_hours": {
          "close": "2025-10-20T20:00:00-04:00",
          "open": "2025-10-20T16:00:00-04:00"
        },
        "pre_market": {
          "close": "2025-10-20T09:30:00-04:00",
          "open": "2025-10-20T04:00:00-04:00"
        },
        "regular": {
          "close": "2025-10-20T16:00:00-04:00",
          "open": "2025-10-20T09:30:00-04:00"
        }
      },
      "status": {
        "day_type": "WEEKEND",
        "is_open": false
      },
      "timezone": "America/New_York",
      "today_sessions": {}
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "4e5f6a7b-8c9d-0e1f-2a3b-4c5d6e7f8a9b"
  }
}
Returns Examples
{
  "data": [
    {
      "current_time": "2025-11-28T11:00:00-05:00",
      "date": "2025-11-28",
      "market": "us_equities",
      "market_name": "US Equities",
      "next_sessions": {
        "after_hours": {
          "close": "2025-12-01T20:00:00-05:00",
          "open": "2025-12-01T16:00:00-05:00"
        },
        "pre_market": {
          "close": "2025-12-01T09:30:00-05:00",
          "open": "2025-12-01T04:00:00-05:00"
        },
        "regular": {
          "close": "2025-12-01T16:00:00-05:00",
          "open": "2025-12-01T09:30:00-05:00"
        }
      },
      "status": {
        "current_session": "regular",
        "day_type": "EARLY_CLOSE",
        "is_open": true
      },
      "timezone": "America/New_York",
      "today_sessions": {
        "pre_market": {
          "close": "2025-11-28T09:30:00-05:00",
          "open": "2025-11-28T04:00:00-05:00"
        },
        "regular": {
          "close": "2025-11-28T13:00:00-05:00",
          "open": "2025-11-28T09:30:00-05:00",
          "time_until_close": "PT2H"
        }
      }
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "3d4e5f6a-7b8c-9d0e-1f2a-3b4c5d6e7f8a"
  }
}
{
  "data": [
    {
      "current_time": "2025-12-25T10:00:00-05:00",
      "date": "2025-12-25",
      "market": "us_equities",
      "market_name": "US Equities",
      "next_sessions": {
        "after_hours": {
          "close": "2025-12-26T20:00:00-05:00",
          "open": "2025-12-26T16:00:00-05:00"
        },
        "pre_market": {
          "close": "2025-12-26T09:30:00-05:00",
          "open": "2025-12-26T04:00:00-05:00"
        },
        "regular": {
          "close": "2025-12-26T16:00:00-05:00",
          "open": "2025-12-26T09:30:00-05:00"
        }
      },
      "status": {
        "day_type": "HOLIDAY",
        "is_open": false
      },
      "timezone": "America/New_York",
      "today_sessions": {}
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "2c3d4e5f-6a7b-8c9d-0e1f-2a3b4c5d6e7f"
  }
}
{
  "data": [
    {
      "current_time": "2025-10-15T14:30:45-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"
        },
        "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": "PT1H29M15S"
        },
        "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": "PT1H29M15S"
        }
      }
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "1b2c3d4e-5f6a-7b8c-9d0e-1f2a3b4c5d6e"
  }
}
{
  "data": [
    {
      "current_time": "2025-10-18T12:00:00-04:00",
      "date": "2025-10-18",
      "market": "us_equities",
      "market_name": "US Equities",
      "next_sessions": {
        "after_hours": {
          "close": "2025-10-20T20:00:00-04:00",
          "open": "2025-10-20T16:00:00-04:00"
        },
        "pre_market": {
          "close": "2025-10-20T09:30:00-04:00",
          "open": "2025-10-20T04:00:00-04:00"
        },
        "regular": {
          "close": "2025-10-20T16:00:00-04:00",
          "open": "2025-10-20T09:30:00-04:00"
        }
      },
      "status": {
        "day_type": "WEEKEND",
        "is_open": false
      },
      "timezone": "America/New_York",
      "today_sessions": {}
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "4e5f6a7b-8c9d-0e1f-2a3b-4c5d6e7f8a9b"
  }
}