Cash Dividend Data (/fins/dividend)

Provides information on dividends per share of listed companies.

Overview

Provides information on dividends (determined and forecast) per share of listed companies, record date, ex-rights date, and payable date.

Attention

Stocks that are not listed on the TSE (including issue listed only on the other exchanges) are not included in the data.

Parameter and Response

Either issue code (code) or date (date) must be specified. The combination of each parameter and the results of the response are as below.

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

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

"*" is a mandatory item.

Query Parameters

Name Type Description

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.
from	String	starting point of data period （e.g. 20210901 or 2021-09-01）
to	String	end point of data period （e.g. 20210907 or 2021-09-07）
date	String	*when "from" and "to" are not specified （e.g. 20210907 or 2021-09-07）
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.

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.

from

String

starting point of data period

（e.g. 20210901 or 2021-09-01）

String

end point of data period

（e.g. 20210907 or 2021-09-07）

date

String

*when "from" and "to" are not specified

（e.g. 20210907 or 2021-09-07）

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

Name

Type

Description

Authorization*

String

Access Key

{
    "dividend": [
        {
            "AnnouncementDate": "2014-02-24",
            "AnnouncementTime": "09:21",
            "Code": "15550",
            "ReferenceNumber": "201402241B00002",
            "StatusCode": "1",
            "BoardMeetingDate": "2014-02-24",
            "InterimFinalCode": "2",
            "ForecastResultCode": "2",
            "InterimFinalTerm": "2014-03",
            "GrossDividendRate": "-",
            "RecordDate": "2014-03-10",
            "ExDate": "2014-03-06",
            "ActualRecordDate": "2014-03-10",
            "PayableDate": "-",
            "CAReferenceNumber": "201402241B00002",
            "DistributionAmount": "",
            "RetainedEarnings": "",
            "DeemedDividend": "",
            "DeemedCapitalGains": "",
            "NetAssetDecreaseRatio": "",
            "CommemorativeSpecialCode": "0",
            "CommemorativeDividendRate": "",
            "SpecialDividendRate": ""
        }
    ],
    "pagination_key": "value1.value2."
}

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

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

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

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

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

Data Item

Variable	Description	Data type	Remark
AnnouncementDate	Announcement Time (year, month, day)	String	YYYY-MM-DD
AnnouncementTime	Announcement Time (hour, minute)	String	HH:MI
Code	Issue code	String
ReferenceNumber	Reference number	String	Number to uniquely identify the dividend notification ※See about Reference Number
StatusCode	Code stands for update status	String	1: new、2: revised、3: delete
BoardMeetingDate	Date of Board of Directors' resolution	String
InterimFinalCode	Code stands for interim/final dividend	String	1: interim、2: final
ForecastResultCode	Code stands for determined/forecast	String	1: result 2: forecast
InterimFinalTerm	Interim Final Term	String
GrossDividendRate	Dividend value per share	Number/String	"-" if undetermined, "" if not applicable.
RecordDate	record date	String
ExDate	ex-rights date	String
ActualRecordDate	Date of Dividend Vesting	String
PayableDate	Scheduled payment start date	String	"-" if undetermined, "" if not applicable.
CAReferenceNumber	CA Reference number	String	Reference number of the dividend notice of modification or deletion. For new notification, same value as Reference number. ※See about Reference Number
DistributionAmount	Amount of cash delivered per share	Number/String	"-" if undetermined, "" if not applicable. Provides only after February 24, 2014.
RetainedEarnings	Retained earnings per share	Number/String	same as above
DeemedDividend	Deemed dividend per share	Number/String	same as above
DeemedCapitalGains	Amount of deemed transfer income per share	Number/String	same as above
NetAssetDecreaseRatio	decrease ratio in net assets	Number/String	same as above
CommemorativeSpecialCode	Code stands for Commemorative/Special dividend	String	1: Commemorative、2: Special、3: Both、0: Normal
CommemorativeDividendRate	Commemorative dividend value per share	Number/String	"-" if undetermined, "" if not applicable. Provides only after June 6, 2022.
SpecialDividendRate	Special dividend value per share	Number/String	same as above

Variable

Description

Data type

Remark

AnnouncementDate

Announcement Time (year, month, day)

String

YYYY-MM-DD

AnnouncementTime

Announcement Time (hour, minute)

String

HH:MI

Code

Issue code

String

ReferenceNumber

Reference number

String

Number to uniquely identify the dividend notification

※See about Reference Number

StatusCode

Code stands for update status

String

1: new、2: revised、3: delete

BoardMeetingDate

Date of Board of Directors' resolution

String

InterimFinalCode

Code stands for interim/final dividend

String

1: interim、2: final

ForecastResultCode

Code stands for determined/forecast

String

1: result 2: forecast

InterimFinalTerm

Interim Final Term

String

GrossDividendRate

Dividend value per share

Number/String

"-" if undetermined, "" if not applicable.

RecordDate

record date

String

ExDate

ex-rights date

String

ActualRecordDate

Date of Dividend Vesting

String

PayableDate

Scheduled payment start date

String

"-" if undetermined, "" if not applicable.

CAReferenceNumber

CA Reference number

String

Reference number of the dividend notice of modification or deletion. For new notification, same value as Reference number.

※See about Reference Number

DistributionAmount

Amount of cash delivered per share

Number/String

"-" if undetermined, "" if not applicable. Provides only after February 24, 2014.

RetainedEarnings

Retained earnings per share

Number/String

same as above

DeemedDividend

Deemed dividend per share

Number/String

same as above

DeemedCapitalGains

Amount of deemed transfer income per share

Number/String

same as above

NetAssetDecreaseRatio

decrease ratio in net assets

Number/String

same as above

CommemorativeSpecialCode

Code stands for Commemorative/Special dividend

String

1: Commemorative、2: Special、3: Both、0: Normal

CommemorativeDividendRate

Commemorative dividend value per share

Number/String

"-" if undetermined, "" if not applicable. Provides only after June 6, 2022.

SpecialDividendRate

Special dividend value per share

Number/String

same as above

Sample Code

idToken=<YOUR idToken> && curl https://api.jquants.com/v1/fins/dividend?code=86970 -H "Authorization: Bearer $idToken"

import requests
import json

idToken = "YOUR idToken"
headers = {'Authorization': 'Bearer {}'.format(idToken)}
r = requests.get("https://api.jquants.com/v1/fins/dividend?code=86970", headers=headers)
r.json()

Appendix：about Reference Number

Reference number : Number uniquely assigned to each record
CA Reference number：Reference number assigned to each corporate action event. For a record with status "revised" or "delete", same value as reference number of the previous dividend notice to be modified or deleted is set in this field. For a record with status "new", same value as Reference number is set.

Example：When the following notifications are received, we provide data as shown in the table below

Issue：Japan Exchange Group,Inc.（Code：86970）
- 2023-03-06　　New dividend information is provided.
- 2023-03-07　　Previously announced dividend information is modified.
- 2023-03-08　　Previously announced dividend information is deleted.
- 2023-03-09　　Another new dividend information is provided

AnnouncementDate	Code	ReferenceNumber	CAReferenceNumber	StatusCode
2023-03-06	86970	1	1	1：new
2023-03-07	86970	2	1	2：revised
2023-03-08	86970	3	1	3：delete
2023-03-09	86970	4	4	1：new

* Only some items are shown in this example. * The above values only are for illustrative purposes and may differ from the data actually generated.

前へFinancial Statement Data(BS/PL) (/fins/fs_details)次へEarnings Calendar (/fins/announcement)

最終更新 6 か月前