取引カレンダー(/markets/trading_calendar)

東証およびOSEにおける営業日、休業日、ならびにOSEにおける祝日取引の有無の情報を取得できます。

取引カレンダーAPI概要

東証およびOSEにおける営業日、休業日、ならびにOSEにおける祝日取引の有無の情報を取得できます。 配信データは下記のページで公表している内容と同様です。 休業日一覧 https://www.jpx.co.jp/corporate/about-jpx/calendar/index.html 祝日取引実施日 https://www.jpx.co.jp/derivatives/rules/holidaytrading/index.html

本APIの留意点

• 原則として、毎年3月末頃をめどに翌年1年間の営業日および祝日取引実施日（予定）を更新します。

パラメータ及びレスポンス

データの取得では、休日区分（holidaydivision）または日付（from/to）の指定が可能です。 各パラメータの組み合わせとレスポンスの結果については以下のとおりです。

holidaydivision	from /to	レスポンスの結果
		指定された休日区分について全期間分のデータ
		指定された休日区分について指定された期間分のデータ
		指定された期間分のデータ
		全期間分のデータ

休日区分（holidaydivision）で指定可能なパラメータについてはこちらを参照ください。

休日区分

営業日のデータを取得します

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

データの取得では、休日区分（holidaydivision）または日付（from/to）の指定が可能です。

*は必須項目

Query Parameters

Name	Type	Description
holidaydivision	String	休日区分
from	String	fromの指定 （e.g. 20210901 or 2021-09-01）
to	String	toの指定 （e.g. 20210907 or 2021-09-07）

Headers

Name	Type	Description
Authorization*	String	アクセスキー

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

データ項目概要

変数名	説明	型	備考
Date	日付	String	YYYY-MM-DD
HolidayDivision	休日区分	String	休日区分を参照

APIコールサンプルコード

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()