All APIsexpand_more
Ex-dividend calendar
/stable/dividends-calendar10 tokens per callLists ex-dividend dates across the whole market for a date range, covering both past and upcoming dates. The range is at most 93 days, and both from and to are required.
What you can do with this API
- check_circleList stocks going ex-dividend this month to find dividend candidates
- check_circleAdd ex-dividend dates of your holdings to a calendar
- check_circleCompare how many dividend events occur each month
Example URL
https://api.zenithcode.net/stable/dividends-calendar?from=2026-08-01&to=2026-09-30&limit=200Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.
Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
fromstring | Required | Start date (YYYY-MM-DD, required). At most 93 days before to | 2026-08-01 |
tostring | Required | End date (YYYY-MM-DD, required) | 2026-09-30 |
limitnumber | Optional | Maximum number of rows to return (default 200, max 500) | 200 |
Try it
Run it with your own parameters and check the response as a table, JSON or CSV. Sign-in required; each run uses 10 tokens.
travel_exploreTry in the API ViewerResponse example (real data)
Response fields
symbol証券コード（4 桁） | string | 証券コード（4 桁） |
periodEndDate権利確定基準日（期末） | string | 権利確定基準日（期末） |
periodType基準日の区分（Q1 / Q2 / Q3 / FY） | string | 基準日の区分（Q1 / Q2 / Q3 / FY） |
exDividendDate権利落ち日 | string | 権利落ち日 |
paymentDate支払日 | string | 支払日 |
announcementDate公表日時（決算短信・配当予想の修正の発表） | string | 公表日時（決算短信・配当予想の修正の発表） |
amountamount is the split-adjusted dividend per share (else as disclosed); rawAmount is the amount as disclosed. | number | amount is the split-adjusted dividend per share (else as disclosed); rawAmount is the amount as disclosed.How it is calculated → |
rawAmountamount is the split-adjusted dividend per share (else as disclosed); rawAmount is the amount as disclosed. | number | amount is the split-adjusted dividend per share (else as disclosed); rawAmount is the amount as disclosed.How it is calculated → |
currency通貨（JPY） | string | 通貨（JPY） |
dividendType配当の種類。annual = 年間合計の行、quarterly など = 各回の配当（年間合計と各回が両方あるので合算に注意） | string | 配当の種類。annual = 年間合計の行、quarterly など = 各回の配当（年間合計と各回が両方あるので合算に注意） |
forecastOrActualforecast=予想 / actual=実績 | string | forecast=予想 / actual=実績 |
dataSource出典（TDnet など） | string | 出典（TDnet など） |
Related APIs
FAQ
What is an ex-dividend date?expand_more
From this date, buying the stock no longer entitles you to the upcoming dividend. To receive it you must buy before this date.
How many tokens does one call use?expand_more
10 tokens per call, regardless of how many rows come back. Your monthly allowance depends on your plan.
Do I need an account to try it?expand_more
Use the API Viewer to run it with your own parameters. Sign up for free and sign in (no credit card). Each run uses this API's tokens.
Can I get CSV instead of JSON?expand_more
Add format=csv to the URL to get CSV, ready for spreadsheets or pandas.
Can I get labels in English?expand_more
With neither lang nor Accept-Language, labels such as sector names are returned in English; add lang=ja or send Accept-Language: ja for Japanese. Company and sector names are always returned in both languages as nameJa / nameEn and sectorJa / sectorEn. Field names are the same in both languages.