Trading Calendar　(/markets/trading_calendar)

You can obtain information on market business days, holidays in TSE/OSE market, and the availability of holiday trading in OSE market.

Overview

You can obtain information on market business days, holidays in TSE/OSE market, and the availability of holiday trading in OSE market. This data is also available via the following site. 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

• The business days and holiday trading dates (tentative) for the following year will be updated around the end of March of each year.

Parameter and Response

In your request message, either "holiday division" or "from/to" can be specified. Combination of parameter in the request and results are as below.

holiday division	from /to	Result
		Data for the entire period for the specified holiday division.
		Data for a specified period for a specified holiday division.
		Data for a specified period.
		Data for the entire period.

Please refer to the following link for the parameters that can be specified for holidaydivision.

pageHoliday division

Get business day data.

GET https://api.jquants.com/v1/markets/trading_calendar

Either "holiday division" or "from/to" can be specified.

"*" Required.

Query Parameters

Name	Type	Description
holidaydivision	String	holiday division
from	String	starting point of data period （e.g. 20210901 or 2021-09-01）
to	String	end point of data period （e.g. 20210907 or 2021-09-07）

Headers

Name	Type	Description
Authorization*	String	Access key

200: OK

{
    "trading_calendar": [
        {
            "Date": "2015-04-01", 
            "HolidayDivision": "1"
        }
    ]
}

400: Bad Request

{
    "message": "<Error Message>"
}

401: Unauthorized

{
    "message": "The incoming token is invalid or expired."
}

403: Forbidden

{
    "message": "Missing Authentication Token. The method or resources may not be supported."
}

500: Internal Server Error

{
    "message": "Unexpected error. Please try again later."
}

413: Payload Too Large

{
    "message": "Response data is too large. Specify parameters to reduce the acquired data range."
}

Data Item

Variable	Description	Data type	Remark
Date	date	String	YYYY-MM-DD
HolidayDivision	holiday division	String	See Holiday division

Sample Code

Curl

idToken=<YOUR idToken> && curl https://api.jquants.com/v1/markets/trading_calendar?holidaydivision=1&from=20220101&to=20221231 -H "Authorization: Bearer $idToken" 

Python

import requests
import json

idToken = "YOUR idToken"
headers = {'Authorization': 'Bearer {}'.format(idToken)}
r = requests.get("https://api.jquants.com/v1/markets/trading_calendar?holidaydivision=1&from=20220101&to=20221231", headers=headers)
r.json()