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

Split and Dividend Adjustments

Details

Docs navigation

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_type if your method treats them differently.
  • Stock dividends and spinoffs are recorded as their own action_type. Spinoffs are not folded into adjusted_close in v1.
  • Options are not price-adjusted. After a split, the OCC changes the contract terms instead, and adjusted contracts show is_adjusted: true in 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.