Reference data - 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 Reference Rates from the following asset classes:

• Equity (unless "instrument type" is "futures")

• Fixed income

• Foreign exchange

• Commodities

• Real estate

• Digital assets

Data is sourced from TradingHours.com and maintained by Kaiko, with 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 1 month before today.	2026-03-31
end_date	Yes	End date (yyyy-mm-dd) Cannot be later than 1 month before today.	2026-04-01
asset_class	Yes (one of)	Asset class of the market to filter and aggregate results by.	equities, future
asset_calendar	Yes (one of)	Asset calendar of the market to filter and aggregate results by. Relevant input for each rate is available in reference data.	gold, oil
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 $EQUITY_KAIKO_KEY"\
  -d '{
    "start_date": "2026-05-19",
    "end_date": "2026-05-20",
    "asset_calendar": "equities",
    "region": "America/New_York"
  }' \
  gateway.equ.kaiko.io:443 kaiko.equities.EquitiesService/MarketCalendarV2

Response Example

{
  "marketCalendars": [
    {
      "timezone": "America/New_York",
      "data": [
        {
          "date": "2026-05-19",
          "marketMics": [
            "BOAT",
            "XNAS",
            "XNYS"
          ],
          "status": "OPEN_REGULAR",
          "isTradingDay": true,
          "isRegularTradingDay": true,
          "nextRegularTradingDay": "2026-05-20T00:00:00-04:00",
          "sessionSchedule": [
            {
              "exchanges": [
                "XNAS",
                "XNYS"
              ],
              "phaseType": "Pre-Trading Session",
              "description": "Opening Session",
              "start": "2026-05-19T04:00:00-04:00",
              "end": "2026-05-19T09:30:00-04:00",
              "isTrading": true
            },
            {
              "exchanges": [
                "XNAS",
                "XNYS"
              ],
              "phaseType": "Primary Trading Session",
              "description": "Core Trading Session",
              "start": "2026-05-19T09:30:00-04:00",
              "end": "2026-05-19T16:00:00-04:00",
              "isTrading": true
            },
            {
              "exchanges": [
                "XNAS",
                "XNYS"
              ],
              "phaseType": "Post-Trading Session",
              "description": "Extended Trading Close",
              "start": "2026-05-19T16:00:00-04:00",
              "end": "2026-05-19T20:00:00-04:00",
              "isTrading": true
            },
            {
              "exchanges": [
                "BOAT"
              ],
              "phaseType": "Overnight Trading Session",
              "description": "Overnight Trading Session",
              "start": "2026-05-19T20:00:00-04:00",
              "end": "2026-05-20T04:00:00-04:00",
              "isTrading": true
            }
          ]
        },
        {
          "date": "2026-05-20",
          "marketMics": [
            "BOAT",
            "XNAS",
            "XNYS"
          ],
          "status": "OPEN_REGULAR",
          "isTradingDay": true,
          "isRegularTradingDay": true,
          "previousRegularTradingDay": "2026-05-19T00:00:00-04:00",
          "sessionSchedule": [
            {
              "exchanges": [
                "XNAS",
                "XNYS"
              ],
              "phaseType": "Pre-Trading Session",
              "description": "Opening Session",
              "start": "2026-05-20T04:00:00-04:00",
              "end": "2026-05-20T09:30:00-04:00",
              "isTrading": true
            },
            {
              "exchanges": [
                "XNAS",
                "XNYS"
              ],
              "phaseType": "Primary Trading Session",
              "description": "Core Trading Session",
              "start": "2026-05-20T09:30:00-04:00",
              "end": "2026-05-20T16:00:00-04:00",
              "isTrading": true
            },
            {
              "exchanges": [
                "XNAS",
                "XNYS"
              ],
              "phaseType": "Post-Trading Session",
              "description": "Extended Trading Close",
              "start": "2026-05-20T16:00:00-04:00",
              "end": "2026-05-20T20:00:00-04:00",
              "isTrading": true
            },
            {
              "exchanges": [
                "BOAT"
              ],
              "phaseType": "Overnight Trading Session",
              "description": "Overnight Trading Session",
              "start": "2026-05-20T20:00:00-04:00",
              "end": "2026-05-21T04:00:00-04:00",
              "isTrading": true
            }
          ]
        }
      ],
      "assetClass": "equities"
    }
  ]
}