List stock splits

Return a filterable, market-wide page of stock-split events. Splits are per ticker: by default the collection spans every ticker; pass identifier to restrict it to one. The response symbol echoes the exact listing you requested.

GET/v3.0.0/stock-splits

Plan Access

Free

(Your plan)

Individual

$29/mo

Professional

$89/mo

Plan History

Free

(Your plan)

2 years

Individual

$29/mo

5 years

Professional

$89/mo

All available

Request
curl "https://api.roic.ai/v3.0.0/stock-splits?apikey=YOUR_API_KEY&identifier=NASDAQ:AAPL&order=desc"
Response
200 OK
{
  "data": [
    {
      "id": "spl_JIzTRxIRzvG0wv",
      "object": "v3.market_data.stock_split",
      "symbol": "NASDAQ:AAPL",
      "execution_date": "2020-08-31",
      "factor": 4,
      "split_from": 1,
      "split_to": 4,
      "is_reverse": false,
      "pre_split_shares": 4264405500,
      "post_split_shares": 17057622000,
      "pre_split_price": 499.23,
      "post_split_price": 124.8075,
      "currency": "USD"
    }
  ],
  "next_page_url": null,
  "previous_page_url": null
}

Parameters

Query parameters

identifierstringoptional

Restrict results to a single ticker. Accepts an exchange and symbol separated by a colon (e.g. NASDAQ:AAPL), a ticker ID, or a FIGI. Stock splits are per ticker, so results are the split events for that exact listing and the response symbol echoes it. Omit to list stock splits across all tickers.

Example: NASDAQ:AAPL
datestringoptional

Pass a YYYY-MM-DD date directly for an exact execution-date match. For a range, combine the modifiers below, for example, date.gte=2020-01-01&date.lt=2021-01-01.

+ Show filter modifiers
date.gtestring

Return splits whose execution date is greater than or equal to the given date.

date.gtstring

Return splits whose execution date is strictly greater than the given date.

date.ltestring

Return splits whose execution date is less than or equal to the given date.

date.ltstring

Return splits whose execution date is strictly less than the given date.

orderstringoptional

Sort by execution date (execution_date).

Default: descValues: ascdesc
limitintegeroptional

Maximum number of resources to return.

Default: 100Min: 1Max: 500
pagestringoptional

Token to request the next page of data. Each response returns ready-made next_page_url and previous_page_url (null on the last and first page, respectively) that repeat your filters with this token. They are relative and carry no credentials: prefix the API host and pass apikey separately, or keep sending your Authorization header.

Response

Each item is a v3.market_data.stock_split. Results sort by execution date in descending order by default; pass order=asc for oldest first. Scope the feed to one ticker with identifier.

Response fields

dataarray of objects

Array of stock-split resources for the current page.

+ Show child attributes
idstring

Unique identifier for the split event, beginning with spl_.

objectstring

String representing the object's type, always v3.market_data.stock_split for this resource.

symbolstring

Qualified symbol combining the exchange code and ticker separated by a colon, e.g. NASDAQ:AAPL.

execution_datestring

Date the split took effect on the exchange, in YYYY-MM-DD format. Unadjusted prices before this date must be divided by factor to stay comparable.

factornumber

Multiplier applied to the share count, computed as split_to / split_from. Greater than 1 for forward splits, e.g. 4 for a 4-for-1 split, and below 1 for reverse splits, e.g. 0.05 for a 1-for-20 consolidation.

split_fromnumber

Number of pre-split shares in the split ratio. A 4-for-1 split has split_from: 1 and split_to: 4.

split_tonumber

Number of post-split shares in the split ratio.

is_reverseboolean

Whether the event is a reverse split (consolidation): the share count decreased and the price rose proportionally.

pre_split_sharesnumber

Total shares outstanding immediately before the split.

post_split_sharesnumber

Total shares outstanding immediately after the split.

pre_split_pricenumber

Share price on the last trading day before the split, in currency units. null when price data around the event is unavailable.

post_split_pricenumber

Share price on the first trading day after the split, in currency units. null when price data around the event is unavailable.

currencystring

ISO 4217 code of the currency of the price fields, e.g. USD.

next_page_urlnullable

URL of the next page of results, or null when there are no more pages. Request it unchanged to continue paging.

previous_page_urlnullable

URL of the previous page of results, or null on the first page.

Examples

Combine the filters below to answer common questions. Each request is runnable.

The most recent stock splits across all tickers:

curl "https://api.roic.ai/v3.0.0/stock-splits?apikey=YOUR_API_KEY&order=desc&limit=10"

The full split history for one ticker:

curl "https://api.roic.ai/v3.0.0/stock-splits?apikey=YOUR_API_KEY&identifier=NASDAQ:AAPL&order=desc"

Splits executed on one exact date:

curl "https://api.roic.ai/v3.0.0/stock-splits?apikey=YOUR_API_KEY&date=2020-08-31"

Splits over one year, using a date.gte=2020-01-01 lower bound and a date.lt=2021-01-01 upper bound:

curl "https://api.roic.ai/v3.0.0/stock-splits?apikey=YOUR_API_KEY&date.gte=2020-01-01&date.lt=2021-01-01"

Related endpoints