Calendar

Access clocks and financial calendars for market sessions and events.

Get Clock

GET/v1/clock

Get Market Hours Calendar.

GET/v1/calendars/market-hours

ModelsExpand Collapse

ClockDetail object { clock }

Current server time and market clock information

clock: string

Current server time in UTC

formatdate-time

DayType = "TRADING_DAY" or "EARLY_CLOSE" or "HOLIDAY" or "WEEKEND"

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

One of the following:

"TRADING_DAY"

"EARLY_CLOSE"

"HOLIDAY"

"WEEKEND"

MarketHoursDetail 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

formatdate-time

date: string

The date for which market hours are provided

formatdate

market: MarketType

Market type identifier

One of the following:

"us_equities"

"us_options"

market_name: string

Human-readable market name

next_sessions: TradingSessions { after_hours, pre_market, regular }

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

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

After-hours session schedule, null if not available

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

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

Pre-market session schedule, null if not available

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

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

Regular trading session schedule, null if holiday/weekend

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

status: MarketStatus { day_type, is_open, current_session }

Market status information

day_type: DayType

The type of trading day

One of the following:

"TRADING_DAY"

"EARLY_CLOSE"

"HOLIDAY"

"WEEKEND"

is_open: boolean

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: string

IANA timezone identifier for the market

today_sessions: TradingSessions { after_hours, pre_market, regular }

Trading session schedules for the requested date with time_until fields

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

After-hours session schedule, null if not available

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

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

Pre-market session schedule, null if not available

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

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

Regular trading session schedule, null if holiday/weekend

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

MarketHoursDetailList = array of MarketHoursDetail { current_time, date, market, 5 more }

current_time: string

Current time in market timezone with offset

formatdate-time

date: string

The date for which market hours are provided

formatdate

market: MarketType

Market type identifier

One of the following:

"us_equities"

"us_options"

market_name: string

Human-readable market name

next_sessions: TradingSessions { after_hours, pre_market, regular }

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

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

After-hours session schedule, null if not available

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

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

Pre-market session schedule, null if not available

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

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

Regular trading session schedule, null if holiday/weekend

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

status: MarketStatus { day_type, is_open, current_session }

Market status information

day_type: DayType

The type of trading day

One of the following:

"TRADING_DAY"

"EARLY_CLOSE"

"HOLIDAY"

"WEEKEND"

is_open: boolean

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: string

IANA timezone identifier for the market

today_sessions: TradingSessions { after_hours, pre_market, regular }

Trading session schedules for the requested date with time_until fields

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

After-hours session schedule, null if not available

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

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

Pre-market session schedule, null if not available

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

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

Regular trading session schedule, null if holiday/weekend

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

MarketSessionType = "pre_market" or "regular" or "after_hours"

Session type for market hours

One of the following:

"pre_market"

"regular"

"after_hours"

MarketStatus object { day_type, is_open, current_session }

Market status information

day_type: DayType

The type of trading day

One of the following:

"TRADING_DAY"

"EARLY_CLOSE"

"HOLIDAY"

"WEEKEND"

is_open: boolean

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"

MarketType = "us_equities" or "us_options"

Market type for market hours calendar endpoint

One of the following:

"us_equities"

"us_options"

SessionSchedule object { close, open, time_until_close, time_until_open }

Session schedule with open and close timestamps

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

TradingSessions object { after_hours, pre_market, regular }

Trading sessions for a market day with full timestamps

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

After-hours session schedule, null if not available

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

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

Pre-market session schedule, null if not available

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

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

Regular trading session schedule, null if holiday/weekend

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

CalendarGetClockResponse = BaseResponse { metadata, error }

data: ClockDetail { clock }

Current server time and market clock information

clock: string

Current server time in UTC

formatdate-time

CalendarGetMarketHoursCalendarResponse = BaseResponse { metadata, error }

data: MarketHoursDetailList { current_time, date, market, 5 more }

current_time: string

Current time in market timezone with offset

formatdate-time

date: string

The date for which market hours are provided

formatdate

market: MarketType

Market type identifier

One of the following:

"us_equities"

"us_options"

market_name: string

Human-readable market name

next_sessions: TradingSessions { after_hours, pre_market, regular }

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

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

After-hours session schedule, null if not available

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

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

Pre-market session schedule, null if not available

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

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

Regular trading session schedule, null if holiday/weekend

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

status: MarketStatus { day_type, is_open, current_session }

Market status information

day_type: DayType

The type of trading day

One of the following:

"TRADING_DAY"

"EARLY_CLOSE"

"HOLIDAY"

"WEEKEND"

is_open: boolean

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: string

IANA timezone identifier for the market

today_sessions: TradingSessions { after_hours, pre_market, regular }

Trading session schedules for the requested date with time_until fields

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

After-hours session schedule, null if not available

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

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

Pre-market session schedule, null if not available

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration

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

Regular trading session schedule, null if holiday/weekend

close: string

Session close timestamp with timezone offset

formatdate-time

open: string

Session open timestamp with timezone offset

formatdate-time

time_until_close: optional string

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

formatduration

time_until_open: optional string

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

formatduration