すべての APIexpand_more

配当政策の一覧・絞り込み

GET/stable/dividend-policies1 回 10 トークン新着

上場中の会社の配当政策（原資料と照合済み）を 1 方針 1 行で返します。DOE・配当性向・総還元性向・累進配当・下限配当・定性のみといった種類と、DOE や配当性向のしきい値で絞り込めます。しきい値は目標の値（無ければ範囲の下限）と比べ、0〜1 の小数で指定します。証券コード順に limit と offset でページを送れます。

この API でできること

check_circleDOE を採用している会社を一覧にする
check_circle累進配当を明言している会社を探す
check_circle配当性向 40% 以上を目標にする会社を絞り込む

例の URL

https://api.zenithcode.net/stable/dividend-policies?metric=doe&status=current&sector=3700&minPayoutRatio=0.3&minDoe=0.03&limit=100&offset=0

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

パラメータ

引数	必須	説明	例
`metric` select	任意	方針の種類。all（既定）/ doe / payout_ratio / total_return_ratio / progressive（累進配当を明言）/ dividend_floor / qualitative_only 選べる値: all, doe, payout_ratio, total_return_ratio, progressive, dividend_floor, qualitative_only	`doe`
`status` select	任意	current = 現在の方針（既定）、scheduled = 適用予定の方針選べる値: current, scheduled	`current`
`sector` string	任意	東証 33 業種コード（例: 3700 = 輸送用機器）。一覧は /stable/available-sectors	`3700`
`minPayoutRatio` string	任意	配当性向の下限（0〜1 の小数。0.4 = 40%）	`0.3`
`maxPayoutRatio` string	任意	配当性向の上限（0〜1 の小数）
`minDoe` string	任意	DOE の下限（0〜1 の小数。0.03 = 3%）	`0.03`
`maxDoe` string	任意	DOE の上限（0〜1 の小数）
`limit` number	任意	返す件数の上限（既定 100、最大 1,000）	`100`
`offset` string	任意	先頭から読み飛ばす件数（既定 0）	`0`

試してみる

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

travel_exploreAPI ビューワーで試す

応答の例（実データ）

lock

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

レスポンス項目

`policyId`政策の識別子	string	政策の識別子
`version`版の番号	integer	版の番号
`symbol`	string
`sectorCode`業種コード	string	業種コード
`policyStatus`current / scheduled / superseded / withdrawn	string	current / scheduled / superseded / withdrawn
`doe`DOE の目標（無ければ null）	object	DOE の目標（無ければ null）
`payoutRatio`配当性向の目標	object	配当性向の目標
`totalReturnRatio`総還元性向の目標（配当性向とは別）	object	総還元性向の目標（配当性向とは別）
`progressivePolicy`累進配当: explicit = 明示、not_stated = 記載なし、withdrawn = 取りやめ	string	累進配当: explicit = 明示、not_stated = 記載なし、withdrawn = 取りやめ
`dividendFloor`下限配当（無ければ null）	object	下限配当（無ければ null）
`conditions`複合条件（「いずれか高い方」など）。1 つの数値にしない	object	複合条件（「いずれか高い方」など）。1 つの数値にしない
`effectiveFrom`	object
`effectiveTo`	object
`source`	object
`verifiedAt`原資料と照合した日時	string	原資料と照合した日時
`evidence`数値の根拠の引用	array	数値の根拠の引用
`qualitativePolicies`定性方針。空は「未確認」で「方針なし」ではない	array	定性方針。空は「未確認」で「方針なし」ではない
`summaryJa`確認済みの定性方針をつないだ説明	string	確認済みの定性方針をつないだ説明

よくある質問

一覧に無い会社は配当方針が無いのですか？expand_more

必ずしもそうではありません。まだ収集・確認していない会社は載りません。1 社ずつの状況は配当政策（1 社）の status で確認できます。

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 のように両方の項目で常に返ります。項目名は日英とも同じです。