Sign in
latestSwagger 2.02026-08-12187723.0 MB

c4a12725cdb5

fundamentals

Splits calendar

The splits calendar endpoint provides a detailed calendar of stock split events within a specified date range. By setting the start_date and end_date parameters, users can retrieve a list of upcoming or past stock splits, including the company name, split ratio, and effective date. This endpoint is useful for tracking changes in stock structure and planning investment strategies around these events.

get/splits_calendar

Query parameters

symbolstring

Symbol ticker of instrument. For preferred stocks use dot(.) delimiter. E.g. BRK.A or BRK.B will be correct

figistring

Filter by financial instrument global identifier (FIGI). This parameter is available on the <a href="https://twelvedata.com/pricing">Ultra</a> plan (individual) and the <a href="https://twelvedata.com/pricing-business">Enterprise</a> plan (business) and above.

isinstring

Filter by international securities identification number (ISIN). ISIN access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

cusipstring

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

exchangestring

Exchange where instrument is traded

mic_codestring

Market Identifier Code (MIC) under ISO 10383 standard

countrystring

Country where instrument is traded, e.g., United States or US

start_datestring

The starting date (inclusive) for filtering split events in the calendar. Format 2006-01-02

end_datestring

The ending date (inclusive) for filtering split events in the calendar. Format 2006-01-02

outputsizeinteger

Number of data points to retrieve. Supports values in the range from 1 to 500. Default 100 when no date parameters are set, otherwise set to maximum

pagestring

Page number

Response

datestring required

Stands for the split date

symbolstring

Ticker of the company

mic_codestring

Market Identifier Code (MIC) under ISO 10383 standard

exchangestring

Exchange name where the company is listed

descriptionstring required

Specification of the split event

rationumber double required

The ratio by which the number of a company's outstanding shares of stock are increased following a stock split. For example, a 4-for-1 split results in four times as many outstanding shares, with each share selling at one forth of its pre-split price

from_factornumber double required

From factor of the split

to_factornumber double required

To factor of the split

Example response

[
  {
    "date": "1987-06-16",
    "symbol": "AAPL",
    "mic_code": "XNGS",
    "exchange": "NASDAQ",
    "description": "2-for-1 split",
    "ratio": 0.5,
    "from_factor": 2,
    "to_factor": 1
  }
]