Market calendar and trading sessions

What is this endpoint for?

This endpoint offers supplementary market calendar and trading session reference data for user subscribing to Capital Market Reference Rates from Kaiko. Users can query by date range, exchange code, region, asset class, or trading status to retrieve a full breakdown of trading sessions alongside holiday flags, regular trading day indicators, and the previous and next regular trading days. Data is sourced from TradingHours.com and maintained by Kaiko, with ad hoc updates when new exchanges are onboarded.

Endpoints

gRPC

gateway.equ.kaiko.io:443 kaiko.equities.EquitiesService/MarketCalendarV2

Request fields

Parameter	Required	Description	Example
start_date	Yes	Start date (yyyy-mm-dd) Cannot be earlier than 30 days before today.	2026-03-31
end_date	Yes	End date (yyyy-mm-dd) Cannot be later than 30 days before today.	2026-04-01
asset_class	Yes	Asset class of the market to filter and aggregate results by.	equities, futures
region	No	IANA timezone string to filter and aggregate results by the timezone.	America/New_York, Asia/Hong_Kong, Asia/Seoul
exch	No	List of exchange MIC codes	["XNYS", "BOAT"] Supported exchanges: "XNYS", "XNAS", "BOAT" , "XKRX", "XHKG"
status	No	List of trading statuses	["OPEN_REGULAR", "OPEN_IRREGULAR"]
is_holiday	No	When set to true, returns only dates designated as holidays. When set to false, returns only non-holiday dates.	true

Response fields

timezone	IANA timezone of the exchange.
asset_class	Asset class of the returned data.
data	List of daily market calendar entries.
.date	Date of the entry (yyyy-mm-dd).
.marketMics	List of exchange MIC codes included in the returned data.
.status	Trading status for the date. OPEN_REGULAR : If it is regular trading day OPEN_IRREGULAR : If there is any time changes CLOSED : If it is closed
.isHoliday	true if the date is a weekend or public holiday.
.isTradingDay	true if the status is OPEN_REGULAR or OPEN_IRREGULAR.
.isRegularTradingDay	true if the session schedule includes a Primary Trading Session.
.reason	Description of the holiday or irregular closure. Empty on regular trading days.
.previousRegularTradingDay	Most recent regular trading day within the query range.
.nextRegularTradingDay	Next regular trading day within the query range.
.sessionSchedule	List of trading sessions for the date. Empty if the market is closed.
.exchanges	MIC code of the exchange for this session.
.phase_type	Type of trading session (e.g. Primary Trading Session, Overnight Trading Session).
.description	Detailed description of the session phase.
.start	Session start time in local time
.end	Session end time in local time
.is_trading	true if trading activity occurs during this session.

Request examples

cURL

cURL requests are intended for testing purposes only.

grpcurl \
 -H "Authorization: Bearer $KAIKO_API_KEY" \
 -d @ gateway.equ.kaiko.io:443 kaiko.equities.EquitiesService/MarketCalendarV2 <<EOM
{
  "start_date": "2026-03-23",
  "end_date": "2026-03-25",
  "asset_class": "equities",
  "exch":["XNAS","BOAT"],
  "region":"America/New_York",
  "status":["OPEN_REGULAR"],
  "is_holiday":false
}
EOM

Response Example

{
  "marketCalendars": [
    {
      "timezone": "America/New_York",
      "data": [
        {
          "date": "2026-04-02",
          "marketMics": [
            "BOAT",
            "XNYS"
          ],
          "status": "OPEN_REGULAR",
          "isTradingDay": true,
          "isRegularTradingDay": true,
          "sessionSchedule": [
            {
              "exchanges": [
                "XNYS"
              ],
              "phaseType": "Pre-Trading Session",
              "description": "Pre-Trading Session",
              "start": "2026-04-02T04:00:00-04:00",
              "end": "2026-04-02T09:30:00-04:00",
              "isTrading": true
            },
            {
              "exchanges": [
                "XNYS"
              ],
              "phaseType": "Primary Trading Session",
              "description": "Core Trading Session",
              "start": "2026-04-02T09:30:00-04:00",
              "end": "2026-04-02T16:00:00-04:00",
              "isTrading": true
            },
            {
              "exchanges": [
                "XNYS"
              ],
              "phaseType": "Post-Trading Session",
              "description": "Extended Hours",
              "start": "2026-04-02T16:00:00-04:00",
              "end": "2026-04-02T20:00:00-04:00",
              "isTrading": true
            }
          ]
        }
      ],
      "assetClass": "equities"
    }
  ]
}