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
Related
- Asset hub: Stocks
- Symbols: AAPL, MSFT, NVDA, AMZN, GOOGL, META
- Docs: API reference: corporate actions, Adjustments
- Learn: Split and dividend adjustments explained