売買内訳データ(/markets/breakdown)

売買状況を取得する事ができます

API概要

東証上場銘柄の東証市場における銘柄別の日次売買代金・売買高（立会内取引 に限る）について、信用取引や空売りの利用に関する発注時のフラグ情報を用いて細分化したデータです。

本APIの留意点

• 当該銘柄のコーポレートアクションが発生した場合も、遡及して約定株数の調整は行われません。

• 2020/10/1は東京証券取引所の株式売買システムの障害により終日売買停止となった関係で、データが存在しません。

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

データの取得では、銘柄コード（code）または日付（date）の指定が必須となります。 各パラメータの組み合わせとレスポンスの結果については以下のとおりです。

code	date	from /to	レスポンスの結果
			指定された銘柄について全期間分のデータ
			指定された銘柄について指定された期間分のデータ
			全上場銘柄について指定された日付のデータ

銘柄別の日次売買代金・売買高のデータを取得します

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

データの取得では、銘柄コード（code）または日付（date）の指定が必須となります。

*は必須項目

Query Parameters

Name	Type	Description
code	String	銘柄コード （e.g. 27800 or 2780） 4桁の銘柄コードを指定した場合は、普通株式と優先株式の両方が上場している銘柄においては普通株式のデータのみが取得されます。
from	String	fromの指定 （e.g. 20210901 or 2021-09-01）
to	String	toの指定 （e.g. 20210907 or 2021-09-07）
date	String	fromとtoを指定しないとき （e.g. 20210907 or 2021-09-07）
pagination_key	String	検索の先頭を指定する文字列 過去の検索で返却されたpagination_keyを設定

Headers

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

200: OK

{
    "breakdown": [
        {
            "Date": "2015-04-01", 
            "Code": "13010", 
            "LongSellValue": 115164000.0,
            "ShortSellWithoutMarginValue": 93561000.0, 
            "MarginSellNewValue": 6412000.0, 
            "MarginSellCloseValue": 23009000.0, 
            "LongBuyValue": 185114000.0, 
            "MarginBuyNewValue": 35568000.0, 
            "MarginBuyCloseValue": 17464000.0, 
            "LongSellVolume": 415000.0, 
            "ShortSellWithoutMarginVolume": 337000.0, 
            "MarginSellNewVolume": 23000.0, 
            "MarginSellCloseVolume": 83000.0, 
            "LongBuyVolume": 667000.0, 
            "MarginBuyNewVolume": 128000.0, 
            "MarginBuyCloseVolume": 63000.0
        }
    ],
    "pagination_key": "value1.value2."
}

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
Code	銘柄コード	String
LongSellValue	実売りの約定代金	Number	売りの約定代金の内訳
ShortSellWithoutMarginValue	空売り(信用新規売りを除く)の約定代金	Number	同上
MarginSellNewValue	信用新規売り(新たな信用売りポジションを作るための売り注文)の約定代金	Number	同上
MarginSellCloseValue	信用返済売り(既存の信用買いポジションを閉じるための売り注文)の約定代金	Number	同上
LongBuyValue	現物買いの約定代金	Number	買いの約定代金の内訳
MarginBuyNewValue	信用新規買い(新たな信用買いポジションを作るための買い注文)の約定代金	Number	同上
MarginBuyCloseValue	信用返済買い(既存の信用売りポジションを閉じるための買い注文)の約定代金	Number	同上
LongSellVolume	実売りの約定株数	Number	売りの約定株数の内訳
ShortSellWithoutMarginVolume	空売り(信用新規売りを除く)の約定株数	Number	同上
MarginSellNewVolume	信用新規売り(新たな信用売りポジションを作るための売り注文)の約定株数	Number	同上
MarginSellCloseVolume	信用返済売り(既存の信用買いポジションを閉じるための売り注文)の約定株数	Number	同上
LongBuyVolume	現物買いの約定株数	Number	買いの約定株数の内訳
MarginBuyNewVolume	信用新規買い(新たな信用買いポジションを作るための買い注文)の約定株数	Number	同上
MarginBuyCloseVolume	信用返済買い(既存の信用売りポジションを閉じるための買い注文)の約定株数	Number	同上

APIコールサンプルコード

Curl

idToken=<YOUR idToken> && curl https://api.jquants.com/v1/markets/breakdown?code=86970&date=20230324 -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/breakdown?code=86970&date=20230324", headers=headers)
r.json()