Split and Dividend Adjustments
Details
Docs navigation
- Getting started: Quickstart, Authentication, Rate limits, Errors and retries
- Guides: Symbol formats, Timestamps and time zones, Pagination, Split and dividend adjustments (you are here), WebSocket streaming, Dataset downloads, Excel and Google Sheets, Changelog
- API reference: Stock bars, Stock trades and quotes, Snapshots and movers, Tickers, exchanges, calendar, Splits and dividends, Fundamentals and SEC filings, Options chain and Greeks, Options EOD, bars, OI, Forex, Crypto, Crypto derivatives, Futures bars and continuous, Settlements and COT, Indices, Economic data, Technical indicators
- SDKs: Python, JavaScript
When a stock splits 4-for-1, its price drops to a quarter overnight while nothing real has changed. Unadjusted history shows a 75% crash that never happened. This page explains the split adjusted price calculation we use, how dividend adjustment works on top of it, which fields carry which version of the price, and how to rebuild either one yourself. You need it for any backtest that spans a split or relies on total return.
Early access. Stock bars are not live yet. These rules are the v1 design and match the corporate actions endpoint.
Schema
What each field holds
Every daily stock bar carries three versions of the price:
| Field | Split-adjusted | Dividend-adjusted | Use it for |
|---|---|---|---|
open, high, low, close, volume |
Yes | No | Charts, signals, intraday logic |
unadjusted_open ... unadjusted_close, unadjusted_volume |
No | No | Matching broker fills, what actually printed |
adjusted_close |
Yes | Yes | Total-return backtests, long-horizon performance |
Intraday bars are split-adjusted by default and carry an adjusted flag. Pass adjusted=false to get raw prices.
Pricing
The split adjusted price calculation
1. Find the ratio
A split is stored as split_from and split_to. In a 4-for-1 split, split_from is 1 and split_to is 4. A 1-for-10 reverse split has split_from 10 and split_to 1.
2. Adjust every bar before the ex-date
adjusted_price = raw_price x split_from / split_to
adjusted_volume = raw_volume x split_to / split_from
Bars on or after the ex-date are left alone.
3. Chain multiple splits
For a bar dated before several splits, multiply the factors of every split that came after it. A stock that split 2-for-1 and later 3-for-1 has a factor of 1/6 for bars older than both.
Worked example (illustrative numbers): a stock closes at 400.00 the day before a 4-for-1 split and at 101.00 on the ex-date. The adjusted close for the day before is 400.00 x 1/4 = 100.00, so the series shows a 1% rise, which is what holders actually saw.
Details
Dividend adjustment
A cash dividend lowers the share price by about the dividend on the ex-date. To make returns continuous, every price before the ex-date is multiplied by:
factor = 1 - dividend / previous_close
previous_close is the close on the trading day before the ex-date. Example from our schema: a $0.51 dividend on a stock that closed at about $71.03 gives a factor of 0.99282, which is the adjustment_factor on that dividend record. Factors from every later dividend and split are multiplied together, and adjusted_close is the raw close times that cumulative product.
Details
Rebuild it yourself
Example: rebuild split-adjusted and total-return closes from raw daily bars.
import pandas as pd
def adjust(df: pd.DataFrame) -> pd.DataFrame:
"""df needs date, unadjusted_close, dividend, split_factor, sorted by date."""
df = df.sort_values("date").reset_index(drop=True)
split_mult = 1.0
total_mult = 1.0
split_col, total_col = [], []
for i in range(len(df) - 1, -1, -1):
split_col.append(split_mult)
total_col.append(total_mult)
row = df.loc[i]
if row["split_factor"] != 1:
split_mult /= row["split_factor"]
total_mult /= row["split_factor"]
if row["dividend"] > 0 and i > 0:
prev = df.loc[i - 1, "unadjusted_close"]
total_mult *= 1 - row["dividend"] / prev
df["close_split_adj"] = df["unadjusted_close"] * split_col[::-1]
df["close_total_return"] = df["unadjusted_close"] * total_col[::-1]
return df
Here split_factor is split_to / split_from (4 for a 4-for-1 split). Compare your output with our close and adjusted_close; they should agree to the cent.
Watch out
Notes and gotchas
- Adjusted history changes after every new split or dividend. A file you downloaded last year will not match today's API for the same dates. Store raw prices and the action list if you need reproducible results.
- Other vendors disagree: some adjust only the close, some adjust everything for dividends, some ship raw. Check before you mix sources.
- Special dividends and return-of-capital payments are adjusted the same way as regular ones. Filter on
dividend_typeif your method treats them differently. - Stock dividends and spinoffs are recorded as their own
action_type. Spinoffs are not folded intoadjusted_closein v1. - Options are not price-adjusted. After a split, the OCC changes the contract terms instead, and adjusted contracts show
is_adjusted: truein option reference data. - Very old adjusted prices can show many decimals or values below one cent. That is correct; round only for display.
Keep reading
Next steps
Details
Was this page useful?
[Yes] [No]
Found an adjustment that looks wrong? Send the symbol and date through the custom data form.