---
title: "Reference Market Holidays"
method: GET
path: "/market-holidays"
tags: ["market-data"]
---

# Reference Market Holidays

`GET /market-holidays`

## Request

- Base URL: `https://api.qfex.com`
- URL: `https://api.qfex.com/market-holidays`
- Auth: none required

Return reference-market holiday dates from the calendar used by QFEX Slack alerts. Dates are local calendar dates, not UTC closure timestamps. These are not QFEX trading halts or instrument-specific session schedules; US futures may have shortened sessions on these dates. Weekends and early closes are not separately listed. Check incomplete_markets before interpreting an empty result. No authentication is required. See /refdata for symbol market_hours and /calendar for earnings and economic events.

## Query parameters

- `from` string, date, required: First holiday date, inclusive (YYYY-MM-DD).
- `to` string, date, required: Last holiday date, inclusive. Maximum 366 days per request.
- `market` 'us_equities' | 'us_futures' | 'kr_equities' | 'se_equities' | 'jp_equities' | 'cn_equities': Optional reference market. Omit to return all markets.
- `api_version` string

## Response `200`

OK

- MarketHolidaysData
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `coverage` MarketHolidayCoverage[], nullable, required: Available snapshot windows for selected markets, independent of the requested dates.
    - `from` string, date, required
    - `market` string, required
    - `market_name` string, required
    - `to` string, date, required
  - `holidays` MarketHoliday[], nullable, required
    - `date` string, date, required
    - `market` string, required
    - `name` string, required
  - `incomplete_markets` string[], nullable, required: Markets without calendar coverage for every requested date. Missing dates do not imply that a market is open.
  - `source_sha256` string, required: SHA-256 of the Entimos Slack holiday calendar source used to generate this snapshot.

## Other responses

- `default`: Error

## Changes

- **2026-11-03** `0c23dfc24573`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/qfex/apis/qfex-rest-api/changes/market-holidays/get.md)

---

[API](https://skmtc.dev/qfex/apis/qfex-rest-api.md) - [All operations](https://skmtc.dev/qfex/apis/qfex-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/qfex/apis/qfex-rest-api/revisions/0c23dfc24573?raw)