Margin Trading Outstanding (Daily)

GET /v2/markets/margin-interest (scheduled for September 28, 2026)

Overview

This API provides daily margin trading outstanding data, including share quantities and values, for all listed issues.

Attention

This API is scheduled to be released with the updated specification on September 28, 2026.
Data for the previous business day is available on each business day.
This API provides a different dataset from Margin Trading Outstanding (Issues Subject to Daily Publication), which covers only issues designated for daily publication.
Daily data is available from September 25, 2026. Earlier data remains weekly and is dated as of the last business day of each week. No data is provided for weeks with two or fewer business days, such as during the year-end and New Year holidays.
The value fields (ShrtVal, etc.) contain values from September 25, 2026. For earlier data, they are returned as null.
Share-quantity fields are not adjusted retrospectively for corporate actions.
Securities not listed on the Tokyo Stock Exchange, including those listed exclusively on other exchanges, are not included in the data.

Get Margin Trading Outstanding

GET https://api.jquants.com/v2/markets/margin-interest (scheduled for September 28, 2026)

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

Parameters and Responses

The available parameter combinations and their corresponding results are shown below.

code	date	from /to	Results
			All historical data for a specific issue
			Data for a specific issue on a specific date
			Data for a specific issue during a specified period
			Data for all listed issues on a 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 four-character issue code is specified for an issue that has both common and preferred shares listed, only data for the common shares is returned.
fromstringoptional: Start date of the requested period (e.g., 20210901 or 2021-09-01)
tostringoptional: End date of the requested period (e.g., 20210907 or 2021-09-07)
datestringoptional: Date to retrieve when "from" and "to" are not specified (e.g., 20210907 or 2021-09-07)
pagination_keystringoptional: The primary key of the first item to be evaluated by the request.
Use the pagination_key returned by the previous request.

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="20260925"

Responses

Data Items

Datestring: Base date of the margin trading outstanding data in YYYY-MM-DD format.
Codestring: Issue code
IssTypestring: Issue classification
1: Margin issue, 2: Loan issue, 3: Other issue (neither a loan issue nor a margin issue)
ShrtVolnumber: Total margin trading short positions (shares)
LongVolnumber: Total margin trading long positions (shares)
ShrtNegVolnumber: Negotiable margin trading short positions (shares)
The negotiable portion of total margin trading short positions.
LongNegVolnumber: Negotiable margin trading long positions (shares)
The negotiable portion of total margin trading long positions.
ShrtStdVolnumber: Standardized margin trading short positions (shares)
The standardized portion of total margin trading short positions.
LongStdVolnumber: Standardized margin trading long positions (shares)
The standardized portion of total margin trading long positions.
ShrtValnumber: Total margin trading short positions (value)
This field contains values from September 25, 2026. For earlier data, it is returned as null.
LongValnumber: Total margin trading long positions (value)
This field contains values from September 25, 2026. For earlier data, it is returned as null.
ShrtNegValnumber: Negotiable margin trading short positions (value)
The negotiable portion of total margin trading short positions by value. This field contains values from September 25, 2026. For earlier data, it is returned as null.
LongNegValnumber: Negotiable margin trading long positions (value)
The negotiable portion of total margin trading long positions by value. This field contains values from September 25, 2026. For earlier data, it is returned as null.
ShrtStdValnumber: Standardized margin trading short positions (value)
The standardized portion of total margin trading short positions by value. This field contains values from September 25, 2026. For earlier data, it is returned as null.
LongStdValnumber: Standardized margin trading long positions (value)
The standardized portion of total margin trading long positions by value. This field contains values from September 25, 2026. For earlier data, it is returned as null.

Response Sample

{
    "data": [
        {
            "Date": "2026-09-25",
            "Code": "86970",
            "IssType": "2",
            "ShrtVol": 257400.0,
            "LongVol": 225000.0,
            "ShrtNegVol": 242800.0,
            "LongNegVol": 81900.0,
            "ShrtStdVol": 14600.0,
            "LongStdVol": 143100.0,
            "ShrtVal": 514800000.0,
            "LongVal": 450000000.0,
            "ShrtNegVal": 485600000.0,
            "LongNegVal": 163800000.0,
            "ShrtStdVal": 29200000.0,
            "LongStdVal": 286200000.0
        }
    ],
    "pagination_key": "value1.value2."
}