Margin Trading Outstandings (/markets/margin-interest)

GET /v2/markets/margin-interest

Overview

Weekly margin trading outstandings (number of shares) as of the last business day of each week is available.

This data is also available via the following site.
https://www.jpx.co.jp/english/markets/statistics-equities/margin/index.html

Attention

Even in the event of a corporate action for the issue, items of trading volume will not be retrospectively adjusted.
No data is provided for weeks with two or fewer business days like New Year's holiday.
Stocks that are not listed on the TSE (including issue listed only on the other exchanges) are not included in the data.

Get weekly margin trading outstandings

GET https://api.jquants.com/v2/markets/margin-interest

Either "code" or "date" must be specified.

Parameter and Response

Either "code" or "date" must be specified.
Combination of parameter in the request and results are as below.

code	date	from /to	Results
			All historical data of a specific issue.
			Data of a specific issue for the specific date.
			Data of a specific issue for the specified period.
			All listed issue data for the specific date.

Requests

Headers

x-api-keystringrequired: API Key

Query Parameters

Either code or date must be specified.

codestringoptional: Issue code (e.g. 27800 or 2780)
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.
fromstringoptional: Starting point of data period (e.g. 20210901 or 2021-09-01)
tostringoptional: End point of data period (e.g. 20210907 or 2021-09-07)
datestringoptional: Date when "from" and "to" are not specified (e.g. 20210907 or 2021-09-07)
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/margin-interest

curl -G https://api.jquants.com/v2/markets/margin-interest \
-H "x-api-key: {loading}" \
-d code="86970" \
-d date="20230324"

Responses

Data Item

Datestring: Record date
Base date of margin trading outstandings(usually on Friday)
(YYYY-MM-DD)
Codestring: Issue code
ShrtVolnumber: Total margin trading weekend short positions
LongVolnumber: Total margin trading weekend long positions
ShrtNegVolnumber: Negotiable margin trading weekend short positions
Negotiable part of the total margin trading weekend short positions.
LongNegVolnumber: Negotiable margin trading weekend long positions
Negotiable part of the total margin trading weekend long positions.
ShrtStdVolnumber: Standardized margin trading weekend short positions
Standardized part of the total margin trading weekend short positions.
LongStdVolnumber: Standardized margin positions weekend long positions
Standardized part of the total margin trading weekend long positions.
IssTypestring: Issue Classifications
1: Margin issues, 2: Loan issues, 3: Other issues (non-loan, non-margin)

Response Sample

{
    "data": [
        {
            "Date": "2023-03-24",
            "Code": "86970",
            "ShrtVol": 123456.0,
            "LongVol": 234567.0,
            "ShrtNegVol": 11111.0,
            "LongNegVol": 22222.0,
            "ShrtStdVol": 33333.0,
            "LongStdVol": 44444.0,
            "IssType": "1"
        }
    ],
    "pagination_key": "value1.value2."
}