Margin Trading Outstanding (Daily) (/markets/margin-interest)

GET /v2/markets/margin-interest

Overview

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

Attention

On September 28, 2026, this API was upgraded from the previous specification (Margin Trading Outstandings, weekly delivery) to the current one (daily delivery with published date and value fields). See Releases for details.
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 published date field (PubDate) and the value fields (ShrtVal, etc.) contain values from September 25, 2026. For earlier data, they are returned as null.
Searches by published date (published_date) do not return historical data for which the publication date is not recorded. The plan-specific data coverage period that applies to the record date (date) also applies to the published date.
Share-quantity fields are not adjusted retrospectively for corporate actions.
Coverage:
- Coverage is limited to issues listed on the TSE. Issues that are not listed on the TSE (issues listed only on regional exchanges) are not included. See also the FAQ "Is data from regional exchanges and PTS available?".

We do not provide the date and time when each data item became available on J-Quants. For update frequency and approximate update times, see Update Timing of Provided Data.
Questions we have received about data specifications are also answered in the FAQ (Data & Specs).

Data correction policy

In this service, we may add or overwrite data due to data deficiencies or omissions. In such cases, the correction history is recorded on Data Correction History and Known issues, so please refer to it.
Note: In these cases, neither the correction history nor pre-correction data is provided via the API, CSV, or other means.

Get Margin Trading Outstanding (Daily)

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

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

Parameters and Responses

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

code	date	from /to	published_date	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
				Data for all listed issues on a specific published date
				Data for a specific issue on a specific published date

Requests

Headers

x-api-keystringrequired: API key

Query Parameters

Either code, date, or published_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)
published_datestringoptional: Published date to retrieve (e.g., 20260928 or 2026-09-28)
Cannot be specified together with the record-date parameters (date / from / to); doing so results in a 400 error.
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

PubDatestring: Published Date (YYYY-MM-DD)
This field contains values from September 25, 2026. For earlier data, it is returned as null.
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": [
        {
            "PubDate": "2026-09-28",
            "Date": "2026-09-25",
            "Code": "86970",
            "IssType": "2",
            "ShrtVol": 417000.0,
            "LongVol": 270800.0,
            "ShrtNegVol": 119200.0,
            "LongNegVol": 171500.0,
            "ShrtStdVol": 297800.0,
            "LongStdVol": 99300.0,
            "ShrtVal": 838347467.0,
            "LongVal": 589568400.0,
            "ShrtNegVal": 240247868.0,
            "LongNegVal": 370147900.0,
            "ShrtStdVal": 598099599.0,
            "LongStdVal": 219420500.0
        }
    ],
    "pagination_key": "value1.value2."
}