Stock Split History

Retrieve historical stock split information including execution dates, split ratios, and adjustment types. Adjust historical prices for accurate analysis.

Use Case: Adjust historical price charts for all past stock splits to show accurate returns.

GET /v1/stock/split

Get Stock Split History

cURL

curl --request GET \
  --url https://api.aries.com/v1/stock/split \
  --header 'Authorization: Bearer <token>'

200

default

{
  "results": [
    {
      "id": "E987D589F61E7FAE48774F7C79B0E801",
      "ticker": "AAPL",
      "executionDate": "2020-08-31",
      "splitFrom": 1,
      "splitTo": 4,
      "adjustmentType": "forward_split",
      "historicalAdjustmentFactor": 0.25
    }
  ],
  "status": "OK",
  "requestId": "a47d1beb8c11b6ae897ab76a1b095d8d"
}

Query parameter notes

The tickers query parameter accepts a single symbol only. If you need multiple symbols, use tickersAnyOf with a comma-separated list.

The sort query parameter is a plain string, not an enum and not a separate asc / desc selector. Send the sort column together with its direction in the same value, for example sort=execution_date.desc or sort=ticker.asc,execution_date.desc.

Response payload

Successful responses return a results array of split events. Each event uses ticker, executionDate, splitFrom, and splitTo; optional event metadata includes id, adjustmentType, and historicalAdjustmentFactor. Paginated responses can include nextUrl, and the response wrapper includes status.

Authorizations

Authorization · string · header · required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Query Parameters

tickers · string

Single ticker symbol only, such as AAPL. Do not send a comma-separated list here; if you need multiple symbols, use tickersAnyOf instead.

Example:

"AAPL"

tickersAnyOf · string

Comma-separated list of ticker symbols.

Example:

"AAPL,TSLA,NVDA"

tickerFrom · string

Filter tickers >= this value (inclusive)

Example:

"A"

tickerAfter · string

Filter tickers > this value (exclusive)

Example:

"A"

tickerTo · string

Filter tickers <= this value (inclusive)

Example:

"Z"

tickerBefore · string

Filter tickers < this value (exclusive)

Example:

"Z"

executionDate · string<date>

Exact execution date in YYYY-MM-DD format

Example:

"2020-08-31"

executionDateFrom · string<date>

Filter to splits that executed on or after this date (inclusive). Format: YYYY-MM-DD.

Example:

"2020-01-01"

executionDateAfter · string<date>

Filter to splits that executed strictly after this date (exclusive). Format: YYYY-MM-DD.

Example:

"2020-01-01"

executionDateTo · string<date>

Filter to splits that executed on or before this date (inclusive). Format: YYYY-MM-DD.

Example:

"2024-12-31"

executionDateBefore · string<date>

Filter to splits that executed strictly before this date (exclusive). Format: YYYY-MM-DD.

Example:

"2024-12-31"

adjustmentType · enum<string>

Exact type: forward_split, reverse_split, stock_dividend

Available options: forward_split, reverse_split, stock_dividend

Example:

"forward_split"

adjustmentTypes · string

Comma-separated list of adjustment types

Example:

"forward_split,reverse_split"

limit · integer

Maximum number of results to return. Range: 1 to 5000. Use smaller values for UI pages, larger for batch exports.

Required range: 1 <= x <= 5000

Example:

100

sort · string

A comma-separated list of sort columns. For each column, append .asc or .desc to specify direction. Defaults to ticker.asc when not specified. Examples: execution_date.desc or ticker.asc,execution_date.desc.

next · string

Pagination cursor from previous response

Response

200

application/json

Successful response

results · object[] · required

Array of stock split events

Show child attributes

status · string · required

Status string from the upstream data provider — typically OK for a successful response. Treat any other value as an error indicator alongside the HTTP status code.

Example:

"OK"

nextUrl · string

Pagination URL for the next page, when available

requestId · string

Provider request identifier, when available