空売り残高報告(/markets/short_selling_positions)

空売り残高報告データを取得できます

API概要

「有価証券の取引等の規制に関する内閣府令」に基づき、取引参加者より報告を受けたもののうち、残高割合が0.5％以上のものについての情報を取得できます。

配信データは下記のページで公表している内容と同一ですが、より長いヒストリカルデータを利用可能です。 https://www.jpx.co.jp/markets/public/short-selling/index.html

本APIの留意点

• 取引参加者から該当する報告が行われなかった日にはデータは提供されません。

• 「有価証券の取引等の規制に関する内閣府令について」はこちらをご覧ください。https://www.jpx.co.jp/markets/public/short-selling/01.html

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

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

code	disclosed_date	disclosed_date_from/disclosed_date_to	calculated_date	レスポンスの結果
				指定された銘柄について全期間分のデータ
				指定された銘柄について指定日（公表日）のデータ
				指定された銘柄について指定された期間のデータ
				指定された銘柄について指定日（計算日）のデータ
				指定日（公表日）の全ての銘柄のデータ
				指定日（計算日）の全ての銘柄のデータ

空売り残高報告データを取得します

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

データの取得では、銘柄コード（code）、公表日（disclosed_date）、計算日（caldulated_date）のいずれかの指定が必須となります。

*は必須項目

Query Parameters

Name	Type	Description
code	String	4桁もしくは5桁の銘柄コード （e.g. 8697 or 86970） 4桁の銘柄コードを指定した場合は、普通株式と優先株式の両方が上場している銘柄においては普通株式のデータのみが取得されます。
disclosed_date	String	公表日の指定 （e.g. 20240301 or 2024-03-01）
disclosed_date_from	String	公表日のfromの指定 （e.g. 20240301 or 2024-03-01）
disclosed_date_to	String	公表日のtoの指定 （e.g. 20240301 or 2024-03-01）
calculated_date	String	計算日の指定 （e.g. 20240301 or 2024-03-01）
pagination_key	String	検索の先頭を指定する文字列 過去の検索で返却されたpagination_keyを設定

Headers

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

200: OK

{
    "short_selling_positions": [
      {
        "DisclosedDate": "2024-08-01",
        "CalculatedDate": "2024-07-31",
        "Code": "13660",
        "ShortSellerName": "個人",
        "ShortSellerAddress": "",
        "DiscretionaryInvestmentContractorName": "",
        "DiscretionaryInvestmentContractorAddress": "",
        "InvestmentFundName": "",
        "ShortPositionsToSharesOutstandingRatio": 0.0053,
        "ShortPositionsInSharesNumber": 140000,
        "ShortPositionsInTradingUnitsNumber": 140000,
        "CalculationInPreviousReportingDate": "2024-07-22",
        "ShortPositionsInPreviousReportingRatio": 0.0043,
        "Notes": ""
      }
    ],
    "pagination_key": "value1.value2."
}

400: Bad Request

{
    "message": <Error Message>
}

401: Unauthorized

{
    "message": "The incoming token is invalid or expired."
}

403: Forbidden

{
    "message": <Error Message>
}

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

データ項目概要

変数名	説明	型	備考
DisclosedDate	日付（公表日）	String	YYYY-MM-DD
CalculatedDate	日付（計算日）	String	YYYY-MM-DD
Code	銘柄コード	String	5桁コード
ShortSellerName	商号・名称・氏名	String	"ShortSellerName"は、取引参加者から報告されたものをそのまま記載しているため、日本語名称または英語名称が混在しています。
ShortSellerAddress	住所・所在地	String
DiscretionaryInvestmentContractorName	委託者・投資一任契約の相手方の商号・名称・氏名	String
DiscretionaryInvestmentContractorAddress	委託者・投資一任契約の相手方の住所・所在地	String
InvestmentFundName	信託財産・運用財産の名称	String
ShortPositionsToSharesOutstandingRatio	空売り残高割合	Number
ShortPositionsInSharesNumber	空売り残高数量	Number
ShortPositionsInTradingUnitsNumber	空売り残高売買単位数	Number
CalculationInPreviousReportingDate	直近計算年月日	String	YYYY-MM-DD
ShortPositionsInPreviousReportingRatio	直近空売り残高割合	Number
Notes	備考	String

APIコールサンプルコード

Curl

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