Splits

GET
/stocks/v1/splits

Retrieve historical stock split events, including execution dates and ratio factors, to understand changes in a company’s share structure over time. Also find adjustment factors that can be used to normalize historical prices to today's share basis.

Use Cases: Historical analysis, price adjustments, data consistency, modeling.

Plan AccessIncluded in all Stocks plans
Stocks BasicFree
Updated daily
Stocks Starter$29/mo
Updated daily
Stocks Developer$79/mo
Updated daily
Stocks Advanced$199/mo
Updated daily
Plan RecencyUpdated daily
Stocks BasicFree
2 years
Stocks Starter$29/mo
All history
Stocks Developer$79/mo
All history
Stocks Advanced$199/mo
All history
Plan HistoryRecords date back to October 25, 1978
Query Parameters
ticker
string
Stock symbol for the company that executed the split
execution_date
string
Date when the stock split takes effect. The adjustment is applied overnight. On the prior trading day, the post-market session is the last session that shows pre-split prices. On the execution date, all trading is already adjusted for the split. This includes the pre-market session. Value must be formatted 'yyyy-mm-dd'.
adjustment_type
enum (string)
Classification of the share-change event. Possible values include: forward_split (share count increases), reverse_split (share count decreases), stock_dividend (shares issued as a dividend)
limit
integer
Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '5000'.
sort
string
A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'execution_date' if not specified. The sort order defaults to 'desc' if not specified.
Response Attributes
next_url
string
optional
If present, this value can be used to fetch the next page.
request_id
string
A request id assigned by the server.
results
array (object)
The results for this request.
adjustment_type
string
Classification of the share-change event. Possible values include: forward_split (share count increases), reverse_split (share count decreases), stock_dividend (shares issued as a dividend)
execution_date
string
optional
Date when the stock split takes effect. The adjustment is applied overnight. On the prior trading day, the post-market session is the last session that shows pre-split prices. On the execution date, all trading is already adjusted for the split. This includes the pre-market session.
historical_adjustment_factor
number
optional
Cumulative adjustment factor used to offset split effects on historical prices. To adjust a historical price for splits: for a price on date D, find the first split whose `execution_date` is after date D and multiply the unadjusted price by the `historical_adjustment_factor`.
id
string
optional
Unique identifier for each stock split event
split_from
number
optional
Denominator of the split ratio (old shares)
split_to
number
optional
Numerator of the split ratio (new shares)
ticker
string
optional
Stock symbol for the company that executed the split
status
enum (OK)
The status of this request's response.
Code Examples
curl -X GET "https://api.massive.com/stocks/v1/splits"
Query URL
GET
https://api.massive.com/stocks/v1/splits?apiKey=YOUR_API_KEY
Run query unavailable
Create account or sign in to Massive
Scroll to see updated query response
Response Object
{
  "request_id": 1,
  "results": [
    {
      "adjustment_type": "forward_split",
      "execution_date": "2005-02-28",
      "historical_adjustment_factor": 0.017857,
      "id": "E90a77bdf742661741ed7c8fc086415f0457c2816c45899d73aaa88bdc8ff6025",
      "split_from": 1,
      "split_to": 2,
      "ticker": "AAPL"
    }
  ],
  "status": "OK"
}
Did you find this page helpful?
Do you still need help with something?