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
- 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.
- MarginCode and MarginCodeName are available for Standard and Premium plan users.
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".
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, 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
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
- TOPIX Scale category
- 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)) (*1)
- MrgnNmstring
- Name of flags of margin and loan issues (*1)
*1 The item is available for Standard and Premium plan users.
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": "信用"
}
]
}