{"id":100,"date":"2021-03-01T00:33:03","date_gmt":"2021-03-01T00:33:03","guid":{"rendered":"https:\/\/eodhd.com\/knowledgebase\/?p=100"},"modified":"2026-09-16T10:15:20","modified_gmt":"2026-09-16T08:15:20","slug":"api-splits-dividends","status":"publish","type":"post","link":"https:\/\/eodhd.com\/financial-apis\/api-splits-dividends","title":{"rendered":"Corporate Actions: Splits and Dividends API"},"content":{"rendered":"\n

Corporate actions rewrite a price series after the fact. A dividend takes cash out of the share price on the ex-date; a split multiplies the share count and divides the price. Get either one wrong and a backtest, a yield calculation or a total-return chart is quietly wrong with it. This API gives you both histories for a single instrument in one request: every dividend with its amount, its currency and its declaration, record and payment dates, and every split with its exact ratio.<\/p>\n\n\n\n

History is deep. For the longest-running US payers the record starts in 1970<\/strong> \u2014 Procter & Gamble on 19 January 1970 is the earliest dividend found anywhere in our sampling, and the same floor holds for Johnson & Johnson, General Electric, IBM, Exxon and Coca-Cola. That is more than fifty-five years<\/strong> and, for Coca-Cola, 226 individual payments in one response. Splits go back almost as far: Procter & Gamble on 19 May 1970.<\/p>\n\n\n\n\n\n

\n <\/svg><\/span>\n
\n\n

Both endpoints cost 1 API call per request<\/strong>, whatever the date range and however many rows come back \u2014 measured directly against the request counter, with zero drift in the measurement window. Asking for one ticker’s entire fifty-five-year dividend history costs exactly as much as asking for last quarter. Take the whole history once and filter locally rather than paging by year.<\/p>\n\n<\/div>\n <\/div>\n \n\n

\n <\/svg><\/span>\n
\n\n

These endpoints are per-ticker. To pull every split or every dividend that landed on one date across an entire exchange, use the Bulk API<\/a>. For events that have been announced but have not happened yet, use the Calendar API<\/a> \u2014 this API is history, not schedule.<\/p>\n\n<\/div>\n <\/div>\n \n\n

\n <\/svg><\/span>\n
\n\n

You can try both endpoints before you have a key, using demo<\/strong> as the api_token \u2014 every request example on this page is a live one you can run as you read. The demo key is not limited to Apple: for these two feeds it covers AAPL.US, MSFT.US, AMZN.US, TSLA.US, MCD.US, VTI.US and SWPPX.US<\/strong>, with full history and no truncation \u2014 demo returns Apple dividends all the way back to 1987, the same 92 records a paid key sees. Any other ticker returns HTTP 403. The demo key is for evaluation only; it carries its own rate limit and is not a substitute for a plan.<\/p>\n\n<\/div>\n <\/div>\n \n\n\n

<\/div>\n\n\n\n

Dividends History API<\/h2>\n\n\n
\n
https:\/\/eodhd.com\/api\/div\/{SYMBOL}?api_token=YOUR_API_TOKEN&fmt=json<\/code><\/pre>\n<\/div>\n\n\n
Path Parameter<\/h4>\n\n\n
\n    \n
\n    
\n                    SYMBOL<\/code>\n        \n                    string<\/span>\n        \n        \n            required        <\/span>\n    <\/div>\n\n    
\n        Ticker in EODHD format, SYMBOL.EXCHANGE \u2014 for example AAPL.US, BMW.XETRA, SHEL.LSE or RY.TO. Exchange codes come from the Exchanges API. A ticker we do not carry returns HTTP 404 with the body Symbol not found, and that failed request is still billed as one call<\/span>\n            <\/div>\n<\/div>\n\n<\/div>\n\n\n\n
Query Parameters<\/h4>\n\n\n
\n    \n
\n    
\n                    api_token<\/code>\n        \n                    string<\/span>\n        \n        \n            required        <\/span>\n    <\/div>\n\n    
\n        Your EODHD API token. Omitting it returns HTTP 401 Unauthenticated<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    from<\/code>\n        \n                    date<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Start of the window, YYYY-MM-DD, inclusive. Omit it and you get the full history for the symbol<\/span>\n                    (Default: earliest available)<\/em><\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    to<\/code>\n        \n                    date<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        End of the window, YYYY-MM-DD, inclusive. Works on its own \u2014 passing only to returns everything up to that date<\/span>\n                    (Default: latest available)<\/em><\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    fmt<\/code>\n        \n                    enum<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Response format, either json or csv. The default is csv, and the comparison is case-sensitive: fmt=JSON in capitals silently serves CSV instead of failing. CSV also carries far less data than JSON \u2014 see the field table below<\/span>\n                    (Default: csv)<\/em><\/span>\n            <\/div>\n<\/div>\n\n<\/div>\n\n\n\n
Request Example<\/h4>\n\n\n    
\n                
\n            
\n                                                                        URL<\/button>\n                                                                            cURL<\/button>\n                                                                            PHP<\/button>\n                                                                            Python<\/button>\n                                                                            R<\/button>\n                                                                            Chat GPT<\/button>\n                                                <\/div>\n            
\n