無料でAPIキー取得
すべての APIexpand_more
search
appsすべての API
function指標の計算方法

増配・減配イベント

GET/stable/dividend-changes1 回 10 トークン

決算短信から検知した増配・減配を、変更前後の年間配当、変動率、配当利回り、出典書類つきで返します。銘柄を省略すると市場全体を調べられます。変動率と利回りは、ほかの API と同じく 0〜1 の小数(0.1 = 10%)です。

この API でできること

  • check_circle最近増配した銘柄を市場全体から探す
  • check_circle減配があった銘柄を保有銘柄の中から確認する
  • check_circle増配率の大きい順に並べて注目銘柄の候補にする

例の URL

https://api.zenithcode.net/stable/dividend-changes?symbol=7203&from=2026-04-01&to=2026-06-30&changeFlag=increase&limit=100

読みやすいように符号化せずに表示しています。日本語などの値は、送るときに自動で符号化されます。

パラメータ

引数必須説明例
symbol
string
任意証券コード(4 桁)。省略すると市場全体7203
from
string
任意開始日(YYYY-MM-DD)。検知日の下限2026-04-01
to
string
任意終了日(YYYY-MM-DD)。検知日の上限2026-06-30
changeFlag
select
任意増配だけなら increase、減配だけなら decrease。省略すると両方
選べる値: increase, decrease
increase
limit
number
任意返す件数の上限(既定 100、最大 500)100

試してみる

自分の条件で実行して、応答を表・JSON・CSV で確かめられます。ログインが必要で、実行するたびに 10 トークンを使います。

travel_exploreAPI ビューワーで試す

応答の例(実データ)

lock
実データの応答例は、ログインした方だけに表示しています(株価などの取引所データを含むため)。 ログインして見る

レスポンス項目

symbolstring
changeFlagincrease=増配 / decrease=減配stringincrease=増配 / decrease=減配
detectedDate検知日(原則 TDnet 発表日の JST 日付)string検知日(原則 TDnet 発表日の JST 日付)
announcementDate短信の発表日時string短信の発表日時
targetPeriodEndDate対象期末日string対象期末日
previousAnnualDividend変更前の年間配当(円)number変更前の年間配当(円)計算方法 →
newAnnualDividend変更後の年間配当(円)number変更後の年間配当(円)計算方法 →
changeRate年間配当の変動率。0〜1 の小数(0.1 = +10%)number年間配当の変動率。0〜1 の小数(0.1 = +10%)計算方法 →
previousDividendYield変更前配当での利回り(検知日終値ベース)。0〜1 の小数(0.03 = 3%)number変更前配当での利回り(検知日終値ベース)。0〜1 の小数(0.03 = 3%)計算方法 →
newDividendYield変更後配当での利回り(検知日終値ベース)。0〜1 の小数(0.03 = 3%)number変更後配当での利回り(検知日終値ベース)。0〜1 の小数(0.03 = 3%)計算方法 →
closePrice利回り計算に使った終値number利回り計算に使った終値
priceDatestring
sourceDocId出典 TDnet 書類の doc_idstring出典 TDnet 書類の doc_id
sourceUrl出典の PDF(ZENITH Code の配信経路 /stable/filing-document。API キーが要る)string出典の PDF(ZENITH Code の配信経路 /stable/filing-document。API キーが要る)
sourceTitle出典書類タイトルstring出典書類タイトル

関連する API

よくある質問

1 回の呼び出しでトークンをいくつ使いますか?expand_more

10 トークンです。件数や期間によらず、1 回の呼び出しごとに同じ数を使います。月の上限はプランによって決まります。

試すのに登録は必要ですか?expand_more

API ビューワーで、自分の条件で実行して応答を確かめられます。無料登録してログインしてください(クレジットカード不要)。実行するたびに、この API のトークンを使います。

CSV で受け取れますか?expand_more

URL に format=csv を付けると CSV で返ります。表計算ソフトや pandas にそのまま読み込めます。

英語で受け取れますか?expand_more

lang も Accept-Language も無いと、業種名などの label は英語で返ります。日本語にするには lang=ja を付けるか、Accept-Language: ja を送ります。企業名・業種名は nameJa / nameEn、sectorJa / sectorEn のように両方の項目で常に返ります。項目名は日英とも同じです。