空売り残高報告(/markets/short-sale-report)

GET /v2/markets/short-sale-report

APIの概要

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

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

本APIの留意点

取引参加者から該当する報告が行われなかった日にはデータは提供されません。
欠損値・レコード不在について：
- 残高割合0.5％以上の報告を受けたもののみを収録しているため、レコードが存在しないことは残高ゼロを意味しません。報告基準未満または未報告と区別してお取り扱いください。
本APIは、JPXウェブサイトで公表されている「空売りの残高に関する情報」と同様のデータを配信しており、配信・収録側で重複排除等の加工は行っておりません。稀に、すべての項目が一致する重複レコードが存在する場合がありますが、原データの内容がそのまま反映されたものになります。
各レコードを一意に識別するキー項目は提供しておりません。
「有価証券の取引等の規制に関する内閣府令について」はこちらをご覧ください。https://www.jpx.co.jp/markets/public/short-selling/01.html

データ不備・不足等によるデータの追加・上書き修正の履歴については、データ修正履歴・制約事項をご参照ください。
データ仕様について過去にお問い合わせのあった内容は、FAQ（データ内容・仕様）にも記載しておりますので、あわせてご参照ください。

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

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

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

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

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

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

Requests

Headers

x-api-keystringrequired: APIキー

Query Parameters

code / disc_date / calc_date のいずれか一つ以上の指定が必須です。

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

APIコールサンプルコード

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

データ項目概要

DiscDatestring: 日付（公表日, YYYY-MM-DD）
CalcDatestring: 日付（計算日, YYYY-MM-DD）
Codestring: 銘柄コード
5桁コード
SSNamestring: 商号・名称・氏名
取引参加者から報告されたものをそのまま記載しているため、日本語名称または英語名称が混在しています。
SSAddrstring: 住所・所在地
DICNamestring: 委託者・投資一任契約の相手方の商号・名称・氏名
DICAddrstring: 委託者・投資一任契約の相手方の住所・所在地
FundNamestring: 信託財産・運用財産の名称
ShrtPosToSOnumber: 空売り残高割合
ShrtPosSharesnumber: 空売り残高数量
ShrtPosUnitsnumber: 空売り残高売買単位数
PrevRptDatestring: 直近計算年月日（YYYY-MM-DD）
PrevRptRationumber: 直近空売り残高割合
Notesstring: 備考
原データにおいて重複した報告が行われた場合、後日に当該重複を取り消すレコードが公表・配信されることがあります。その際は本項目にその旨が記載されます。

レスポンスサンプル

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