🏨Listed issue Information API

You can get information on listed companies and sector information

Inquiry of listed issue information

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

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 Data as of the next business day can be obtained for future dates. Even if you specify a future date that is later than the next business day, the issue information as of the next business day will be returned. For the specification of past dates, even if you specify a date earlier than the start date of data provision (January 4, 2017), the issue information as of January 4, 2017 will be returned. If specified "Date" is non-business day, the issue information as of next business day of specified date will be returned.

Obtain daily listed issue information

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

"*" is a mandatory item.

Query Parameters

Name	Type	Description
code	String	If a 4-digit 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. e.g. 27890 or 2789
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": "２０２２１１１１",
            "Code": "86970",
            "UpdateDate": "20220628",
            "CompanyName": "ＪＰＸ",
            "Sector17Code": "16",
            "Sector17CodeName": "金融（除く銀行）",
            "Sector33Code": "7200",
            "Sector33CodeName": "その他金融業",
            "ScaleCategory": "TOPIX Large70",
            "MarketCode": "111",
            "MarketCodeName": "プライム",
        }
    ]
}

400: Bad Request

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

401: Unauthorized

{
    "message": "The incoming token has expired"
}

403: Forbidden

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

Date	Date of application of information	String	20221111
Code	Issue code	String	86970
CompanyName	Company Name (Japanese)	String	JPX
Sector17Code	17-Sector code	String	16
Sector17CodeName	17-Sector code name (Japanese)	String	金融（除く銀行）
Sector33Code	33-Sector code	String	7200
Sector33CodeName	33-Sector code name (Japanese)	String	その他金融業
ScaleCategory	TOPIX Scale category	String	TOPIX Large70
MarketCode	Market segment code	String	111
MarketCodeName	Market segment code name (Japanese)	String	プライム

Curl

idToken=<YOUR idToken> && curl https://api.jpx-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.jpx-jquants.com/v1/listed/info", headers=headers)
r.json()

Sector information

Obtain sector information

GET https://api.jpx-jquants.com/v1/listed/sections

"*" is a mandatory item.

Headers

Name	Type	Description
Authorization*	String	Access key

200: OK

{
    "sections": [
        {
            "SectorCode": "7150",
            "SectorName": "保険業"
        }
    ]
}

400: Bad Request

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

401: Unauthorized

{
    "message": "The incoming token has expired"
}

403: Forbidden

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

変数名	説明	型	例
SectorCode	Sector code	String	7150
SectorName	Sector name (Japanese)	String	保険業

Curl

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

Python

import requests
import json

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