J-Quants API
Markdownを表示

配当金情報(/fins/dividend)

GET /v2/fins/dividend

APIの概要

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

本APIの留意点

  • 収録データ範囲について：
    • 収録対象は国内の証券取引所（東証・名証・福証・札証等）に上場する銘柄の配当通知です。東証に上場していない銘柄（地方取引所単独上場銘柄）の配当通知も収録されます。
    • 通知時点で上場していた銘柄については、その後に上場廃止となった場合も過去分のデータは保持しています。また、株式移転・株式交換・合併等により消滅した会社の最終配当が存続会社の開示に基づき決定通知される場合など、上場廃止日より後に当該銘柄コードで配当通知が収録されることがあります。FAQ「上場廃止となった銘柄のデータは取得できますか？」もあわせてご参照ください。
  • 収録する配当の種別について： 期末・中間・特別・記念配当および無配（配当金額0円）の決定は、いずれも収録対象です。
  • 未収録期間・制約事項について： 未収録期間・制約事項はありませんが、上場会社の開示資料をもとにデータを作成しているため、開示資料に値がない場合は、収録されません。判明した場合はデータ修正履歴・制約事項ページまたは本ページにてご案内します。
  • データ格納期間について： データ格納期間は2013/2/20以降です。この起点は通知日（PubDate）基準であり、2013/2/20より前に通知された配当の持越し収録はありません。銘柄によって実際の収録開始日は異なります。プランごとの取得可能期間は契約ごとに利用可能なAPIとデータ格納期間をご参照ください。

データ更新・訂正のポリシー

  • 配当通知にはそれぞれ新しいリファレンスナンバー（RefNo）が割り振られます。訂正・削除の通知は更新区分（StatCode）が 2（訂正）・3（削除）のレコードとして追加され、CARefNo が訂正・削除の対象となる元の通知の RefNo を指します。
  • 訂正前の通知も残るため、CARefNo で通知をたどることで、どの通知がどの通知を訂正・削除したかを確認できます。詳細はリファレンスナンバーをご参照ください。
  • データ不備・不足等によるデータの追加・上書き修正の履歴については、データ修正履歴・制約事項をご参照ください。
  • データ仕様について過去にお問い合わせのあった内容は、FAQ（データ内容・仕様）にも記載しておりますので、あわせてご参照ください。

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

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

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

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

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

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

Requests

Headers

x-api-keystringrequired

APIキー

Query Parameters

code または date のいずれか一つの指定が必須です。

codestringoptional

銘柄コード
（e.g. 27800 or 2780）
4桁の銘柄コードを指定した場合は、普通株式と優先株式の両方が上場している銘柄においては普通株式のデータのみが取得されます。

fromstringoptional

fromの指定（e.g. 20210901 or 2021-09-01）

tostringoptional

toの指定（e.g. 20210907 or 2021-09-07）

datestringoptional

*fromとtoを指定しないとき（e.g. 20210907 or 2021-09-07）

pagination_keystringoptional

検索の先頭を指定する文字列
過去の検索で返却された pagination_key を設定

APIコールサンプルコード

Request

GET
/v2/fins/dividend
curl -G https://api.jquants.com/v2/fins/dividend \
-H "x-api-key: {loading}" \
-d code="86970" \
-d date="2024-10-25"

Responses

データ項目概要

PubDatestring

通知日時（YYYY-MM-DD）

PubTimestring

通知日時（HH:MM）

Codestring
銘柄コード
RefNostring

リファレンスナンバー
配当通知を一意に特定するための番号
詳細はリファレンスナンバーを参照

StatCodestring

更新区分（コード）
1: 新規、2: 訂正、3: 削除

BoardDatestring
取締役会決議日
IFCodestring

配当種類（コード）
1: 中間配当、2: 期末配当

FRCodestring

予想／決定（コード）
1: 決定、2: 予想
予想と決定は別の通知系列として提供されます。詳細はリファレンスナンバーを参照

IFTermstring
配当基準日年月
DivRatenumber / string

１株当たり配当金額（日本円、1株当たり）
無配の場合: 0、未定の場合: - 、非設定の場合: 空文字
・上場会社の開示で中間・期末の区分なく「合計」のみが開示されている場合は、未定（-）として出力されます。
・株式分割・株式併合が行われる場合、各配当の金額は配当基準日時点の株数を前提とした値です（配当基準日が分割・併合の基準日以前であれば分割・併合前、それより後であれば分割・併合後の水準）。
・通知済みのレコードが、分割・併合に伴って遡及修正されることはありません。
・分割・併合後の基準日を持つ配当予想が分割・併合の公表前に通知されていた場合は、通常、公表時に訂正通知（StatCode=2）で分割・併合後の水準に更新されます。
・ETF（受益証券）・REIT・インフラファンド（投資証券）の分配金も本項目に収録されます。

RecDatestring
基準日
ExDatestring
権利落日
ActRecDatestring
権利確定日
PayDatestring

支払開始予定日
未定の場合: - 、非設定の場合: 空文字

CARefNostring

ＣＡリファレンスナンバー
訂正・削除の対象となっている配当通知のリファレンスナンバー。新規の場合はリファレンスナンバーと同じ値を設定
詳細はリファレンスナンバーを参照

DistAmtnumber / string

1株当たりの交付金銭等の額
未定の場合: - 、非設定の場合: 空文字 が設定されます。
2014年2月24日以降のみ提供。

RetEarnnumber / string

1株当たりの利益剰余金の額
未定の場合: - 、非設定の場合: 空文字 が設定されます。
2014年2月24日以降のみ提供。

DeemDivnumber / string

1株当たりのみなし配当の額
未定の場合: - 、非設定の場合: 空文字 が設定されます。
2014年2月24日以降のみ提供。

DeemCapGainsnumber / string

1株当たりのみなし譲渡収入の額
未定の場合: - 、非設定の場合: 空文字 が設定されます。
2014年2月24日以降のみ提供。

NetAssetDecRationumber / string

純資産減少割合
未定の場合: - 、非設定の場合: 空文字 が設定されます。
2014年2月24日以降のみ提供。

CommSpecCodestring

記念配当/特別配当コード
1: 記念配当、2: 特別配当、3: 記念・特別配当、0: 通常の配当

CommDivRatenumber / string

１株当たり記念配当金額
未定の場合: - 、非設定の場合: 空文字
2022年6月6日以降のみ提供。

SpecDivRatenumber / string

１株当たり特別配当金額
未定の場合: - 、非設定の場合: 空文字
2022年6月6日以降のみ提供。

レスポンスサンプル

{
    "data": [
        {
            "PubDate": "2014-02-24",
            "PubTime": "09:21",
            "Code": "15550",
            "RefNo": "201402241B00002",
            "StatCode": "1",
            "BoardDate": "2014-02-24",
            "IFCode": "2",
            "FRCode": "2",
            "IFTerm": "2014-03",
            "DivRate": "-",
            "RecDate": "2014-03-10",
            "ExDate": "2014-03-06",
            "ActRecDate": "2014-03-10",
            "PayDate": "-",
            "CARefNo": "201402241B00002",
            "DistAmt": "",
            "RetEarn": "",
            "DeemDiv": "",
            "DeemCapGains": "",
            "NetAssetDecRatio": "",
            "CommSpecCode": "0",
            "CommDivRate": "",
            "SpecDivRate": ""
        }
    ],
    "pagination_key": "value1.value2."
}

Was this page helpful?