Upcoming stock splits

GET/api/company/upcoming-stock-splits

Declared stock splits executing in the next N days (default 7, max 28), sorted by split date ascending. Covers common stocks with an active listing; fund and ETF splits are not included. Each entry is one declared split event with the execution date, the conversion ratio, and the direction.

This is the forward-looking complement to the two historical split endpoints: /api/company/stock-splits and /api/company/recent-stock-splits are sourced from XBRL filing disclosures and lag the event by weeks to months, while this calendar lists splits the company has announced but not yet executed. ratio uses the same semantics in all three, so the feeds join cleanly.

Get API key Try it live in the API explorer

Query parameters

days integer optional min 1 · max 28 · default 7

Look-ahead window in days on the split execution date (max 28).

Example: 7
page integer optional min 1 · default 1

Page number (1-indexed).

Example: 1
pageSize integer optional min 1 · max 500 · default 50

Results per page.

Example: 50

Example request

curl 'https://api.stockfit.io/v1/api/company/upcoming-stock-splits?days=7&page=1&pageSize=50' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Paginated list of upcoming split events.

Response schema

page integer
Current page number (1-indexed).
pageSize integer
Number of results per page.
totalPages integer
Total number of pages.
totalResults integer
Total split events in the window.
data array of object
array of:
- symbols array of string
  All active tickers for the entity, primary first. A multi-class issuer is a single entry with all classes.
- name string
  Issuer name (SEC conformed form).
- splitDate string
  Split execution date (YYYY-MM-DD). Shares trade on the new basis from this date.
- ratio number | null
  The conversion ratio, same semantics as the historical split endpoints. `> 1` for forward splits (e.g. `10` = 10-for-1), `< 1` for reverse splits (e.g. `0.05` = 1-for-20). Compute the post-split share count as `preSplit x ratio`. Null when the declared ratio text could not be parsed numerically; see `ratioText`.
- ratioText string | null
  The ratio exactly as declared in the calendar (e.g. `"10 : 1"`). Present even when `ratio` is null.
- type string (enum) | null
  Split direction derived from `ratio`. Null when `ratio` is null.
  Allowed values: forward, reverse

Example response

{
  "page": 1,
  "pageSize": 50,
  "totalPages": 1,
  "totalResults": 12,
  "data": [
    {
      "symbols": [
        "NVDA"
      ],
      "name": "NVIDIA CORP",
      "splitDate": "2026-08-20",
      "ratio": 10,
      "ratioText": "10 : 1",
      "type": "forward"
    }
  ]
}

400 Bad Request

Invalid parameters

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}