Splits
GET
/v3/reference/splits
Retrieve historical stock split events, including execution dates and ratio factors, to understand changes in a company’s share structure over time. Polygon.io leverages this data for accurate price adjustments in other endpoints, such as the Aggregates API, ensuring that users can access both adjusted and unadjusted views of historical prices for more informed analysis.
Use Cases: Historical analysis, price adjustments, data consistency, modeling.
Query Parameters
ticker
string
Specify a case-sensitive ticker symbol. For example, AAPL represents Apple Inc.
execution_date
string
Query by execution date with the format YYYY-MM-DD.
reverse_split
boolean
Query for reverse stock splits. A split ratio where split_from is greater than split_to represents a reverse split. By default this filter is not used.
order
enum (string)
Order results based on the `sort` field.
limit
integer
Limit the number of results returned, default is 10 and max is 1000.
sort
enum (string)
Sort field used for ordering.
Response Attributes
next_url
string
optional
If present, this value can be used to fetch the next page of data.
request_id
string
optional
A request id assigned by the server.
results
array (object)
optional
An array of results containing the requested data.
execution_date
string
The execution date of the stock split. On this date the stock split was applied.
id
string
The unique identifier for this stock split.
split_from
number
The second number in the split ratio.
For example: In a 2-for-1 split, split_from would be 1.
For example: In a 2-for-1 split, split_from would be 1.
split_to
number
The first number in the split ratio.
For example: In a 2-for-1 split, split_to would be 2.
For example: In a 2-for-1 split, split_to would be 2.
ticker
string
The ticker symbol of the stock split.
status
string
optional
The status of this request's response.