Early access is open. Free sample datasets are live now. Download a sample

Data product · Early access

Stock Splits and Dividends Data API

Every event that changes a stock's price history or its ticker, with the dates that matter, so you can adjust your own bars or plan around the next ex-date.

Coverage

What you get

Item Detail
Product code STK-CORP-ACTIONS
Coverage US stocks: cash and stock dividends, splits, reverse splits, symbol changes, mergers, spinoffs, delistings
Granularity One record per event
History Free: 2 years of dividends and splits. Starter and up: full history plus symbol changes, mergers and adjustment factors
Delivery REST, CSV and JSON files
Update speed Daily, as events are announced or changed

A split you missed turns a clean backtest into nonsense. A ticker change you missed drops a stock from your universe halfway through a test. This feed exists so neither happens quietly.

Schema

Schema

Field Type Required Description
symbol string yes Ticker at the time of the event
event_id string yes Our stable ID for the event
action_type string yes cash_dividend, stock_dividend, split, reverse_split, symbol_change, merger, spinoff, delisting
ex_date string yes Ex-date (effective date for splits and changes)
declaration_date string optional Announcement date
record_date string optional Record date
pay_date string optional Payment date
cash_amount number optional Dividend per share
currency string optional Dividend currency
frequency number optional Payments per year (0 = one-off)
dividend_type string optional regular, special, return_of_capital
split_from number optional e.g. 1 in a 4-for-1 split
split_to number optional e.g. 4 in a 4-for-1 split
old_symbol string optional Previous ticker (symbol changes)
new_symbol string optional New ticker
adjustment_factor number optional Price multiplier for history before ex_date
isin string optional ISIN
figi string optional FIGI
updated_at string yes Last change to the record, ISO 8601 UTC

Example record:

{
  "symbol": "KO",
  "event_id": "ca_20261128_KO_div",
  "action_type": "cash_dividend",
  "ex_date": "2026-11-28",
  "declaration_date": "2026-10-16",
  "record_date": "2026-11-28",
  "pay_date": "2026-12-15",
  "cash_amount": 0.51,
  "currency": "USD",
  "frequency": 4,
  "dividend_type": "regular",
  "adjustment_factor": 0.99282,
  "isin": "US1912161007",
  "figi": "BBG000BMX289",
  "updated_at": "2026-10-16T20:41:12Z"
}

Sample data

Sample data

We haven't published a free corporate actions sample yet. A sample file is available on request: send the tickers you care about and we'll return their dividend and split history in this schema.

Use cases

Use cases

Adjusting your own price history. If you store raw bars, multiply every price before ex_date by adjustment_factor. For splits, split_from and split_to give the ratio directly: a 4-for-1 is 1 and 4.

Dividend calendars. Filter action_type on cash_dividend and sort by ex_date. To get the dividend you must own the stock before the ex-date, so that's the date to watch, not pay_date.

Keeping a universe intact. symbol_change events link old_symbol to new_symbol. Join on them and a company that renamed itself mid-test stays in your results under one history.

Yield screens. cash_amount times frequency, divided by price, gives a forward yield. dividend_type lets you drop special payouts that would inflate it.

Code

Code examples

Example: all dividends and splits for KO since 2020.

curl "https://api.marketdata.co/v1/stocks/corporate-actions?symbol=KO&start=2020-01-01" \
  -H "Authorization: Bearer $MARKETDATA_API_KEY"

Example: Python, the last eight dividends with their adjustment factors.

import os
import requests
import pandas as pd

resp = requests.get(
    "https://api.marketdata.co/v1/stocks/corporate-actions",
    params={"symbol": "KO", "start": "2020-01-01"},
    headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
ca = pd.DataFrame(resp.json()["results"])
ca["ex_date"] = pd.to_datetime(ca["ex_date"])
divs = ca[ca["action_type"] == "cash_dividend"].sort_values("ex_date")
print(divs[["ex_date", "pay_date", "cash_amount", "adjustment_factor"]].tail(8))

Pricing

Pricing

Plan Splits and dividends
Free, $0 2 years of dividends and splits
Starter, $29/mo Full history, symbol changes, mergers, adjustment factors
Business, $249/mo Commercial use

A full US history file is planned at $49 one-off, and it comes free with any of our bar datasets. Prices are early access and may change.

Paid plans that include corporate actions run from $14 to $375 a month among the vendors we studied, median $104.50. Six offer the basics free.

Side by side

How we compare

22 of the 50 providers we studied sell splits and dividends. The basics are easy to find free. What usually costs extra is the part you need to rebuild history correctly: adjustment factors and symbol changes. We put those in Starter, publish the price, and use the same symbol and date formats as our bars, so the join is one line.

FAQ

Frequently asked questions

Which date should I use to adjust prices?

Use ex_date. It's the first day the stock trades without the dividend or at the new split ratio, and it's the date adjustment_factor applies to.

Do you cover reverse splits?

Yes, as reverse_split. A 1-for-10 reverse split has split_from of 10 and split_to of 1.

How quickly do new announcements appear?

Updates run daily. If a company changes a date after announcing it, the record keeps its event_id and updated_at moves forward, so you can sync on changes.

Are special dividends included?

Yes, with dividend_type set to special. Return-of-capital payments are tagged separately as return_of_capital.

What formats can I get?

JSON from the API, and CSV or JSON for the history file. Column names are the same in both.

Keep reading