API Reference

V1

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Calendar

Access clocks and financial calendars for market sessions and events.

Get Clock

$ clear-street v1:calendar get-clock

GET/v1/clock

Get Market Hours Calendar.

$ clear-street v1:calendar get-market-hours-calendar

GET/v1/calendars/market-hours

ModelsExpand Collapse

clock_detail: object { clock }

Current server time and market clock information

clock: string

Current server time in UTC

day_type: "TRADING_DAY" or "EARLY_CLOSE" or "HOLIDAY" or "WEEKEND"

Day type for market hours - indicates the type of trading day

"TRADING_DAY"

"EARLY_CLOSE"

"HOLIDAY"

"WEEKEND"

market_hours_detail: object { current_time, date, market, 5 more }

Comprehensive market hours information for a specific market and date

current_time: string

Current time in market timezone with offset

date: string

The date for which market hours are provided

market: "us_equities" or "us_options"

Market type identifier

"us_equities"

"us_options"

market_name: string

Human-readable market name

next_sessions: object { after_hours, pre_market, regular }

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

after_hours: optional object { close, open, time_until_close, time_until_open }

After-hours session schedule, null if not available

close: string

Session close timestamp with timezone offset

open: string

Session open timestamp with timezone offset

time_until_close: optional string

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

time_until_open: optional string

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

pre_market: optional object { close, open, time_until_close, time_until_open }

Pre-market session schedule, null if not available

close: string

Session close timestamp with timezone offset

open: string

Session open timestamp with timezone offset

time_until_close: optional string

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

time_until_open: optional string

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

regular: optional object { close, open, time_until_close, time_until_open }

Regular trading session schedule, null if holiday/weekend

close: string

Session close timestamp with timezone offset

open: string

Session open timestamp with timezone offset

time_until_close: optional string

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

time_until_open: optional string

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

status: object { day_type, is_open, current_session }

Market status information

day_type: "TRADING_DAY" or "EARLY_CLOSE" or "HOLIDAY" or "WEEKEND"

The type of trading day

"TRADING_DAY"

"EARLY_CLOSE"

"HOLIDAY"

"WEEKEND"

is_open: boolean

Whether the market is currently open (real-time)

current_session: optional "pre_market" or "regular" or "after_hours"

Current session type if market is open, null if closed

"pre_market"

"regular"

"after_hours"

timezone: string

IANA timezone identifier for the market

today_sessions: object { after_hours, pre_market, regular }

Trading session schedules for the requested date with time_until fields

after_hours: optional object { close, open, time_until_close, time_until_open }

After-hours session schedule, null if not available

close: string

Session close timestamp with timezone offset

open: string

Session open timestamp with timezone offset

time_until_close: optional string

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

time_until_open: optional string

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

pre_market: optional object { close, open, time_until_close, time_until_open }

Pre-market session schedule, null if not available

close: string

Session close timestamp with timezone offset

open: string

Session open timestamp with timezone offset

time_until_close: optional string

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

time_until_open: optional string

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

regular: optional object { close, open, time_until_close, time_until_open }

Regular trading session schedule, null if holiday/weekend

close: string

Session close timestamp with timezone offset

open: string

Session open timestamp with timezone offset

time_until_close: optional string

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

time_until_open: optional string

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

market_hours_detail_list: array of MarketHoursDetail { current_time, date, market, 5 more }

current_time: string

Current time in market timezone with offset

date: string

The date for which market hours are provided

market: "us_equities" or "us_options"

Market type identifier

"us_equities"

"us_options"

market_name: string

Human-readable market name

next_sessions: object { after_hours, pre_market, regular }

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

after_hours: optional object { close, open, time_until_close, time_until_open }

After-hours session schedule, null if not available

close: string

Session close timestamp with timezone offset

open: string

Session open timestamp with timezone offset

time_until_close: optional string

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

time_until_open: optional string

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

pre_market: optional object { close, open, time_until_close, time_until_open }

Pre-market session schedule, null if not available

close: string

Session close timestamp with timezone offset

open: string

Session open timestamp with timezone offset

time_until_close: optional string

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

time_until_open: optional string

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

regular: optional object { close, open, time_until_close, time_until_open }

Regular trading session schedule, null if holiday/weekend

close: string

Session close timestamp with timezone offset

open: string

Session open timestamp with timezone offset

time_until_close: optional string

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

time_until_open: optional string

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

status: object { day_type, is_open, current_session }

Market status information

day_type: "TRADING_DAY" or "EARLY_CLOSE" or "HOLIDAY" or "WEEKEND"

The type of trading day

"TRADING_DAY"

"EARLY_CLOSE"

"HOLIDAY"

"WEEKEND"

is_open: boolean

Whether the market is currently open (real-time)

current_session: optional "pre_market" or "regular" or "after_hours"

Current session type if market is open, null if closed

"pre_market"

"regular"

"after_hours"

timezone: string

IANA timezone identifier for the market

today_sessions: object { after_hours, pre_market, regular }

Trading session schedules for the requested date with time_until fields

after_hours: optional object { close, open, time_until_close, time_until_open }

After-hours session schedule, null if not available

close: string

Session close timestamp with timezone offset

open: string

Session open timestamp with timezone offset

time_until_close: optional string

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

time_until_open: optional string

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

pre_market: optional object { close, open, time_until_close, time_until_open }

Pre-market session schedule, null if not available

close: string

Session close timestamp with timezone offset

open: string

Session open timestamp with timezone offset

time_until_close: optional string

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

time_until_open: optional string

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

regular: optional object { close, open, time_until_close, time_until_open }

Regular trading session schedule, null if holiday/weekend

close: string

Session close timestamp with timezone offset

open: string

Session open timestamp with timezone offset

time_until_close: optional string

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

time_until_open: optional string

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

market_session_type: "pre_market" or "regular" or "after_hours"

Session type for market hours

"pre_market"

"regular"

"after_hours"

market_status: object { day_type, is_open, current_session }

Market status information

day_type: "TRADING_DAY" or "EARLY_CLOSE" or "HOLIDAY" or "WEEKEND"

The type of trading day

"TRADING_DAY"

"EARLY_CLOSE"

"HOLIDAY"

"WEEKEND"

is_open: boolean

Whether the market is currently open (real-time)

current_session: optional "pre_market" or "regular" or "after_hours"

Current session type if market is open, null if closed

"pre_market"

"regular"

"after_hours"

market_type: "us_equities" or "us_options"

Market type for market hours calendar endpoint

"us_equities"

"us_options"

session_schedule: object { close, open, time_until_close, time_until_open }

Session schedule with open and close timestamps

close: string

Session close timestamp with timezone offset

open: string

Session open timestamp with timezone offset

time_until_close: optional string

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

time_until_open: optional string

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

trading_sessions: object { after_hours, pre_market, regular }

Trading sessions for a market day with full timestamps

after_hours: optional object { close, open, time_until_close, time_until_open }

After-hours session schedule, null if not available

close: string

Session close timestamp with timezone offset

open: string

Session open timestamp with timezone offset

time_until_close: optional string

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

time_until_open: optional string

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

pre_market: optional object { close, open, time_until_close, time_until_open }

Pre-market session schedule, null if not available

close: string

Session close timestamp with timezone offset

open: string

Session open timestamp with timezone offset

time_until_close: optional string

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

time_until_open: optional string

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

regular: optional object { close, open, time_until_close, time_until_open }

Regular trading session schedule, null if holiday/weekend

close: string

Session close timestamp with timezone offset

open: string

Session open timestamp with timezone offset

time_until_close: optional string

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

time_until_open: optional string

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