Financial Data (/fins/statements)

Quarterly financial information can be obtained.

Overview

You can obtain quarterly earnings summaries and disclosure information (mainly numerical data) on revisions to earnings and dividend information for listed companies.

Attention

About Accounting Standards

Each item name output from the API is based on Japanese GAAP (JGAAP) disclosure items. Therefore, IFRS and U.S. GAAP (USGAAP) disclosure data do not have the concept of ordinary income, so the data is blank.

Parameter and Response

Quarterly financial information can be obtained.

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

Either "code" or "date" must be specified.

"*" Required.

Query Parameters

Name	Type	Description
code	String	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.
date	String	disclosure date （e.g. 20210901 or 2021-09-01）
pagination_key	String	The primary key of the first item that this operation will evaluate. Use the value that was returned for pagination_key in the previous operation.

Headers

Name	Type	Description
Authorization*	String	access key

200: OK

{
    "statements": [
        {
              "DisclosedDate": "2023-01-30",
              "DisclosedTime": "12:00:00",
              "LocalCode": "86970",
              "DisclosureNumber": "20230127594871",
              "TypeOfDocument": "3QFinancialStatements_Consolidated_IFRS",
              "TypeOfCurrentPeriod": "3Q",
              "CurrentPeriodStartDate": "2022-04-01",
              "CurrentPeriodEndDate": "2022-12-31",
              "CurrentFiscalYearStartDate": "2022-04-01",
              "CurrentFiscalYearEndDate": "2023-03-31",
              "NextFiscalYearStartDate": "",
              "NextFiscalYearEndDate": "",
              "NetSales": "100529000000",
              "OperatingProfit": "51765000000",
              "OrdinaryProfit": "",
              "Profit": "35175000000",
              "EarningsPerShare": "66.76",
              "DilutedEarningsPerShare": "",
              "TotalAssets": "79205861000000",
              "Equity": "320021000000",
              "EquityToAssetRatio": "0.004",
              "BookValuePerShare": "",
              "CashFlowsFromOperatingActivities": "",
              "CashFlowsFromInvestingActivities": "",
              "CashFlowsFromFinancingActivities": "",
              "CashAndEquivalents": "91135000000",
              "ResultDividendPerShare1stQuarter": "",
              "ResultDividendPerShare2ndQuarter": "26.0",
              "ResultDividendPerShare3rdQuarter": "",
              "ResultDividendPerShareFiscalYearEnd": "",
              "ResultDividendPerShareAnnual": "",
              "DistributionsPerUnit(REIT)": "",
              "ResultTotalDividendPaidAnnual": "",
              "ResultPayoutRatioAnnual": "",
              "ForecastDividendPerShare1stQuarter": "",
              "ForecastDividendPerShare2ndQuarter": "",
              "ForecastDividendPerShare3rdQuarter": "",
              "ForecastDividendPerShareFiscalYearEnd": "36.0",
              "ForecastDividendPerShareAnnual": "62.0",
              "ForecastDistributionsPerUnit(REIT)": "",
              "ForecastTotalDividendPaidAnnual": "",
              "ForecastPayoutRatioAnnual": "",
              "NextYearForecastDividendPerShare1stQuarter": "",
              "NextYearForecastDividendPerShare2ndQuarter": "",
              "NextYearForecastDividendPerShare3rdQuarter": "",
              "NextYearForecastDividendPerShareFiscalYearEnd": "",
              "NextYearForecastDividendPerShareAnnual": "",
              "NextYearForecastDistributionsPerUnit(REIT)": "",
              "NextYearForecastPayoutRatioAnnual": "",
              "ForecastNetSales2ndQuarter": "",
              "ForecastOperatingProfit2ndQuarter": "",
              "ForecastOrdinaryProfit2ndQuarter": "",
              "ForecastProfit2ndQuarter": "",
              "ForecastEarningsPerShare2ndQuarter": "",
              "NextYearForecastNetSales2ndQuarter": "",
              "NextYearForecastOperatingProfit2ndQuarter": "",
              "NextYearForecastOrdinaryProfit2ndQuarter": "",
              "NextYearForecastProfit2ndQuarter": "",
              "NextYearForecastEarningsPerShare2ndQuarter": "",
              "ForecastNetSales": "132500000000",
              "ForecastOperatingProfit": "65500000000",
              "ForecastOrdinaryProfit": "",
              "ForecastProfit": "45000000000",
              "ForecastEarningsPerShare": "85.42",
              "NextYearForecastNetSales": "",
              "NextYearForecastOperatingProfit": "",
              "NextYearForecastOrdinaryProfit": "",
              "NextYearForecastProfit": "",
              "NextYearForecastEarningsPerShare": "",
              "MaterialChangesInSubsidiaries": "false",
              "ChangesBasedOnRevisionsOfAccountingStandard": "false",
              "ChangesOtherThanOnesBasedOnRevisionsOfAccountingStandard": "false",
              "ChangesInAccountingEstimates": "true",
              "RetrospectiveRestatement": "",
              "NumberOfIssuedAndOutstandingSharesAtTheEndOfFiscalYearIncludingTreasuryStock": "528578441",
              "NumberOfTreasuryStockAtTheEndOfFiscalYear": "1861043",
              "AverageNumberOfShares": "526874759",
              "NonConsolidatedNetSales": "",
              "NonConsolidatedOperatingProfit": "",
              "NonConsolidatedOrdinaryProfit": "",
              "NonConsolidatedProfit": "",
              "NonConsolidatedEarningsPerShare": "",
              "NonConsolidatedTotalAssets": "",
              "NonConsolidatedEquity": "",
              "NonConsolidatedEquityToAssetRatio": "",
              "NonConsolidatedBookValuePerShare": "",
              "ForecastNonConsolidatedNetSales2ndQuarter": "",
              "ForecastNonConsolidatedOperatingProfit2ndQuarter": "",
              "ForecastNonConsolidatedOrdinaryProfit2ndQuarter": "",
              "ForecastNonConsolidatedProfit2ndQuarter": "",
              "ForecastNonConsolidatedEarningsPerShare2ndQuarter": "",
              "NextYearForecastNonConsolidatedNetSales2ndQuarter": "",
              "NextYearForecastNonConsolidatedOperatingProfit2ndQuarter": "",
              "NextYearForecastNonConsolidatedOrdinaryProfit2ndQuarter": "",
              "NextYearForecastNonConsolidatedProfit2ndQuarter": "",
              "NextYearForecastNonConsolidatedEarningsPerShare2ndQuarter": "",
              "ForecastNonConsolidatedNetSales": "",
              "ForecastNonConsolidatedOperatingProfit": "",
              "ForecastNonConsolidatedOrdinaryProfit": "",
              "ForecastNonConsolidatedProfit": "",
              "ForecastNonConsolidatedEarningsPerShare": "",
              "NextYearForecastNonConsolidatedNetSales": "",
              "NextYearForecastNonConsolidatedOperatingProfit": "",
              "NextYearForecastNonConsolidatedOrdinaryProfit": "",
              "NextYearForecastNonConsolidatedProfit": "",
              "NextYearForecastNonConsolidatedEarningsPerShare": ""
        }
    ],
    "pagination_key": "value1.value2."
}

400: Bad Request

{
　　　　　　　　"message": "This API requires at least 1 parameter as follows; 'date','code'."
}

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
DisclosedDate	Disclosed Date	String
DisclosedTime	Disclosed Time	String
LocalCode	Issue Code(5-character)	String
DisclosureNumber	Disclosure Number	String	ascending order by disclosure number.
TypeOfDocument	Type of document	String	see Type of document
TypeOfCurrentPeriod	Type of current accounting period	String	[1Q, 2Q, 3Q, 4Q, 5Q, FY]
CurrentPeriodStartDate	Start date of current accounting period	String
CurrentPeriodEndDate	End date of current accounting period	String
CurrentFiscalYearStartDate	Start date of current fiscal year	String
CurrentFiscalYearEndDate	End date of current fiscal year	String
NextFiscalYearStartDate	Start date of next fiscal year	String	Blank is set if disclosure information for the following fiscal year is not set.
NextFiscalYearEndDate	End date of next fiscal year	String	same as above
NetSales	Net Sales	String
OperatingProfit	Operating Profit	String
OrdinaryProfit	Ordinary Profit	String
Profit	Profit	String
EarningsPerShare	Earnings per share	String
DilutedEarningsPerShare	Diluted Earnings per share	String
TotalAssets	Total assets	String
Equity	equity	String
EquityToAssetRatio	Equity to asset ratio	String
BookValuePerShare	Book value per share	String
CashFlowsFromOperatingActivities	Cash flows from operating activities	String
CashFlowsFromInvestingActivities	Cash flows from investing activities	String
CashFlowsFromFinancingActivities	Cash flows from financing activities	String
CashAndEquivalents	Cash and equivalents	String
ResultDividendPerShare1stQuarter	Result of dividend per share at 1Q	String
ResultDividendPerShare2ndQuarter	Result of dividend per share at 2Q	String
ResultDividendPerShare3rdQuarter	Result of dividend per share at 3Q	String
ResultDividendPerShareFiscalYearEnd	Result of dividend per share at fiscal year end	String
ResultDividendPerShareAnnual	Annual result of dividend per share	String
DistributionsPerUnit(REIT)	Distribution per unit for REIT	String
ResultTotalDividendPaidAnnual	Annual result of total paid dividend	String
ResultPayoutRatioAnnual	Annual result of payout ratio	String
ForecastDividendPerShare1stQuarter	Forecast of dividend per share at 1Q	String
ForecastDividendPerShare2ndQuarter	Forecast of dividend per share at 2Q	String
ForecastDividendPerShare3rdQuarter	Forecast of dividend per share at 3Q	String
ForecastDividendPerShareFiscalYearEnd	Forecast of dividend per share at fiscal year end	String
ForecastDividendPerShareAnnual	Annual forecast of dividend per share	String
ForecastDistributionsPerUnit(REIT)	Forecast of distribution per unit for REIT	String
ForecastTotalDividendPaidAnnual	Annual forecast of total paid dividend	String
ForecastPayoutRatioAnnual	Annual forecast payout ratio	String
NextYearForecastDividendPerShare1stQuarter	Forecast of next year dividend per share at 1Q	String
NextYearForecastDividendPerShare2ndQuarter	Forecast of next year dividend per share at 2Q	String
NextYearForecastDividendPerShare3rdQuarter	Forecast of next year dividend per share at 3Q	String
NextYearForecastDividendPerShareFiscalYearEnd	Forecast of next year dividend per share at fiscal year end	String
NextYearForecastDividendPerShareAnnual	Annual forecast dividend per share at next year fiscal year end	String
NextYearForecastDistributionsPerUnit(REIT)	Forecast of distribution per unit for REIT at next year fiscal year end	String
NextYearForecastPayoutRatioAnnual	Annual forecast payout ratio at next year fiscal year end	String
ForecastNetSales2ndQuarter	Forecast of net sales at 2Q	String
ForecastOperatingProfit2ndQuarter	Forecast of operation profit at 2Q	String
ForecastOrdinaryProfit2ndQuarter	Forecast of ordinary profit at 2Q	String
ForecastProfit2ndQuarter	Forecast of profit at 2Q	String
ForecastEarningsPerShare2ndQuarter	Forecast of earnings per share at 2Q	String
NextYearForecastNetSales2ndQuarter	Forecast of net sales at next year 2Q	String
NextYearForecastOperatingProfit2ndQuarter	Forecast of operation profit at next year 2Q	String
NextYearForecastOrdinaryProfit2ndQuarter	Forecast of ordinary profit at next year 2Q	String
NextYearForecastProfit2ndQuarter	Forecast of profit at next year 2Q	String
NextYearForecastEarningsPerShare2ndQuarter	Forecast of earnings per share at next year 2Q	String
ForecastNetSales	Forecast of net sales at fiscal year end	String
ForecastOperatingProfit	Forecast of operating profit at fiscal year end	String
ForecastOrdinaryProfit	Forecast of ordinary profit at fiscal year end	String
ForecastProfit	Forecast of profit at fiscal year end	String
ForecastEarningsPerShare	Forecast of earnings per share at fiscal year end	String
NextYearForecastNetSales	Forecast of net sales in next year at fiscal year end	String
NextYearForecastOperatingProfit	Forecast of operating profit at next year fiscal year end	String
NextYearForecastOrdinaryProfit	Forecast of ordinary profit at next year fiscal year end	String
NextYearForecastProfit	Forecast of profit at next year fiscal year end	String
NextYearForecastEarningsPerShare	Forecast of earnings per share at next year fiscal year end	String
MaterialChangesInSubsidiaries	Material changes in Subsidiaries at fiscal year end	String
ChangesBasedOnRevisionsOfAccountingStandard	Changes based on revisions of accounting standard	String
ChangesOtherThanOnesBasedOnRevisionsOfAccountingStandard	Changes other than ones based on revisions of accounting standard	String
ChangesInAccountingEstimates	changes in accounting estimates	String
RetrospectiveRestatement	Retorospective restatement	String
NumberOfIssuedAndOutstandingSharesAtTheEndOfFiscalYearIncludingTreasuryStock	Number of issued and outstanding shares at the end of fiscal year including treasury stock	String
NumberOfTreasuryStockAtTheEndOfFiscalYear	Number of treasury stock at fiscal year end	String
AverageNumberOfShares	Average number of shares at fiscal year end	String
NonConsolidatedNetSales	Non-consolidated net sales at fiscal year end	String
NonConsolidatedOperatingProfit	Non-consolidated operating profit at fiscal year end	String
NonConsolidatedOrdinaryProfit	Non-consolidated ordinary profit at fiscal year end	String
NonConsolidatedProfit	Non-consolidated profit at fiscal year end	String
NonConsolidatedEarningsPerShare	Non-consolidated earnings per share at fiscal year end	String
NonConsolidatedTotalAssets	Non-consolidated total assets at fiscal year end	String
NonConsolidatedEquity	Non-consolidated equity at fiscal year end	String
NonConsolidatedEquityToAssetRatio	Non-consolidated equity to asset ratio at fiscal year end	String
NonConsolidatedBookValuePerShare	Non-consolidated book value per share at fiscal year end	String
ForecastNonConsolidatedNetSales2ndQuarter	Non-consolidated forecast of net sales at 2Q	String
ForecastNonConsolidatedOperatingProfit2ndQuarter	Non-consolidated forecast of operating profit at 2Q	String
ForecastNonConsolidatedOrdinaryProfit2ndQuarter	Non-consolidated forecast of ordinary profit at 2Q	String
ForecastNonConsolidatedProfit2ndQuarter	Non-consolidated forecast of profit at 2Q	String
ForecastNonConsolidatedEarningsPerShare2ndQuarter	Non-consolidated forecast of earnings per share at 2Q	String
NextYearForecastNonConsolidatedNetSales2ndQuarter	Non-consolidated forecast of net sales at next year 2Q	String
NextYearForecastNonConsolidatedOperatingProfit2ndQuarter	Non-consolidated forecast of operating profit at next year 2Q	String
NextYearForecastNonConsolidatedOrdinaryProfit2ndQuarter	Non-consolidated forecast of ordinary profit in next year 2Q	String
NextYearForecastNonConsolidatedProfit2ndQuarter	Non-consolidated forecast of profit in next year 2Q	String
NextYearForecastNonConsolidatedEarningsPerShare2ndQuarter	Non-consolidated forecast of earnings per share in next year 2Q	String
ForecastNonConsolidatedNetSales	Non-consolidated forecast of net sales at fiscal year end	String
ForecastNonConsolidatedOperatingProfit	Non-consolidated forecast of operating profit at fiscal year end	String
ForecastNonConsolidatedOrdinaryProfit	Non-consolidated forecast of ordinary profit at fiscal year end	String
ForecastNonConsolidatedProfit	Non-consolidated forecast of profit at fiscal year end	String
ForecastNonConsolidatedEarningsPerShare	Non-consolidated forecast of earnings per share at fiscal year end	String
NextYearForecastNonConsolidatedNetSales	Non-consolidated forecast of net sales at next year fiscal year end	String
NextYearForecastNonConsolidatedOperatingProfit	Non-consolidated forecast of operating profit at next year fiscal year end	String
NextYearForecastNonConsolidatedOrdinaryProfit	Non-consolidated forecast of ordinary profit at next year fiscal year end	String
NextYearForecastNonConsolidatedProfit	Non-consolidated forecast of profit at next year fiscal year end	String
NextYearForecastNonConsolidatedEarningsPerShare	Non-consolidated forecast of earnings per share at next year fiscal year end	String

Sample Code

Curl

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