📘Financial information API

You can obtain financial information for the quarter and financial statements scheduled to be announced the next day.

Financial information for the quarter

Data available since January 2017.

Quarterly financial information is available.

GET https://api.jpx-jquants.com/v1/fins/statements

Code or Date is required parameter.

*Required

Query Parameters

Name	Type	Description
code	String	Issue code (e.g. 86970 or 8697) 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.
date	String	Date of data e.g. 2022-01-05 or 20220105

Headers

Name	Type	Description
Authorization*	String	Access key

200: OK

{
    "statements": [
        {
            "Profit": "4608000000",
            "ForecastDividendPerShare1stQuarter": "",
            "ForecastDividendPerShareFiscalYearEnd": "40.0",
            "NumberOfIssuedAndOutstandingSharesAtTheEndOfFiscalYearIncludingTreasuryStock": "63330838",
            "ForecastDividendPerShareAnnual": "80.0",
            "ForecastNetSales": "675000000000",
            "ChangesBasedOnRevisionsOfAccountingStandard": "true",
            "ResultDividendPerShareFiscalYearEnd": "",
            "CurrentFiscalYearStartDate": "2022-03-01",
            "MaterialChangesInSubsidiaries": "false",
            "AverageNumberOfShares": "61813505",
            "OrdinaryProfit": "6806000000",
            "ChangesInAccountingEstimates": "false",
            "DisclosedDate": "2022-06-28",
            "ForecastDividendPerShare3rdQuarter": "－",
            "CurrentFiscalYearEndDate": "2023-02-28",
            "CurrentPeriodEndDate": "2022-05-31",
            "ForecastDividendPerShare2ndQuarter": "40.0",
            "EquityToAssetRatio": "0.612",
            "TotalAssets": "348487000000",
            "OperatingProfit": "6671000000",
            "DisclosureNumber": "20220616580562",
            "ApplyingOfSpecificAccountingOfTheQuarterlyFinancialStatements": "",
            "ForecastEarningsPerShare": "291.2",
            "NumberOfTreasuryStockAtTheEndOfFiscalYear": "1517333",
            "ResultDividendPerShare2ndQuarter": "",
            "LocalCode": "76490",
            "TypeOfDocument": "1QFinancialStatements_Consolidated_JP",
            "ForecastOperatingProfit": "30000000000",
            "ResultDividendPerShareAnnual": "",
            "ForecastOrdinaryProfit": "31000000000",
            "ForecastProfit": "18000000000",
            "EarningsPerShare": "74.56",
            "DisclosedUnixTime": "1656430200.0",
            "Equity": "213285000000",
            "NetSales": "161128000000",
            "ChangesOtherThanOnesBasedOnRevisionsOfAccountingStandard": "false",
            "ResultDividendPerShare3rdQuarter": "",
            "BookValuePerShare": "3450.47",
            "ResultDividendPerShare1stQuarter": "－",
            "TypeOfCurrentPeriod": "1Q",
            "DisclosedTime": "15:30:00",
            "RetrospectiveRestatement": "false"
        }
    ]
}

400: Bad Request

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

401: Unauthorized

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

403: Forbidden

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

Variables	Description	Data type	Examples
DisclosureNumber	Disclosure Number	String	20220126573026
DisclosedDate	Disclosed Date	String	2022-01-27
ApplyingOfSpecificAccountingOfTheQuarterlyFinancialStatements	Applying Of Specific Accounting Of The Quarterly Financial Statements	String
AverageNumberOfShares	Average Number Of Shares	String	530119112
BookValuePerShare	Book Value Per Share	String
ChangesBasedOnRevisionsOfAccountingStandard	Changes Based On Revisions Of Accounting Standard	String	FALSE
ChangesInAccountingEstimates	Changes In Accounting Estimates	String	FALSE
ChangesOtherThanOnesBasedOnRevisionsOfAccountingStandard	Changes Other Than Ones Based On Revisions Of Accounting Standard	String	FALSE
CurrentFiscalYearEndDate	Current Fiscal Year End Date	String	2022-03-31
CurrentFiscalYearStartDate	Current Fiscal Year Start Date	String	2021-04-01
CurrentPeriodEndDate	Current Period End Date	String	2021-12-31
DisclosedTime	Disclosed Time	String	12:00:00
DisclosedUnixTime	Disclosed Unix Time	String	1643252400
EarningsPerShare	Earnings Per Share	String	71.71
Equity	Equity	String	42714000000
EquityToAssetRatio	Equity To Asset Ratio	String	0.005
ForecastDividendPerShare1stQuarter	Forecast Dividend Per Share 1st Quarter	String
ForecastDividendPerShare2ndQuarter	Forecast Dividend Per Share 2nd Quarter	String
ForecastDividendPerShare3rdQuarter	Forecast Dividend Per Share 3rd Quarter	String
ForecastDividendPerShareAnnual	Forecast Dividend Per Share Annual	String	53.0
ForecastDividendPerShareFiscalYearEnd	Forecast Dividend Per Share Fiscal Year End	String	27.0
ForecastEarningsPerShare	Forecast Earnings Per Share	String	50.31
ForecastNetSales	Forecast Net Sales	String
ForecastOperatingProfit	Forecast Operating Profit	String
ForecastOrdinaryProfit	Forecast Ordinary Profit	String
ForecastProfit	Forecast Profit	String	850000000
LocalCode	Issue Code	String	86970
MaterialChangesInSubsidiaries	Material Changes In Subsidiaries	String	FALSE
NetSales	Net Sales	String	100586000000
NumberOfIssuedAndOutstandingSharesAtTheEndOfFiscalYearIncludingTreasuryStock	Number Of Issued And Outstanding Shares At The End Of Fiscal Year Including Treasury Stock	String	536351448
NumberOfTreasuryStockAtTheEndOfFiscalYear	Number Of Treasury Stock At The End Of Fiscal Year	String	8822727
OperatingProfit	Operating Profit	String	55967000000
OrdinaryProfit	Ordinary Profit	String	55936000000
Profit	Profit	String	591000000
ResultDividendPerShare1stQuarter	Result Dividend Per Share 1st Quarter	String	－
ResultDividendPerShare2ndQuarter	Result Dividend Per Share 2nd Quarter	String	26.0
ResultDividendPerShare3rdQuarter	Result Dividend Per Share 3rd Quarter	String	－
ResultDividendPerShareAnnual	Result Dividend Per Share Annual	String
ResultDividendPerShareFiscalYearEnd	Result Dividend Per Share Fiscal Year End	String
RetrospectiveRestatement	Retrospective Restatement	String
TotalAssets	Total Assets	String	62076519000000
TypeOfCurrentPeriod	Type Of Current Period	String	3Q
TypeOfDocument	Type Of Document	String	3QFinancialStatements_Consolidated_IFRS

Curl

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

Schedule of financial announcement

This data is for reference

It will be updated at around 19:00 (JST) only when there is an update for companies which end their fiscal year in March or September at the following site. https://www.jpx.co.jp/listing/event-schedules/financial-announcement/index.html

inquire the issue code, fiscal year, and quarter scheduled to be announced on the next day.

GET https://api.jpx-jquants.com/v1/fins/announcement

*required

Headers

Name	Type	Description
Authorization*	String	Access key

200: OK

{
  "announcement": [
    {
      "Code": "43760",
      "Date": "20220214",
      "CompanyName": "くふうカンパニー",
      "FiscalYear": "9月30日",
      "SectorName": "情報・通信業",
      "FiscalQuarter": "第１四半期",
      "Section": "マザーズ"
    }
  ]  
}

400: Bad Request

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

401: Unauthorized

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

403: Forbidden

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

Variables	Description	Data type	Examples
Code	Issue code	String	43760
Date	Date	String	20220214
CompanyName	Company name (Japanese)	String	くふうカンパニー
FiscalYear	End of Fiscal year (Japanese)	String	9月30日
SectorName	Sector name (Japanese)	String	情報・通信業
FiscalQuarter	Fiscal quarter (Japanese)	String	第1四半期
Section	Market segment name (Japanese)	String	マザーズ

Curl

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