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

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.

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.
fromstringoptional: Starting point of data period (e.g. 20210901 or 2021-09-01)
tostringoptional: End point of data period (e.g. 20210907 or 2021-09-07)

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"
        }
    ]
}