# 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](https://www.jpx.co.jp/english/markets/public/short-selling/index.html) ### Attention > **Info** > > - 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](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: – → All historical data of a specific issue. - code: ✓, disc\_date: ✓, disc\_date\_from/disc\_date\_to: –, calc\_date: – → Data of a specific issue for the specific date (DisclosedDate). - code: ✓, disc\_date: –, disc\_date\_from/disc\_date\_to: ✓, calc\_date: – → Data of a specific issue for the specified period. - code: ✓, disc\_date: –, disc\_date\_from/disc\_date\_to: –, calc\_date: ✓ → Data of a specific issue for the specific date (CalculatedDate). - code: –, disc\_date: ✓, disc\_date\_from/disc\_date\_to: –, calc\_date: – → Data for all listed issues on the specified date (DisclosedDate). - code: –, disc\_date: –, disc\_date\_from/disc\_date\_to: –, calc\_date: ✓ → Data for all listed issues on the specified date (CalculatedDate). ### Requests ### Headers | Parameter | Type | Required | Description | | --------- | ------ | -------- | ----------- | | x-api-key | string | Required | API Key | ### Query Parameters > **Note** > > At least one of **code** / **disc\_date** / **calc\_date** must be specified. | Parameter | Type | Required | Description | | ---------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | code | string | Optional | 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\_date | string | Optional | Date of Disclosure (e.g. 20240301 or 2024-03-01) | | disc\_date\_from | string | Optional | Starting point of data period (e.g. 20240301 or 2024-03-01) | | disc\_date\_to | string | Optional | End point of data period (e.g. 20240301 or 2024-03-01) | | calc\_date | string | Optional | Date of Calculation (e.g. 20240301 or 2024-03-01) | | pagination\_key | string | Optional | 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 /v2/markets/short-sale-report **cURL** ```bash curl -G https://api.jquants.com/v2/markets/short-sale-report \ -H "x-api-key: {{apiKey}}" \ -d code="{{code}}" \ -d calc_date="{{calc_date}}" ``` **JavaScript** ```javascript import axios from 'axios' const client = axios.create({ baseURL: "https://api.jquants.com", headers: { "x-api-key": "{{apiKey}}" }, }) await client.get("/v2/markets/short-sale-report", { params: { code: '{{code}}', calc_date: '{{calc_date}}', }, }) ``` **Python** ```python import requests headers = {"x-api-key": "{{apiKey}}"} resp = requests.get( "https://api.jquants.com/v2/markets/short-sale-report", params={"code": "{{code}}", "calc_date": "{{calc_date}}"}, headers=headers, ) print(resp.json()) ``` ### Responses ### Data Item | Parameter | Type | Required | Description | | ------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | DiscDate | string | Required | Date of Disclosure (YYYY-MM-DD) | | CalcDate | string | Required | Date of Calculation (YYYY-MM-DD) | | Code | string | Required | Issue code (5-character) | | SSName | string | Required | 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. | | SSAddr | string | Required | Address of Short Seller | | DICName | string | Required | Name of Discretionary Investment Contractor | | DICAddr | string | Required | Address of Discretionary Investment Contractor | | FundName | string | Required | Name of Investment Fund | | ShrtPosToSO | number | Required | Ratio of Short Positions to Shares Outstanding | | ShrtPosShares | number | Required | Number of Short Positions in Shares | | ShrtPosUnits | number | Required | Number of Short Positions in Trading Units | | PrevRptDate | string | Required | Date of Calculation in Previous Reporting (YYYY-MM-DD) | | PrevRptRatio | number | Required | Ratio of Short Positions in Previous Reporting | | Notes | string | Required | Notes | ### Response Sample ```bash {{ title: "200:OK" }} { "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." } ```