Skip to content
Clear Street Clear Street
Get started
API Reference
V1
Calendar

Get Market Hours Calendar.

CalendarGetMarketHoursCalendarResponse v1().calendar().getMarketHoursCalendar(CalendarGetMarketHoursCalendarParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/calendars/market-hours

Retrieves comprehensive trading hours including pre-market, regular, and after-hours sessions. Returns market status, session times, and next session schedules.

ParametersExpand Collapse
CalendarGetMarketHoursCalendarParams params
String date

The date to query market hours for (YYYY-MM-DD). Defaults to today.

Optional<MarketType> market

Market type to query (us_equities, us_options). If omitted, returns all markets.

ReturnsExpand Collapse
class CalendarGetMarketHoursCalendarResponse:
LocalDateTime currentTime

Current time in market timezone with offset

formatdate-time
LocalDate date

The date for which market hours are provided

formatdate
MarketType market

Market type identifier

One of the following:
US_EQUITIES("us_equities")
US_OPTIONS("us_options")
String marketName

Human-readable market name

TradingSessions nextSessions

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

Optional<SessionSchedule> afterHours

After-hours session schedule, null if not available

LocalDateTime close

Session close timestamp with timezone offset

formatdate-time
LocalDateTime open

Session open timestamp with timezone offset

formatdate-time
Optional<String> timeUntilClose

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

formatduration
Optional<String> timeUntilOpen

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

formatduration
Optional<SessionSchedule> preMarket

Pre-market session schedule, null if not available

LocalDateTime close

Session close timestamp with timezone offset

formatdate-time
LocalDateTime open

Session open timestamp with timezone offset

formatdate-time
Optional<String> timeUntilClose

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

formatduration
Optional<String> timeUntilOpen

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

formatduration
Optional<SessionSchedule> regular

Regular trading session schedule, null if holiday/weekend

LocalDateTime close

Session close timestamp with timezone offset

formatdate-time
LocalDateTime open

Session open timestamp with timezone offset

formatdate-time
Optional<String> timeUntilClose

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

formatduration
Optional<String> timeUntilOpen

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

formatduration

Market status information

DayType dayType

The type of trading day

One of the following:
TRADING_DAY("TRADING_DAY")
EARLY_CLOSE("EARLY_CLOSE")
HOLIDAY("HOLIDAY")
WEEKEND("WEEKEND")
boolean isOpen

Whether the market is currently open (real-time)

Optional<MarketSessionType> currentSession

Current session type if market is open, null if closed

One of the following:
PRE_MARKET("pre_market")
REGULAR("regular")
AFTER_HOURS("after_hours")
String timezone

IANA timezone identifier for the market

TradingSessions todaySessions

Trading session schedules for the requested date with time_until fields

Optional<SessionSchedule> afterHours

After-hours session schedule, null if not available

LocalDateTime close

Session close timestamp with timezone offset

formatdate-time
LocalDateTime open

Session open timestamp with timezone offset

formatdate-time
Optional<String> timeUntilClose

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

formatduration
Optional<String> timeUntilOpen

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

formatduration
Optional<SessionSchedule> preMarket

Pre-market session schedule, null if not available

LocalDateTime close

Session close timestamp with timezone offset

formatdate-time
LocalDateTime open

Session open timestamp with timezone offset

formatdate-time
Optional<String> timeUntilClose

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

formatduration
Optional<String> timeUntilOpen

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

formatduration
Optional<SessionSchedule> regular

Regular trading session schedule, null if holiday/weekend

LocalDateTime close

Session close timestamp with timezone offset

formatdate-time
LocalDateTime open

Session open timestamp with timezone offset

formatdate-time
Optional<String> timeUntilClose

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

formatduration
Optional<String> timeUntilOpen

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

formatduration

Get Market Hours Calendar.

package com.clear_street.api.example;

import com.clear_street.api.client.ClearStreetClient;
import com.clear_street.api.client.okhttp.ClearStreetOkHttpClient;
import com.clear_street.api.models.v1.calendar.CalendarGetMarketHoursCalendarParams;
import com.clear_street.api.models.v1.calendar.CalendarGetMarketHoursCalendarResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        ClearStreetClient client = ClearStreetOkHttpClient.builder()
            .fromEnv()
            .apiKey("My API Key")
            .build();

        CalendarGetMarketHoursCalendarParams params = CalendarGetMarketHoursCalendarParams.builder()
            .date("date")
            .build();
        CalendarGetMarketHoursCalendarResponse response = client.v1().calendar().getMarketHoursCalendar(params);
    }
}
{
  "data": [
    {
      "current_time": "2025-11-28T11:00:00-05:00",
      "date": "2025-11-28",
      "market": "us_equities",
      "market_name": "US Equities",
      "next_sessions": {
        "after_hours": {
          "close": "2025-12-01T20:00:00-05:00",
          "open": "2025-12-01T16:00:00-05:00"
        },
        "pre_market": {
          "close": "2025-12-01T09:30:00-05:00",
          "open": "2025-12-01T04:00:00-05:00"
        },
        "regular": {
          "close": "2025-12-01T16:00:00-05:00",
          "open": "2025-12-01T09:30:00-05:00"
        }
      },
      "status": {
        "current_session": "regular",
        "day_type": "EARLY_CLOSE",
        "is_open": true
      },
      "timezone": "America/New_York",
      "today_sessions": {
        "pre_market": {
          "close": "2025-11-28T09:30:00-05:00",
          "open": "2025-11-28T04:00:00-05:00"
        },
        "regular": {
          "close": "2025-11-28T13:00:00-05:00",
          "open": "2025-11-28T09:30:00-05:00",
          "time_until_close": "PT2H"
        }
      }
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "3d4e5f6a-7b8c-9d0e-1f2a-3b4c5d6e7f8a"
  }
}
{
  "data": [
    {
      "current_time": "2025-12-25T10:00:00-05:00",
      "date": "2025-12-25",
      "market": "us_equities",
      "market_name": "US Equities",
      "next_sessions": {
        "after_hours": {
          "close": "2025-12-26T20:00:00-05:00",
          "open": "2025-12-26T16:00:00-05:00"
        },
        "pre_market": {
          "close": "2025-12-26T09:30:00-05:00",
          "open": "2025-12-26T04:00:00-05:00"
        },
        "regular": {
          "close": "2025-12-26T16:00:00-05:00",
          "open": "2025-12-26T09:30:00-05:00"
        }
      },
      "status": {
        "day_type": "HOLIDAY",
        "is_open": false
      },
      "timezone": "America/New_York",
      "today_sessions": {}
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "2c3d4e5f-6a7b-8c9d-0e1f-2a3b4c5d6e7f"
  }
}
{
  "data": [
    {
      "current_time": "2025-10-15T14:30:45-04:00",
      "date": "2025-10-15",
      "market": "us_equities",
      "market_name": "US Equities",
      "next_sessions": {
        "after_hours": {
          "close": "2025-10-16T20:00:00-04:00",
          "open": "2025-10-16T16:00:00-04:00"
        },
        "pre_market": {
          "close": "2025-10-16T09:30:00-04:00",
          "open": "2025-10-16T04:00:00-04:00"
        },
        "regular": {
          "close": "2025-10-16T16:00:00-04:00",
          "open": "2025-10-16T09:30:00-04:00"
        }
      },
      "status": {
        "current_session": "regular",
        "day_type": "TRADING_DAY",
        "is_open": true
      },
      "timezone": "America/New_York",
      "today_sessions": {
        "after_hours": {
          "close": "2025-10-15T20:00:00-04:00",
          "open": "2025-10-15T16:00:00-04:00",
          "time_until_open": "PT1H29M15S"
        },
        "pre_market": {
          "close": "2025-10-15T09:30:00-04:00",
          "open": "2025-10-15T04:00:00-04:00"
        },
        "regular": {
          "close": "2025-10-15T16:00:00-04:00",
          "open": "2025-10-15T09:30:00-04:00",
          "time_until_close": "PT1H29M15S"
        }
      }
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "1b2c3d4e-5f6a-7b8c-9d0e-1f2a3b4c5d6e"
  }
}
{
  "data": [
    {
      "current_time": "2025-10-18T12:00:00-04:00",
      "date": "2025-10-18",
      "market": "us_equities",
      "market_name": "US Equities",
      "next_sessions": {
        "after_hours": {
          "close": "2025-10-20T20:00:00-04:00",
          "open": "2025-10-20T16:00:00-04:00"
        },
        "pre_market": {
          "close": "2025-10-20T09:30:00-04:00",
          "open": "2025-10-20T04:00:00-04:00"
        },
        "regular": {
          "close": "2025-10-20T16:00:00-04:00",
          "open": "2025-10-20T09:30:00-04:00"
        }
      },
      "status": {
        "day_type": "WEEKEND",
        "is_open": false
      },
      "timezone": "America/New_York",
      "today_sessions": {}
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "4e5f6a7b-8c9d-0e1f-2a3b-4c5d6e7f8a9b"
  }
}
Returns Examples
{
  "data": [
    {
      "current_time": "2025-11-28T11:00:00-05:00",
      "date": "2025-11-28",
      "market": "us_equities",
      "market_name": "US Equities",
      "next_sessions": {
        "after_hours": {
          "close": "2025-12-01T20:00:00-05:00",
          "open": "2025-12-01T16:00:00-05:00"
        },
        "pre_market": {
          "close": "2025-12-01T09:30:00-05:00",
          "open": "2025-12-01T04:00:00-05:00"
        },
        "regular": {
          "close": "2025-12-01T16:00:00-05:00",
          "open": "2025-12-01T09:30:00-05:00"
        }
      },
      "status": {
        "current_session": "regular",
        "day_type": "EARLY_CLOSE",
        "is_open": true
      },
      "timezone": "America/New_York",
      "today_sessions": {
        "pre_market": {
          "close": "2025-11-28T09:30:00-05:00",
          "open": "2025-11-28T04:00:00-05:00"
        },
        "regular": {
          "close": "2025-11-28T13:00:00-05:00",
          "open": "2025-11-28T09:30:00-05:00",
          "time_until_close": "PT2H"
        }
      }
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "3d4e5f6a-7b8c-9d0e-1f2a-3b4c5d6e7f8a"
  }
}
{
  "data": [
    {
      "current_time": "2025-12-25T10:00:00-05:00",
      "date": "2025-12-25",
      "market": "us_equities",
      "market_name": "US Equities",
      "next_sessions": {
        "after_hours": {
          "close": "2025-12-26T20:00:00-05:00",
          "open": "2025-12-26T16:00:00-05:00"
        },
        "pre_market": {
          "close": "2025-12-26T09:30:00-05:00",
          "open": "2025-12-26T04:00:00-05:00"
        },
        "regular": {
          "close": "2025-12-26T16:00:00-05:00",
          "open": "2025-12-26T09:30:00-05:00"
        }
      },
      "status": {
        "day_type": "HOLIDAY",
        "is_open": false
      },
      "timezone": "America/New_York",
      "today_sessions": {}
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "2c3d4e5f-6a7b-8c9d-0e1f-2a3b4c5d6e7f"
  }
}
{
  "data": [
    {
      "current_time": "2025-10-15T14:30:45-04:00",
      "date": "2025-10-15",
      "market": "us_equities",
      "market_name": "US Equities",
      "next_sessions": {
        "after_hours": {
          "close": "2025-10-16T20:00:00-04:00",
          "open": "2025-10-16T16:00:00-04:00"
        },
        "pre_market": {
          "close": "2025-10-16T09:30:00-04:00",
          "open": "2025-10-16T04:00:00-04:00"
        },
        "regular": {
          "close": "2025-10-16T16:00:00-04:00",
          "open": "2025-10-16T09:30:00-04:00"
        }
      },
      "status": {
        "current_session": "regular",
        "day_type": "TRADING_DAY",
        "is_open": true
      },
      "timezone": "America/New_York",
      "today_sessions": {
        "after_hours": {
          "close": "2025-10-15T20:00:00-04:00",
          "open": "2025-10-15T16:00:00-04:00",
          "time_until_open": "PT1H29M15S"
        },
        "pre_market": {
          "close": "2025-10-15T09:30:00-04:00",
          "open": "2025-10-15T04:00:00-04:00"
        },
        "regular": {
          "close": "2025-10-15T16:00:00-04:00",
          "open": "2025-10-15T09:30:00-04:00",
          "time_until_close": "PT1H29M15S"
        }
      }
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "1b2c3d4e-5f6a-7b8c-9d0e-1f2a3b4c5d6e"
  }
}
{
  "data": [
    {
      "current_time": "2025-10-18T12:00:00-04:00",
      "date": "2025-10-18",
      "market": "us_equities",
      "market_name": "US Equities",
      "next_sessions": {
        "after_hours": {
          "close": "2025-10-20T20:00:00-04:00",
          "open": "2025-10-20T16:00:00-04:00"
        },
        "pre_market": {
          "close": "2025-10-20T09:30:00-04:00",
          "open": "2025-10-20T04:00:00-04:00"
        },
        "regular": {
          "close": "2025-10-20T16:00:00-04:00",
          "open": "2025-10-20T09:30:00-04:00"
        }
      },
      "status": {
        "day_type": "WEEKEND",
        "is_open": false
      },
      "timezone": "America/New_York",
      "today_sessions": {}
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "4e5f6a7b-8c9d-0e1f-2a3b-4c5d6e7f8a9b"
  }
}