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.
Missing values and absent records:
- Since only reports with an outstanding short selling position ratio of 0.5% or more are recorded, the absence of a record does not mean that the position is zero. Please treat it as distinct from a position below the reporting threshold or an unreported position.
This API distributes data equivalent to the outstanding short selling positions published on the JPX website. No processing such as deduplication is performed on the distribution or recording side. In rare cases, duplicate records in which all items match may exist, but they are a direct reflection of the contents of the source data.
No item is provided to uniquely identify each record.
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

We do not provide the date and time when each data item became available on J-Quants. For update frequency and approximate update times, see Update Timing of Provided Data.
Questions we have received about data specifications are also answered in the FAQ (Data & Specs).

Data correction policy

In this service, we may add or overwrite data due to data deficiencies or omissions. In such cases, the correction history is recorded on Data Correction History and Known issues, so please refer to it.
Note: In these cases, neither the correction history nor pre-correction data is provided via the API, CSV, or other means.

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
If duplicate reports were made in the source data, a record canceling the duplication may be published and distributed at a later date. In that case, a note to that effect is included in this item.

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