Historical Splits and Dividends data API

Dividends and stock splits are essential elements for investors and analysts looking to understand the value and growth potential of a company. Dividends represent periodic payments made to shareholders, reflecting a company’s profitability, while stock splits adjust the number of shares outstanding, often making stocks more accessible to investors. Understanding historical dividend data and tracking stock splits are crucial for portfolio management, financial modeling, and investment analysis.

Our API allows users to access free dividend history data with up to one year of historical dividend data, perfect for those seeking foundational insights. Additionally, we provide over 30 years of comprehensive data for paid users, enabling deep analysis and historical trends. You can easily download dividend history or integrate API dividend history into your projects for streamlined financial analysis. Whether you’re a casual investor, financial analyst, or developer, our free and premium data options empower you with the insights needed to make informed decisions.

Currently, free users should contact support in order to activate access to 1 year of Historical data for Dividends and Splits.

Available with: All-In-One, EOD Historical Data — All World, EOD+Intraday — All World Extended and Free (1 year of history only) plans.
Consumption: Each request consumes 1 API call.

Register & Get Data

There is a special API for splits and dividends history bulk (multiple) download.

Dividends History API

To get dividends for any ticker:

https://eodhd.com/api/div/AAPL.US?from=2000-01-01&api_token=demo&fmt=json

curl --location "https://eodhd.com/api/div/AAPL.US?from=2000-01-01&api_token=demo&fmt=json"

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://eodhd.com/api/div/AAPL.US?from=2000-01-01&api_token=demo&fmt=json',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'GET',
));

$data = curl_exec($curl);
curl_close($curl);

try {
    $data = json_decode($data, true, 512, JSON_THROW_ON_ERROR);
    var_dump($data);
} catch (Exception $e) {
    echo 'Error. '.$e->getMessage();
}

import requests

url = f'https://eodhd.com/api/div/AAPL.US?from=2000-01-01&api_token=demo&fmt=json'
data = requests.get(url).json()

print(data)

library(httr)
library(jsonlite)

url <- 'https://eodhd.com/api/div/AAPL.US?from=2000-01-01&api_token=demo&fmt=json'
response <- GET(url)

if (http_type(response) == "application/json") {
    content <- content(response, "text", encoding = "UTF-8")
    cat(content)
} else {
    cat("Error while receiving data\n")
}

In this request:

• AAPL.US consists of two parts: {SYMBOL_NAME}.{EXCHANGE_ID}. For example, you can use AAPL.MX for the Mexican Stock Exchange or AAPL.US for NASDAQ. Check the list of supported exchanges.
• from – start date from in the format “Y-m-d”
• to – end date to in the format “Y-m-d”
• api_token – API key that we will provide after a subscription

If you skip “from” or “to,” you’ll receive the maximum available data for the symbol.

For testing purposes, you can use the following API key (valid only for the AAPL.US ticker): “demo”

For dividends, we provide ex-dividend dates and values for almost all symbols in our database. For major U.S. tickers from NYSE, NASDAQ, and major European companies, we provide additional information:

• Ex-dividend date
• Declaration date
• Record date
• Payment date
• Value
• Unadjusted value
• Dividend currency

Please note that the extended format, which includes the declaration date, record date, and payment date, is available only for major U.S. tickers and exclusively in JSON format.

Historical Splits API

To get splits for any ticker:

https://eodhd.com/api/splits/AAPL.US?from=2000-01-01&api_token=demo&fmt=json

curl --location "https://eodhd.com/api/splits/AAPL.US?from=2000-01-01&api_token=demo&fmt=json"

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://eodhd.com/api/splits/AAPL.US?from=2000-01-01&api_token=demo&fmt=json',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'GET',
));

$data = curl_exec($curl);
curl_close($curl);

try {
    $data = json_decode($data, true, 512, JSON_THROW_ON_ERROR);
    var_dump($data);
} catch (Exception $e) {
    echo 'Error. '.$e->getMessage();
}

import requests

url = f'https://eodhd.com/api/splits/AAPL.US?from=2000-01-01&api_token=demo&fmt=json'
data = requests.get(url).json()

print(data)

library(httr)
library(jsonlite)

url <- 'https://eodhd.com/api/splits/AAPL.US?from=2000-01-01&api_token=demo&fmt=json'
response <- GET(url)

if (http_type(response) == "application/json") {
    content <- content(response, "text", encoding = "UTF-8")
    cat(content)
} else {
    cat("Error while receiving data\n")
}

In this request:

• AAPL.US consists of two parts: {SYMBOL_NAME}.{EXCHANGE_ID}. For example, you can use AAPL.MX for the Mexican Stock Exchange or AAPL.US for NASDAQ. Check the list of supported exchanges.
• from – start date from in the format “Y-m-d”
• to – end date to in the format “Y-m-d”
• api_token – API key that we will provide after a subscription

If you skip “from” or “to,” you’ll receive the maximum available data for the symbol.

For testing purposes, you can use the following API key (valid only for the AAPL.US ticker): “demo”

Register & Get Data