Skip to content
Stove Website

Query Trading Sessions ​

Endpoint Information ​

Endpoint: GET /market/v1/{market}/trading-sessions

Description: Query current market trading hours and session information

Authentication: Institution API Key + Signature (non-Maker API endpoint — X-Maker-Addr is not required). See Authorization

Query Parameters ​

ParameterTypeRequiredDescription
marketENUMYesMarket code (path parameter). See Market enum type description

Response Parameters ​

FieldTypeDescription
marketENUMMarket code
is_openBOOLEANWhether the market is currently open
is_trading_dayBOOLEANWhether today is a trading day
current_timeLONGCurrent time, UNIX timestamp (seconds)
current_session_startLONGCurrent session start time, UNIX timestamp (seconds)
current_session_endLONGCurrent session end time, UNIX timestamp (seconds)
current_sessionENUMCurrent session. See Session enum type description
next_session_startLONGNext session start time, UNIX timestamp (seconds). Only returned when current_session is closed
next_session_endLONGNext session end time, UNIX timestamp (seconds). Only returned when current_session is closed
next_sessionENUMNext session. See Session enum type description. Only returned when current_session is closed

Request Example ​

bash
curl -X GET "{API_BASE_URL}/market/v1/usex/trading-sessions" \
     -H "X-API-Key: YOUR_API_KEY" \
     -H "X-API-Timestamp: 1746774142000" \
     -H "X-API-Signature: GENERATED_SIGNATURE"

Response Example ​

json
{
    "code": 0,
    "data": {
        "market": "usex",
        "is_open": true,
        "is_trading_day": true,
        "current_time": 1751362846,
        "current_session_start": 1751328000,
        "current_session_end": 1751414399,
        "current_session": "trading"
    }
}

Error Example ​

json
{
    "code": 500,
    "message": "Internal Service Error",
    "details": ""
}