EOD Historical Data

EOD Historical Data Dividends & Splits API

Dividend and split history

Documentation GitHub OpenAPI

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/eod-historical-dividends-splits-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: EODHD Financial Data Calendar Dividends & Splits API
  description: Comprehensive API for retrieving financial data including stock prices, fundamentals, calendar events, news, and more from EOD Historical Data (eodhd.com)
  version: 2.0.0
  contact:
    name: EODHD Support
    url: https://eodhd.com
    email: supportlevel1@eodhistoricaldata.com
  termsOfService: https://eodhd.com/financial-apis/terms-conditions
  license:
    name: Proprietary
    url: https://eodhd.com/financial-apis/terms-conditions
servers:
- url: https://eodhd.com/api
  description: Primary API path
- url: https://eodhistoricaldata.com/api
  description: Alternative API path
security:
- EODHDQueryKey: []
tags:
- name: Dividends & Splits
  description: Dividend and split history
paths:
  /div/{ticker}:
    get:
      summary: Retrieve historical dividend data
      description: Fetches historical dividend data for a specified stock symbol, including key dividend dates and values.
      operationId: GetHistoricalDividends
      parameters:
      - name: ticker
        in: path
        required: true
        description: Ticker symbol of the stock in the format {SYMBOL_NAME}.{EXCHANGE_ID} (e.g., 'AAPL.US' for NASDAQ or 'AAPL.MX' for the Mexican Stock Exchange).
        schema:
          type: string
      - name: api_token
        in: query
        required: true
        description: Your API key for authentication.
        schema:
          type: string
      - name: from
        in: query
        required: false
        description: Start date for data retrieval in 'YYYY-MM-DD' format. Defaults to earliest available data if not provided.
        schema:
          type: string
          format: date
      - name: to
        in: query
        required: false
        description: End date for data retrieval in 'YYYY-MM-DD' format. Defaults to latest available data if not provided.
        schema:
          type: string
          format: date
      - name: fmt
        in: query
        required: false
        description: Output format, either 'json' or 'csv'. Defaults to 'json'.
        schema:
          type: string
          enum:
          - json
          - csv
          default: json
      responses:
        '200':
          description: Successfully retrieved historical dividend data.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    date:
                      type: string
                      format: date
                      description: Ex-dividend date.
                    declarationDate:
                      type: string
                      format: date
                      description: Declaration date of the dividend.
                    recordDate:
                      type: string
                      format: date
                      description: Record date for dividend eligibility.
                    paymentDate:
                      type: string
                      format: date
                      description: Dividend payment date.
                    period:
                      type: string
                      description: Dividend period (e.g., 'Quarterly').
                    value:
                      type: number
                      format: float
                      description: Dividend value per share in the specified currency.
                    unadjustedValue:
                      type: number
                      format: float
                      description: Unadjusted dividend value before stock splits and other adjustments.
                    currency:
                      type: string
                      description: Currency in which the dividend is paid (e.g., 'USD').
                  required:
                  - date
                  - value
                  - currency
              example:
              - date: '2012-08-09'
                declarationDate: '2012-07-24'
                recordDate: '2012-08-13'
                paymentDate: '2012-08-16'
                period: Quarterly
                value: 0.0946
                unadjustedValue: 2.6488
                currency: USD
              - date: '2012-11-07'
                declarationDate: '2012-10-25'
                recordDate: '2012-11-12'
                paymentDate: '2012-11-15'
                period: Quarterly
                value: 0.0946
                unadjustedValue: 2.6488
                currency: USD
        '400':
          description: Invalid request parameters.
        '401':
          description: Unauthorized. Invalid API token.
        '404':
          description: Dividend data not found for the specified ticker or date range.
      tags:
      - Dividends & Splits
  /splits/{ticker}:
    get:
      summary: Retrieve historical split data
      description: Fetches historical stock split data for a specified ticker, including split dates and ratios.
      operationId: GetHistoricalSplits
      parameters:
      - name: ticker
        in: path
        required: true
        description: Ticker symbol of the stock in the format {SYMBOL_NAME}.{EXCHANGE_ID} (e.g., 'AAPL.US' for NASDAQ or 'AAPL.MX' for the Mexican Stock Exchange).
        schema:
          type: string
      - name: api_token
        in: query
        required: true
        description: Your API key for authentication.
        schema:
          type: string
      - name: from
        in: query
        required: false
        description: Start date for data retrieval in 'YYYY-MM-DD' format. Defaults to earliest available data if not provided.
        schema:
          type: string
          format: date
      - name: to
        in: query
        required: false
        description: End date for data retrieval in 'YYYY-MM-DD' format. Defaults to latest available data if not provided.
        schema:
          type: string
          format: date
      - name: fmt
        in: query
        required: false
        description: Output format, either 'json' or 'csv'. Defaults to 'json'.
        schema:
          type: string
          enum:
          - json
          - csv
          default: json
      responses:
        '200':
          description: Successfully retrieved historical split data.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    date:
                      type: string
                      format: date
                      description: Date of the stock split.
                    split:
                      type: string
                      description: Split ratio represented as '{new shares}/{old shares}' (e.g., '2.000000/1.000000').
                  required:
                  - date
                  - split
              example:
              - date: '2000-06-21'
                split: 2.000000/1.000000
              - date: '2005-02-28'
                split: 2.000000/1.000000
              - date: '2014-06-09'
                split: 7.000000/1.000000
              - date: '2020-08-31'
                split: 4.000000/1.000000
        '400':
          description: Invalid request parameters.
        '401':
          description: Unauthorized. Invalid API token.
        '404':
          description: Split data not found for the specified ticker or date range.
      tags:
      - Dividends & Splits
components:
  securitySchemes:
    EODHDQueryKey:
      type: apiKey
      in: query
      name: api_token
      description: EODHD API key (stored as a secret in ChatGPT).