配当金情報(/fins/dividend)
配当金データ(配当日・予想配当額)を取得することができます
API概要
上場会社の配当(決定・予想)に関する1株当たり配当金額、基準日、権利落日及び支払開始予定日等の情報を取得できます。
本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 | 検索の先頭を指定する文字列 過去の検索で返却された |
Headers
Name | Type | Description |
---|---|---|
Authorization* | String | アクセスキー |
データ項目概要
変数名 | 説明 | 型 | 備考 |
---|---|---|---|
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 | 1株当たり配当金額 | Number/String | 未定の場合: - 、非設定の場合: 空文字 |
RecordDate | 基準日 | String | |
ExDate | 権利落日 | String | |
ActualRecordDate | 権利確定日 | String | |
PayableDate | 支払開始予定日 | String | 未定の場合: - 、非設定の場合: 空文字 |
CAReferenceNumber | CAリファレンスナンバー | 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 | 1株当たり記念配当金額 | Number/String | 未定の場合: - 、非設定の場合: 空文字 2022年6月6日以降のみ提供。 |
SpecialDividendRate | 1株当たり特別配当金額 | Number/String | 同上 |
APIコールサンプルコード
付録:リファレンスナンバーについて
リファレンスナンバー : 配当通知を一意に特定するための番号。
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:新規 |
* 一部項目のみを抽出して例示しています。 * 上記のコード値は例示のため便宜的な記載としており、また実際に発生したデータとは異なります。
最終更新