All APIsexpand_more
Dividend history
/stable/dividends1 tokens per callPopularReturns the dividend history of a stock, newest first, including company forecasts. Dividends are per share in JPY.
What you can do with this API
- check_circleReview past dividends to judge stability
- check_circleCheck the forecast dividend to estimate yield
- check_circleList dividends of your holdings to estimate annual income
Example URL
https://api.zenithcode.net/stable/dividends?symbol=7203&limit=40Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.
Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
symbolstring | Required | Securities code (4 characters, e.g. 7203 = Toyota Motor; alphanumeric codes such as 130A also work) | 7203 |
limitnumber | Optional | Maximum number of rows to return (default 40, max 100) | 40 |
Try it
Run it with your own parameters and check the response as a table, JSON or CSV. Sign-in required; each run uses 1 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
How many tokens does one call use?expand_more
1 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.