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 |