Trading Calendar (/markets/calendar)

GET /v2/markets/calendar

Overview

Information on business days and non-business days at the Tokyo Stock Exchange (TSE) and Osaka Exchange (OSE), as well as whether holiday trading is conducted at OSE, can be obtained.
The delivered data is the same as the content published on the following pages.

Market Holidays: https://www.jpx.co.jp/english/corporate/about-jpx/calendar/index.html
Holiday Trading: https://www.jpx.co.jp/english/derivatives/rules/holidaytrading/index.html

Attention

Business days and non-business days at TSE and OSE, TSE half-day trading sessions, and whether holiday trading is conducted at OSE are provided as a single calendar, not split by market.
All calendar days, including weekends and public holidays, are covered. Non-business days are recorded with holiday division "0".
As a rule, the business days and holiday trading days (planned) for the following year will be updated around the end of March each year. Update histories and publication times are not provided.
As a rule, holiday divisions are not corrected. The calendar data has no per-record version number, correction flag, or correction identifier, so the response cannot be used to determine directly whether a correction has been made.
The response contains only Date and HolDiv. No revision ID or update-timestamp field is provided, and no ETag or Last-Modified header is attached.
No data item indicating regular trading session hours is provided.
There is no pagination limit specific to this API. For the common specification, see Response Pagination.

We do not provide the date and time when each data item became available on J-Quants. For update frequency and approximate update times, see Update Timing of Provided Data.
Questions we have received about data specifications are also answered in the FAQ (Data & Specs).

Data correction policy

In this service, we may add or overwrite data due to data deficiencies or omissions. In such cases, the correction history is recorded on Data Correction History and Known issues, so please refer to it.
Note: In these cases, neither the correction history nor pre-correction data is provided via the API, CSV, or other means.

Get business days data

GET https://api.jquants.com/v2/markets/calendar

You can specify a holiday division (hol_div) or date period (from/to).

Parameter and Response

You can specify a holiday division (hol_div) or date period (from/to).
The combination of each parameter and the results of the response are as below.

hol_div	from /to	Results
		All data for the specified holiday division.
		Data for the specified holiday division for the specified period.
		Data for the specified period.
		All data.

Requests

Headers

x-api-keystringrequired: API Key

Query Parameters

hol_divstringoptional: Holiday division
For a list of possible values, please see here.
Use this parameter to narrow the result to business days only, or to a specific division only.
fromstringoptional: Starting point of data period (e.g. 20210901 or 2021-09-01)
The specified date is included in the extracted period (both ends are inclusive).
tostringoptional: End point of data period (e.g. 20210907 or 2021-09-07)
The specified date is included in the extracted period (both ends are inclusive). The same date as from may also be specified.

Sample Code

Request

GET

/v2/markets/calendar

curl -G https://api.jquants.com/v2/markets/calendar \
-H "x-api-key: {loading}" \
-d hol_div="1" \
-d from="20220101" \
-d to="20221231"

Responses

Data Item

Datestring: Date (YYYY-MM-DD)
HolDivstring: Holiday division
See Holiday division

Sample Response

{
    "data": [
        {
            "Date": "2015-04-01",
            "HolDiv": "1"
        }
    ]
}