Listed Issue Master (/equities/master)

GET /v2/equities/master

Overview

Listed issue information as of the past, the current day, and the next business day can be retrieved.
Please note that listed issue information as of the next business day can be obtained after 17:30.

Attention

This API covers issues listed on the Tokyo Stock Exchange. For the period before the cash equity market integration on July 16, 2013, issues that were listed only on the former Osaka Securities Exchange are included in neither the listed issue master nor the daily stock prices.
For the period before the integration on July 16, 2013, we provide no data item or separate dataset that identifies the exchange on which an issue was listed (TSE, OSE, JASDAQ, etc.).
For the specification of past dates, even if you are subscribing Premium plan and specify a date earlier than the start date of data provision (May 7, 2008), the issue information as of May 7, 2008 will be returned.
If specified "Date" is non-business day, the issue information as of next business day of specified date will be returned.
How far back you can specify a past date depends on your plan. See the per-plan data retention periods in Data Specifications.
For how to distinguish common shares from preferred shares and similar classes, please refer to the FAQ ("Is there a way to distinguish common shares from preferred shares?").
In accordance with the TSE market restructuring in April 2022, the Bank of Japan (code: 83010) and Shinkin Central Bank (code: 84210) no longer belong to any market divisions under the system, but J-Quants handles them as "Standard".
Handling of delisted issues:
- If you specify a past date in date, the issues listed as of that date will be returned. Issues that have since been delisted can also be retrieved by specifying a date on which they were still listed.
- For a delisted issue, if you specify a date after its delisting in date, the response will be empty.
- Listing dates and delisting dates are not provided.
- A list of delisted issues is not provided. As a supplement to delisting dates and the list of delisted issues, please refer to Delisted Issues published on our group's website. See also the FAQ "Can I retrieve data for delisted stocks?".
- Past trading unit data is not provided.
History of issue code, company name, and market segment changes:
- Histories of corporate actions such as mergers, share exchanges, share transfers, delistings, code changes, trading-unit changes, and name changes (including the correspondence between predecessor and successor companies) are not provided. Please identify such changes by comparing the daily snapshots retrieved by specifying dates.
See also the FAQ "Do you provide data on trading suspensions or corporate actions?", the FAQ "Does J-Quants API provide ISIN codes or FIGI codes?".

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.

Obtain daily listed issue information

GET https://api.jquants.com/v2/equities/master

When acquiring data, issue code (code) or date (date) can be specified.
The combination of each parameter and the results of the response are as below.

code	date	Results
		All listed issues as of the day when API is executed. (*1)
		Specified listed issues as of the day when API is executed. (*1)
		All listed issues as of the specified day. (*2)
		Specified listed issues as of the specified day. (*2)

*1 If "Date" is not specified on non-business day, the issue information as of next business day will be returned.
*2 If you are subscribing a plan other than free plan, data as of the next business day can be obtained. Even if you specify a future date that is earlier than the next business day, the issue information as of the next business day will be returned.

Requests

Headers

x-api-keystringrequired: API Key

Query Parameters

codestringoptional: Issue code (e.g. 27890 or 2789)
If a 4-character issue code is specified, the search appends "0" to the end of the code, so only the data of common stock will be obtained for the issue on which both common and preferred stocks are listed.
datestringoptional: Date of application of information (e.g. 20210907 or 2021-09-07)

Sample Code

Request

GET

/v2/equities/master

curl -G https://api.jquants.com/v2/equities/master \
-H "x-api-key: {loading}" \
-d code="86970" \
-d date="2022-11-11"

Responses

Data Item

Datestring: Date of application of information (YYYY-MM-DD)
Codestring: Issue code
CoNamestring: Company Name (Japanese)
CoNameEnstring: Company Name (English)
S17string: 17-Sector code (See 17-sector code and name)
S17Nmstring: 17-Sector code name (Japanese) (See 17-sector code and name)
S33string: 33-Sector code (See 33-sector code and name)
S33Nmstring: 33-Sector code name (Japanese) (See 33-sector code and name)
ScaleCatstring: Scale category code (See Scale category code)
Mktstring: Market segment code (See Market segment code and name)
MktNmstring: Market segment code name (Japanese) (See Market segment code and name)
Mrgnstring: Flags of margin and loan issues (1: Margin issues / 2: Loan issues / 3: Other issues (non-loan, non-margin))
MrgnNmstring: Name of flags of margin and loan issues
ProdCatstring: Product category code (See Product category codes and names)

Response Sample

{
    "data": [
        {
            "Date": "2022-11-11",
            "Code": "86970",
            "CoName": "日本取引所グループ",
            "CoNameEn": "Japan Exchange Group,Inc.",
            "S17": "16",
            "S17Nm": "金融（除く銀行）",
            "S33": "7200",
            "S33Nm": "その他金融業",
            "ScaleCat": "TOPIX Large70",
            "Mkt": "0111",
            "MktNm": "プライム",
            "Mrgn": "1",
            "MrgnNm": "信用",
            "ProdCat": "011"
        }
    ]
}