Financial Data API

Get Stock Splits by Ticker

Returns the complete history of forward and reverse stock splits for a single ticker. Each record includes the split date, structured split ratio ({ from, to }), split factor, pre/post-split share counts, pre/post-split reference prices, currency, and a reverse-split flag. Results are sorted by split date in descending order so the most recent split appears first.

Use this endpoint to back-adjust raw OHLCV price data, reconcile share counts and cost basis in portfolio systems after a split, screen reverse-split tickers, or display a ticker's complete split timeline alongside fundamentals. The data covers major US tickers like NVDA (10-for-1 in 2024), AAPL (4-for-1 in 2020, 7-for-1 in 2014, three 2-for-1 splits between 1987 and 2005), AMZN (20-for-1 in 2022), TSLA (3-for-1 in 2022, 5-for-1 in 2020), MSFT, GOOG, WMT, NFLX, plus international markets.

The endpoint accepts ticker symbols, SEC CIK numbers, CUSIP codes, and ISIN codes, so you can integrate it directly into workflows that resolve companies by any of these. Add format=excel to import the history into Google Sheets via IMPORTDATA().

GEThttps://api.roic.ai/v2/stock-splits/{identifier}

Parameters

Path Parameters

identifierstringrequired

Company identifier — supports ticker symbol (e.g., `AAPL`), CIK, CUSIP, or ISIN.

Example: AAPL

Query Parameters

apikeystringrequired

Your API key for authentication.

formatstringoptional

Response format. Use `json` for JSON (default) or `excel` for tab-separated values compatible with Google Sheets and Excel.

Default: jsonValues: json, excel

Code Examples

curl "https://api.roic.ai/v2/stock-splits/AAPL?apikey=YOUR_API_KEY"

Response

Response200 OK
[
  {
    "id": "split_k4932wzL8zdEG8GB1FTPc",
    "symbol": "AAPL",
    "split_date": "2020-08-31",
    "split_ratio": {
      "to": 4,
      "from": 1
    },
    "split_factor": 4,
    "is_reverse_split": false,
    "pre_split_shares": 4244190750,
    "post_split_shares": 16976763000,
    "pre_split_price": 516.16,
    "post_split_price": 129.04,
    "currency": "usd"
  },
  {
    "id": "split_wTlNVdp2RoxvvgFpDiczK",
    "symbol": "AAPL",
    "split_date": "2014-06-09",
    "split_ratio": {
      "to": 7,
      "from": 1
    },
    "split_factor": 7,
    "is_reverse_split": false,
    "pre_split_shares": 855595857,
    "post_split_shares": 5989171000,
    "pre_split_price": 656.04,
    "post_split_price": 93.72,
    "currency": "usd"
  }
]

Field Dictionary

FieldDescription
idUnique identifier for the split record
symbolTicker symbol
split_dateEffective split date (YYYY-MM-DD)
split_ratioStructured split ratio as { from: number, to: number }
split_factorNet multiplier applied to share counts (e.g., 4 for a 4-for-1 split)
is_reverse_splittrue when the split reduced total shares outstanding
pre_split_sharesShares outstanding before the split
post_split_sharesShares outstanding after the split
pre_split_priceReference price before the split
post_split_priceReference price after the split
currencyLowercase ISO currency code of the price fields

Use Cases

  • Adjusted price calculations. Apply split_factor to historical OHLCV data to compute back-adjusted close, open, high, low, and volume series.
  • Long-term return analysis. Account for every split in a ticker's history when computing total return over multi-decade periods.
  • Reverse split screening. Filter is_reverse_split to flag tickers that consolidated shares, often a signal of distressed or low-priced stocks.
  • Share count reconciliation. Use pre_split_shares and post_split_shares to keep portfolio holdings and cost basis accurate.
  • Corporate action audit. Display a ticker's split timeline alongside earnings, dividends, and price charts in a research dashboard.
  • AI-powered split analysis. Feed structured split events into language models for automated commentary on capital structure history.
  • Spreadsheet models. Use format=excel with Google Sheets IMPORTDATA() to pull a ticker's split history into a live model.
  • Identifier-agnostic integration. Look up split history by ticker symbol, SEC CIK, CUSIP, or ISIN.

Frequently Asked Questions

How do I get NVDA stock split history? Send GET /v2/stock-splits/NVDA with your API key. The response includes NVIDIA's split history, including the 10-for-1 split on June 10, 2024.

How do I get Apple stock split history (AAPL)? Send GET /v2/stock-splits/AAPL. AAPL is available on the free tier and returns all five Apple splits: 4-for-1 (2020), 7-for-1 (2014), 2-for-1 (2005), 2-for-1 (2000), and 2-for-1 (1987).

How do I identify reverse stock splits? Filter results where is_reverse_split is true or where split_factor is below 1. The split_ratio field will show from greater than to (a 1-for-20 reverse split returns { from: 20, to: 1 }).

Can I look up splits by CIK, CUSIP, or ISIN? Yes. Replace the ticker in the path with any standard identifier. GET /v2/stock-splits/0000320193 resolves to AAPL.

  • Stock Splits Calendar. Browse splits across all tickers instead of a single ticker history.
  • Historical Stock Prices. Pair the split history with daily OHLCV data to back-adjust prices.
  • Company Profile. Get company overview, sector, and market cap for the same ticker.
  • Per-Share Data. EPS, book value per share, and other per-share metrics affected by splits.
  • Search Tickers. Resolve a company name or identifier to a ticker before fetching split history.