Breakdown Trading Data (/markets/breakdown)

GET /v2/markets/breakdown

Overview

Detail Breakdown Trading Data is extracted from daily trading values and volumes (only regular trading sessions on the TSE market) per TSE-listed issue based on flags for margin transactions and short selling that are attached to orders at the time of placement.

Attention

Even in the event of a corporate action for the issue, items of volume will not be retrospectively adjusted.
The data for Oct, 1st 2020 does not exist because trading was halted all day due to the failure of the equity trading system.

Get daily trading values and volumes

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

In your request message, either "code" or "date" must be specified.

Parameter and Response

In your request message, either "code" or "date" must be specified.
Combination of parameter in the request and results are as below.

code	date	from /to	Results
			All historical data of a specific issue.
			Data of a specific issue for a specific date.
			Data of a specific issue for the specified period.
			All listed issue data for the specific date.

Requests

Headers

x-api-keystringrequired: API Key

Query Parameters

Either code or date must be specified.

codestringoptional: Issue code (e.g. 27800 or 2780)
If a 4-character issue code is specified, only the data of common stock will be obtained for the issue on which both common and preferred stocks are listed.
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)
datestringoptional: Date of data when from and to are not specified (e.g. 20210907 or 2021-09-07)
pagination_keystringoptional: The primary key of the first item that this operation will evaluate. Use the value that was returned for pagination_key in the previous operation.

Sample Code

Request

GET

/v2/markets/breakdown

curl -G https://api.jquants.com/v2/markets/breakdown \
-H "x-api-key: {loading}" \
-d code="86970" \
-d date="20230324"

Responses

Data Item

Datestring: Trade date (YYYY-MM-DD)
Codestring: Issue code
LongSellVanumber: Long selling trading value
Breakdown of sell trading value
ShrtNoMrgnVanumber: Trading value of short selling (excluding new margin sell)
Breakdown of sell trading value
MrgnSellNewVanumber: Trading value of new margin selling (sell orders that create new margin sell positions)
Breakdown of sell trading value
MrgnSellCloseVanumber: Trading value of closing margin selling (sell orders that close existing margin buy positions)
Breakdown of sell trading value
LongBuyVanumber: Long buying Trading value
Breakdown of buy trading value
MrgnBuyNewVanumber: Trading value of new margin buying (buy orders that create new margin buy positions)
Breakdown of buy trading value
MrgnBuyCloseVanumber: Closing margin buying (buy orders that close existing margin sell positions)
Breakdown of buy trading value
LongSellVonumber: Long selling Trading volume
Breakdown of sell trading volume
ShrtNoMrgnVonumber: Trading volume of short selling (excluding new margin selling)
Breakdown of sell trading volume
MrgnSellNewVonumber: Trading volume of new margin selling (sell orders that create new margin sell positions)
Breakdown of sell trading volume
MrgnSellCloseVonumber: Closing margin selling (sell orders that close existing margin buy positions) Trading volume
Breakdown of sell trading volume
LongBuyVonumber: Long buying Trading volume
Breakdown of buy trading volume
MrgnBuyNewVonumber: Trading volume of new margin buying (buy orders that create new margin buy positions)
Breakdown of buy trading volume
MrgnBuyCloseVonumber: Trading volume of closing margin buying (buy orders that close existing margin sell positions)
Breakdown of buy trading volume

Sample Response

{
    "data": [
        {
            "Date": "2015-04-01",
            "Code": "13010",
            "LongSellVa": 115164000.0,
            "ShrtNoMrgnVa": 93561000.0,
            "MrgnSellNewVa": 6412000.0,
            "MrgnSellCloseVa": 23009000.0,
            "LongBuyVa": 185114000.0,
            "MrgnBuyNewVa": 35568000.0,
            "MrgnBuyCloseVa": 17464000.0,
            "LongSellVo": 415000.0,
            "ShrtNoMrgnVo": 337000.0,
            "MrgnSellNewVo": 23000.0,
            "MrgnSellCloseVo": 83000.0,
            "LongBuyVo": 667000.0,
            "MrgnBuyNewVo": 128000.0,
            "MrgnBuyCloseVo": 63000.0
        }
    ],
    "pagination_key": "value1.value2."
}