Sign in

v1

latestOpenAPI 3.0.02026-07-266091181.5 KB
splits

Returns the splits calendar data

Returns stock split data including split ratios, announcement dates, ex-dates, and distribution dates. Stock splits occur when a company increases or decreases the number of outstanding shares to adjust the stock price. Includes information about whether the stock is optionable.

get/api/v2.1/calendar/splits

Query parameters

pageinteger

Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date

pagesizeinteger

Number of results returned. Limit 1000

parameters[date]string YYYY-MM-DD

Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest

parameters[date_from]string YYYY-MM-DD

Date to query from point in time

parameters[date_to]string YYYY-MM-DD

Date to query to point in time

parameters[date_search_field]'announced' | 'ex'

Date to filter and sort calendar by. Default is announced

parameters[importance]0 | 1 | 2 | 3 | 4 | 5

The importance level to filter by. Uses Greater Than or Equal To the importance indicated

parameters[tickers]string csv

One or more ticker symbols separated by a comma. Maximum 50 tickers

parameters[updated]integer

Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated

Headers

accept'application/json' required

Specifies return format. Query parameters work the same for both formats

Response

success

Example response

{
  "splits": [
    {
      "cusip": "88160R101",
      "date_announced": "2024-01-09",
      "date_distribution": "2024-02-15",
      "date_ex": "2024-02-14",
      "date_recorded": "2024-02-10",
      "exchange": "NASDAQ",
      "id": "60a7f5e8e4b0f5a3c8e9f5a8",
      "importance": 4,
      "name": "Tesla Inc.",
      "notes": "Forward stock split",
      "optionable": true,
      "ratio": "3-1",
      "split_type": "Split",
      "ticker": "TSLA",
      "updated": 1704819600
    }
  ]
}