J-Quants API

空売り残高報告(/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の留意点

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

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

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

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

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

codedisc_datedisc_date_from/disc_date_tocalc_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."
}

Was this page helpful?