Api sfp trading schedule response

ApiSfpTradingScheduleResponse

Name
Lite
Type Required
Default
Description
update_time
ut
string True Session data update timestamp in milliseconds
equity
e
SfpMarketSchedule False
None
Legacy: use schedules instead. Schedule for the EQUITY asset class
equity_nyse
en
SfpMarketSchedule False
None
Legacy: use schedules instead. Schedule for the EQUITY_NYSE asset class
equity_nasdaq
en1
SfpMarketSchedule False
None
Legacy: use schedules instead. Schedule for the EQUITY_NASDAQ asset class
commodity
c
SfpMarketSchedule False
None
Legacy: use schedules instead. Schedule for the COMMODITY asset class
commodity_cme
cc
SfpMarketSchedule False
None
Legacy: use schedules instead. Schedule for the COMMODITY_CME asset class
schedules
s
[SfpTradingScheduleGroup] True Trading hours as groups of stable perps sharing them: one per asset class, named after it, then one per instrument schedule, named in cluster config. Each stable perp with a schedule is in exactly one group
SfpMarketSchedule
Name
Lite
Type Required
Default
Description
sessions
s
[TradingSession] True Trading sessions for the current calendar week (Sunday to Saturday in the exchange's local time). The sessions are contiguous with no gaps, and any period when the market is not open, including holidays falling in this week, is returned as a CLOSE session
holidays
h
[TradingHolidaySchedule] True Market holidays and early closes, past and upcoming, sorted by start time. The market is closed from the start time to the end time of each entry. Empty when there are none
TradingSession
Name
Lite
Type Required
Default
Description
start_time
st
string True Trading session start time timestamp in milliseconds
end_time
et
string True Trading session end time timestamp in milliseconds
type
t
TradingSessionType True Trading session type
TradingSessionType

Specifies different types of trading sessions

Value Description
REGULAR = 1 Core market hours. Full liquidity.
PRE_MARKET = 2 Extended hours before open. Lower liquidity.
AFTER_MARKET = 3 Extended hours after close. Lower liquidity.
OVERNIGHT = 4 For 24/5 or specific overnight TradFi perps. Minimal liquidity.
CLOSE = 5 Weekends, holidays, or daily maintenance windows.
TradingHolidaySchedule
Name
Lite
Type Required
Default
Description
name
n
string True Holiday name
close_type
ct
TradingScheduleCloseType True FULL_DAY: the market is closed for the whole day. EARLY_CLOSE: the market trades as normal until the start time, then is closed until the end time
start_time
st
string True When the closure begins, as a Unix timestamp in milliseconds. For FULL_DAY this is when the closed trading day's session would have opened (the evening before for a session that opens before midnight); for EARLY_CLOSE it is the moment the market closes early
end_time
et
string True When the closed or shortened trading day's session would have closed, as a Unix timestamp in milliseconds. The closure covers the start time up to, but not including, the end time
TradingScheduleCloseType

How the market behaves on a holiday date

Value Description
FULL_DAY = 1 Market is fully closed for the entire day
EARLY_CLOSE = 2 Market closes early; see the earlyClose time
SfpMarketSchedule
Name
Lite
Type Required
Default
Description
sessions
s
[TradingSession] True Trading sessions for the current calendar week (Sunday to Saturday in the exchange's local time). The sessions are contiguous with no gaps, and any period when the market is not open, including holidays falling in this week, is returned as a CLOSE session
holidays
h
[TradingHolidaySchedule] True Market holidays and early closes, past and upcoming, sorted by start time. The market is closed from the start time to the end time of each entry. Empty when there are none
TradingSession
Name
Lite
Type Required
Default
Description
start_time
st
string True Trading session start time timestamp in milliseconds
end_time
et
string True Trading session end time timestamp in milliseconds
type
t
TradingSessionType True Trading session type
TradingSessionType

Specifies different types of trading sessions

Value Description
REGULAR = 1 Core market hours. Full liquidity.
PRE_MARKET = 2 Extended hours before open. Lower liquidity.
AFTER_MARKET = 3 Extended hours after close. Lower liquidity.
OVERNIGHT = 4 For 24/5 or specific overnight TradFi perps. Minimal liquidity.
CLOSE = 5 Weekends, holidays, or daily maintenance windows.
TradingHolidaySchedule
Name
Lite
Type Required
Default
Description
name
n
string True Holiday name
close_type
ct
TradingScheduleCloseType True FULL_DAY: the market is closed for the whole day. EARLY_CLOSE: the market trades as normal until the start time, then is closed until the end time
start_time
st
string True When the closure begins, as a Unix timestamp in milliseconds. For FULL_DAY this is when the closed trading day's session would have opened (the evening before for a session that opens before midnight); for EARLY_CLOSE it is the moment the market closes early
end_time
et
string True When the closed or shortened trading day's session would have closed, as a Unix timestamp in milliseconds. The closure covers the start time up to, but not including, the end time
TradingScheduleCloseType

How the market behaves on a holiday date

Value Description
FULL_DAY = 1 Market is fully closed for the entire day
EARLY_CLOSE = 2 Market closes early; see the earlyClose time
SfpMarketSchedule
Name
Lite
Type Required
Default
Description
sessions
s
[TradingSession] True Trading sessions for the current calendar week (Sunday to Saturday in the exchange's local time). The sessions are contiguous with no gaps, and any period when the market is not open, including holidays falling in this week, is returned as a CLOSE session
holidays
h
[TradingHolidaySchedule] True Market holidays and early closes, past and upcoming, sorted by start time. The market is closed from the start time to the end time of each entry. Empty when there are none
TradingSession
Name
Lite
Type Required
Default
Description
start_time
st
string True Trading session start time timestamp in milliseconds
end_time
et
string True Trading session end time timestamp in milliseconds
type
t
TradingSessionType True Trading session type
TradingSessionType

Specifies different types of trading sessions

Value Description
REGULAR = 1 Core market hours. Full liquidity.
PRE_MARKET = 2 Extended hours before open. Lower liquidity.
AFTER_MARKET = 3 Extended hours after close. Lower liquidity.
OVERNIGHT = 4 For 24/5 or specific overnight TradFi perps. Minimal liquidity.
CLOSE = 5 Weekends, holidays, or daily maintenance windows.
TradingHolidaySchedule
Name
Lite
Type Required
Default
Description
name
n
string True Holiday name
close_type
ct
TradingScheduleCloseType True FULL_DAY: the market is closed for the whole day. EARLY_CLOSE: the market trades as normal until the start time, then is closed until the end time
start_time
st
string True When the closure begins, as a Unix timestamp in milliseconds. For FULL_DAY this is when the closed trading day's session would have opened (the evening before for a session that opens before midnight); for EARLY_CLOSE it is the moment the market closes early
end_time
et
string True When the closed or shortened trading day's session would have closed, as a Unix timestamp in milliseconds. The closure covers the start time up to, but not including, the end time
TradingScheduleCloseType

How the market behaves on a holiday date

Value Description
FULL_DAY = 1 Market is fully closed for the entire day
EARLY_CLOSE = 2 Market closes early; see the earlyClose time
SfpMarketSchedule
Name
Lite
Type Required
Default
Description
sessions
s
[TradingSession] True Trading sessions for the current calendar week (Sunday to Saturday in the exchange's local time). The sessions are contiguous with no gaps, and any period when the market is not open, including holidays falling in this week, is returned as a CLOSE session
holidays
h
[TradingHolidaySchedule] True Market holidays and early closes, past and upcoming, sorted by start time. The market is closed from the start time to the end time of each entry. Empty when there are none
TradingSession
Name
Lite
Type Required
Default
Description
start_time
st
string True Trading session start time timestamp in milliseconds
end_time
et
string True Trading session end time timestamp in milliseconds
type
t
TradingSessionType True Trading session type
TradingSessionType

Specifies different types of trading sessions

Value Description
REGULAR = 1 Core market hours. Full liquidity.
PRE_MARKET = 2 Extended hours before open. Lower liquidity.
AFTER_MARKET = 3 Extended hours after close. Lower liquidity.
OVERNIGHT = 4 For 24/5 or specific overnight TradFi perps. Minimal liquidity.
CLOSE = 5 Weekends, holidays, or daily maintenance windows.
TradingHolidaySchedule
Name
Lite
Type Required
Default
Description
name
n
string True Holiday name
close_type
ct
TradingScheduleCloseType True FULL_DAY: the market is closed for the whole day. EARLY_CLOSE: the market trades as normal until the start time, then is closed until the end time
start_time
st
string True When the closure begins, as a Unix timestamp in milliseconds. For FULL_DAY this is when the closed trading day's session would have opened (the evening before for a session that opens before midnight); for EARLY_CLOSE it is the moment the market closes early
end_time
et
string True When the closed or shortened trading day's session would have closed, as a Unix timestamp in milliseconds. The closure covers the start time up to, but not including, the end time
TradingScheduleCloseType

How the market behaves on a holiday date

Value Description
FULL_DAY = 1 Market is fully closed for the entire day
EARLY_CLOSE = 2 Market closes early; see the earlyClose time
SfpMarketSchedule
Name
Lite
Type Required
Default
Description
sessions
s
[TradingSession] True Trading sessions for the current calendar week (Sunday to Saturday in the exchange's local time). The sessions are contiguous with no gaps, and any period when the market is not open, including holidays falling in this week, is returned as a CLOSE session
holidays
h
[TradingHolidaySchedule] True Market holidays and early closes, past and upcoming, sorted by start time. The market is closed from the start time to the end time of each entry. Empty when there are none
TradingSession
Name
Lite
Type Required
Default
Description
start_time
st
string True Trading session start time timestamp in milliseconds
end_time
et
string True Trading session end time timestamp in milliseconds
type
t
TradingSessionType True Trading session type
TradingSessionType

Specifies different types of trading sessions

Value Description
REGULAR = 1 Core market hours. Full liquidity.
PRE_MARKET = 2 Extended hours before open. Lower liquidity.
AFTER_MARKET = 3 Extended hours after close. Lower liquidity.
OVERNIGHT = 4 For 24/5 or specific overnight TradFi perps. Minimal liquidity.
CLOSE = 5 Weekends, holidays, or daily maintenance windows.
TradingHolidaySchedule
Name
Lite
Type Required
Default
Description
name
n
string True Holiday name
close_type
ct
TradingScheduleCloseType True FULL_DAY: the market is closed for the whole day. EARLY_CLOSE: the market trades as normal until the start time, then is closed until the end time
start_time
st
string True When the closure begins, as a Unix timestamp in milliseconds. For FULL_DAY this is when the closed trading day's session would have opened (the evening before for a session that opens before midnight); for EARLY_CLOSE it is the moment the market closes early
end_time
et
string True When the closed or shortened trading day's session would have closed, as a Unix timestamp in milliseconds. The closure covers the start time up to, but not including, the end time
TradingScheduleCloseType

How the market behaves on a holiday date

Value Description
FULL_DAY = 1 Market is fully closed for the entire day
EARLY_CLOSE = 2 Market closes early; see the earlyClose time
SfpTradingScheduleGroup
Name
Lite
Type Required
Default
Description
name
n
string True The group name. For stable perps on their asset class hours, the asset class (for example COMMODITY_CME)
asset_class
ac
AssetClass True The instruments' asset class. Its holiday calendar sets the group's holidays
instruments
i
[string] True The stable perps trading these hours, sorted. Each stable perp with a schedule is in exactly one group
sessions
s
[TradingSession] True Trading sessions for the current calendar week (Sunday to Saturday in the exchange's local time). The sessions are contiguous with no gaps, and any period when the market is not open, including holidays falling in this week, is returned as a CLOSE session
holidays
h
[TradingHolidaySchedule] True Market holidays and early closes, past and upcoming, sorted by start time. The market is closed from the start time to the end time of each entry. Empty when there are none
AssetClass

Asset class of an instrument's underlying. The first five values (crypto through index) are general classifications used by Perpetuals for display. The remaining values (equityNasdaq, equityNyse, etc.) are schedule-specific and used by SFPs to route to a trading schedule

Value Description
CRYPTO = 1 Digital assets (e.g. BTC, ETH)
EQUITY = 2 Equities and equity-linked underlyings (e.g. stocks)
COMMODITY = 3 Physical commodities (e.g. gold, oil)
FX = 4 Foreign-exchange currency pairs
INDEX = 5 Composite indices tracking a basket of underlyings
EQUITY_NASDAQ = 6 NASDAQ-listed equities — maps to a TradingSchedule entry
EQUITY_NYSE = 7 NYSE/NYSE Arca-listed equities and ETFs — maps to a TradingSchedule entry
EQUITY_KRX = 8 Korea Exchange (KRX)-listed equities — maps to a TradingSchedule entry
COMMODITY_CME = 9 CME-traded commodities — maps to a TradingSchedule entry
PRE_IPO = 10 Pre-IPO instruments — maps to a TradingSchedule entry
TradingSession
Name
Lite
Type Required
Default
Description
start_time
st
string True Trading session start time timestamp in milliseconds
end_time
et
string True Trading session end time timestamp in milliseconds
type
t
TradingSessionType True Trading session type
TradingSessionType

Specifies different types of trading sessions

Value Description
REGULAR = 1 Core market hours. Full liquidity.
PRE_MARKET = 2 Extended hours before open. Lower liquidity.
AFTER_MARKET = 3 Extended hours after close. Lower liquidity.
OVERNIGHT = 4 For 24/5 or specific overnight TradFi perps. Minimal liquidity.
CLOSE = 5 Weekends, holidays, or daily maintenance windows.
TradingHolidaySchedule
Name
Lite
Type Required
Default
Description
name
n
string True Holiday name
close_type
ct
TradingScheduleCloseType True FULL_DAY: the market is closed for the whole day. EARLY_CLOSE: the market trades as normal until the start time, then is closed until the end time
start_time
st
string True When the closure begins, as a Unix timestamp in milliseconds. For FULL_DAY this is when the closed trading day's session would have opened (the evening before for a session that opens before midnight); for EARLY_CLOSE it is the moment the market closes early
end_time
et
string True When the closed or shortened trading day's session would have closed, as a Unix timestamp in milliseconds. The closure covers the start time up to, but not including, the end time
TradingScheduleCloseType

How the market behaves on a holiday date

Value Description
FULL_DAY = 1 Market is fully closed for the entire day
EARLY_CLOSE = 2 Market closes early; see the earlyClose time