配当金情報(/fins/dividend)

配当金データ（配当日・予想配当額）を取得することができます

API概要

上場会社の配当（決定・予想）に関する１株当たり配当金額、基準日、権利落日及び支払開始予定日等の情報を取得できます。

本APIの留意点

• 東証上場銘柄でない銘柄（地方取引所単独上場銘柄）についてはデータの収録対象外となっております。

パラメータ及びレスポンス

データの取得では、銘柄コード（code）または通知日付（date）の指定が必須となります。 各パラメータの組み合わせとレスポンスの結果については以下のとおりです。

code	date	from /to	レスポンスの結果
			指定された銘柄について取得可能期間の全データ
			指定された銘柄について指定された期間分のデータ
			全上場銘柄について指定された通知日付のデータ

配当金データを取得します

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

データの取得では、銘柄コード（code）または通知日付（date）の指定が必須となります。

*は必須項目

Query Parameters

Name	Type	Description
code	String	銘柄コード （e.g. 27800 or 2780） 4桁の銘柄コードを指定した場合は、普通株式と優先株式の両方が上場している銘柄においては普通株式のデータのみが取得されます。
from	String	fromの指定 （e.g. 20210901 or 2021-09-01）
to	String	toの指定 （e.g. 20210907 or 2021-09-07）
date	String	*fromとtoを指定しないとき （e.g. 20210907 or 2021-09-07）
pagination_key	String	検索の先頭を指定する文字列 過去の検索で返却されたpagination_keyを設定

Headers

Name	Type	Description
Authorization*	String	アクセスキー

200: OK

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

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

データ項目概要

変数名	説明	型	備考
AnnouncementDate	通知日時（年月日）	String	YYYY-MM-DD
AnnouncementTime	通知日時（時分）	String	HH:MI
Code	銘柄コード	String
ReferenceNumber	リファレンスナンバー	String	配当通知を一意に特定するための番号 ※リファレンスナンバーについてを参照
StatusCode	更新区分（コード）	String	1: 新規、2: 訂正、3: 削除
BoardMeetingDate	取締役会決議日	String
InterimFinalCode	配当種類（コード）	String	1: 中間配当、2: 期末配当
ForecastResultCode	予想／決定（コード）	String	1: 決定、2: 予想
InterimFinalTerm	配当基準日年月	String
GrossDividendRate	１株当たり配当金額	Number/String	未定の場合: - 、非設定の場合: 空文字
RecordDate	基準日	String
ExDate	権利落日	String
ActualRecordDate	権利確定日	String
PayableDate	支払開始予定日	String	未定の場合: - 、非設定の場合: 空文字
CAReferenceNumber	ＣＡリファレンスナンバー	String	訂正・削除の対象となっている配当通知のリファレンスナンバー。新規の場合はリファレンスナンバーと同じ値を設定 ※リファレンスナンバーについてを参照
DistributionAmount	1株当たりの交付金銭等の額	Number/String	未定の場合: - 、非設定の場合: 空文字　が設定されます。 2014年2月24日以降のみ提供。
RetainedEarnings	1株当たりの利益剰余金の額	Number/String	同上
DeemedDividend	1株当たりのみなし配当の額	Number/String	同上
DeemedCapitalGains	1株当たりのみなし譲渡収入の額	Number/String	同上
NetAssetDecreaseRatio	純資産減少割合	Number/String	同上
CommemorativeSpecialCode	記念配当/特別配当コード	String	1: 記念配当、2: 特別配当、3: 記念・特別配当、0: 通常の配当
CommemorativeDividendRate	１株当たり記念配当金額	Number/String	未定の場合: - 、非設定の場合: 空文字 2022年6月6日以降のみ提供。
SpecialDividendRate	１株当たり特別配当金額	Number/String	同上

APIコールサンプルコード

Curl

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

付録：リファレンスナンバーについて

• リファレンスナンバー : 配当通知を一意に特定するための番号。

• CAリファレンスナンバー：訂正・削除の対象となっている配当通知のリファレンスナンバー。新規の場合はリファレンスナンバーと同じ値。

具体例：以下の通知があった場合に、提供データは下表のとおりになります。

• 銘柄：日本取引所（銘柄コード：86970）について

  • 2023-03-06　　配当が新規で通知

  • 2023-03-07　　配当が訂正情報として通知

  • 2023-03-08　　配当が削除された

  • 2023-03-09　　配当が新規で通知

AnnouncementDate	Code	ReferenceNumber	CAReferenceNumber	StatusCode
2023-03-06	86970	1	1	1：新規
2023-03-07	86970	2	1	2：訂正
2023-03-08	86970	3	1	3：削除
2023-03-09	86970	4	4	1：新規

* 一部項目のみを抽出して例示しています。 * 上記のコード値は例示のため便宜的な記載としており、また実際に発生したデータとは異なります。