Outstanding Short Selling Positions Reported (/markets/short-sale-report)

GET /v2/markets/short-sale-report

Overview

This data covers the outstanding short selling position ratio is 0.5% or more of those reported by trading participants in accordance with the "Cabinet Office Order on Restrictions on Securities Transactions".

This data is the same as the following site but has a longer history.
https://www.jpx.co.jp/english/markets/public/short-selling/index.html

Attention

Data will not be provided on days when no applicable reports are made by trading participants.
Please click here for the "Cabinet Office Order on Restrictions on Securities Transactions": https://www.jpx.co.jp/english/markets/public/short-selling/01.html

Get Outstanding Short Selling Positions Reported

GET https://api.jquants.com/v2/markets/short-sale-report

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

Parameter and Response

In your request message, either "code", "disc_date" or "calc_date" must be specified.
The combination of each parameter and the results of the response are as below.

code	disc_date	disc_date_from/disc_date_to	calc_date	Results
				All historical data of a specific issue.
				Data of a specific issue for the specific date (DisclosedDate).
				Data of a specific issue for the specified period.
				Data of a specific issue for the specific date (CalculatedDate).
				Data for all listed issues on the specified date (DisclosedDate).
				Data for all listed issues on the specified date (CalculatedDate).

Requests

Headers

x-api-keystringrequired: API Key

Query Parameters

At least one of code / disc_date / calc_date must be specified.

codestringoptional: 4 or 5 character issue code (e.g. 8697 or 86970)
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.
disc_datestringoptional: Date of Disclosure (e.g. 20240301 or 2024-03-01)
disc_date_fromstringoptional: Starting point of data period (e.g. 20240301 or 2024-03-01)
disc_date_tostringoptional: End point of data period (e.g. 20240301 or 2024-03-01)
calc_datestringoptional: Date of Calculation (e.g. 20240301 or 2024-03-01)
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/short-sale-report

curl -G https://api.jquants.com/v2/markets/short-sale-report \
-H "x-api-key: {loading}" \
-d code="86970" \
-d calc_date="20240801"

Responses

Data Item

DiscDatestring: Date of Disclosure (YYYY-MM-DD)
CalcDatestring: Date of Calculation (YYYY-MM-DD)
Codestring: Issue code (5-character)
SSNamestring: Name of Short Seller
The value is listed as reported by market participants, so both Japanese and English names are mixed. Please note that "個人" refers to individual investor.
SSAddrstring: Address of Short Seller
DICNamestring: Name of Discretionary Investment Contractor
DICAddrstring: Address of Discretionary Investment Contractor
FundNamestring: Name of Investment Fund
ShrtPosToSOnumber: Ratio of Short Positions to Shares Outstanding
ShrtPosSharesnumber: Number of Short Positions in Shares
ShrtPosUnitsnumber: Number of Short Positions in Trading Units
PrevRptDatestring: Date of Calculation in Previous Reporting (YYYY-MM-DD)
PrevRptRationumber: Ratio of Short Positions in Previous Reporting
Notesstring: Notes

Response Sample

{
    "data": [
      {
        "DiscDate": "2024-08-01",
        "CalcDate": "2024-07-31",
        "Code": "13660",
        "SSName": "個人",
        "SSAddr": "",
        "DICName": "",
        "DICAddr": "",
        "FundName": "",
        "ShrtPosToSO": 0.0053,
        "ShrtPosShares": 140000,
        "ShrtPosUnits": 140000,
        "PrevRptDate": "2024-07-22",
        "PrevRptRatio": 0.0043,
        "Notes": ""
      }
    ],
    "pagination_key": "value1.value2."
}