Listed Issue Information (/listed/info)

You can get information on listed companies and sector information

Overview

listed issue Information as of the past, the current day, and the next business day can be retrieved.

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".

Parameter and Response

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	Result
		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.

Obtain daily listed issue information

GET https://api.jquants.com/v1/listed/info

"*" is a mandatory item.

Query Parameters

Name	Type	Description
code	String	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.
date	String	Date of application of information （e.g. 20210907 or 2021-09-07）

Headers

Name	Type	Description
Authorization*	String	Access key

200: OK

{
    "info": [
        {
            "Date": "2022-11-11",
            "Code": "86970",
            "CompanyName": "日本取引所グループ",
        　　　　　　　　"CompanyNameEnglish": "Japan Exchange Group,Inc.",
            "Sector17Code": "16",
            "Sector17CodeName": "金融（除く銀行）",
            "Sector33Code": "7200",
            "Sector33CodeName": "その他金融業",
            "ScaleCategory": "TOPIX Large70",
            "MarketCode": "0111",
            "MarketCodeName": "プライム",
            "MarginCode": "1",
            "MarginCodeName": "信用",
        }
    ]
}

400: Bad Request

{
    "message": "<Error Message>"
}

401: Unauthorized

{
　　　　"message": "The incoming token is invalid or expired."
}

403: Forbidden

{
　　　　"message": "Missing Authentication Token. The method or resources may not be supported."
}

500: Internal Server Error

{
　　　　"message": "Unexpected error. Please try again later."
}

413: Payload Too Large

{
    "message": "Response data is too large. Specify parameters to reduce the acquired data range."
}

Data Item

Variable	Description	Data type	Remark
Date	Date of application of information	String	YYYY-MM-DD
Code	Issue code	String
CompanyName	Company Name (Japanese)	String
CompanyNameEnglish	Company Name (English)	String
Sector17Code	17-Sector code	String	See 17-sector code and name
Sector17CodeName	17-Sector code name (Japanese)	String	See 17-sector code and name
Sector33Code	33-Sector code	String	See 33-sector code and name
Sector33CodeName	33-Sector code name (Japanese)	String	See 33-sector code and name
ScaleCategory	TOPIX Scale category	String
MarketCode	Market segment code	String	See Market segment code and name
MarketCodeName	Market segment code name (Japanese)	String	See Market segment code and name
MarginCode	Flags of margin and loan issues	String	1: Margin issues, 2: Loan issues, 3: Other issues(non-loan, non-margin) ※1
MarginCodeName	Name of flags of margin and loan issues	String	※1

※1 The item is available for Standard and Premium plan users.

Sample Code

Curl

idToken=<YOUR idToken> && curl https://api.jquants.com/v1/listed/info -H "Authorization: Bearer $idToken"

Python

import requests
import json

idToken = "YOUR idToken"
headers = {'Authorization': 'Bearer {}'.format(idToken)}
r = requests.get("https://api.jquants.com/v1/listed/info", headers=headers)
r.json()