Stock, ETF, and Mutual Funds Splits API Documentation

REST Endpoints

The new Corporate Action endpoints, such as the splits endpoints below, are currently available to Beta-enabled customers and enterprise customers as an early release product. If you would like access to the data below, please E-mail [email protected]

# Split data batch endpoint
https://api.tiingo.com/tiingo/corporate-actions/splits

# Split data endpoint for specific ticker
https://api.tiingo.com/tiingo/corporate-actions/<ticker>/splits

Just remember, you will need your token in order to connect. Keep it safe.

.

2.10 REST - Stock, ETF, and Mutual Fund Splits API

2.10.1 Overview

The Tiingo API Splits API endpoint provides detailed split data, for both historical and future split data. This endpoint remains newly exposed in beta and is included for all customers with the End-of-Day endpoint entitlement.

Splits are available for current and future dates, and data is updated as new corporate communications get processed. The tickers covered are the same found via the End-of-Day price data endpoints. This mean you can get past and future split data for stocks, ETFs, and mutual funds.

You can find out about the full product offering on the Product - Stock, ETF, & Mutual Fund Split API page.

2.10 REST - Stock, ETF, and Mutual Fund Split API

2.10.2 Batch Split Data

Use this endpoint to get past, present, and future splits. This endpoint will return detailed split data for a given stock, ETF, or Mutual Fund. You will also notice split status - this can either be active ("a") or cancelled ("c").

To request distribution data for a stock, use the following REST endpoints.
# Latest Split Data with an Ex-Date of the current day
https://api.tiingo.com/tiingo/corporate-actions/splits

# Latest Split Data with an ex-date explicitly specified (future date or historical date)
https://api.tiingo.com/tiingo/corporate-actions/splits?exDate=2023-08-25

Field Name
JSON Field
Data Type
Description
PermaTicker
permaTicker
string
The Tiingo permaticker.
Ticker
ticker
string
Ticker related to the asset.
Ex-Date
exDate
datetime
The ex-Date of the split. In the Tiingo EOD Endpoints, this is the date where "splitFactor" will not be 1.0. This is also the date used for split adjustments.
Split From
splitFrom
float
The prior split ratio.
Split To
splitTo
float
The new split ratio, i.e. how many shares of "splitTo" are given for each share of "splitFrom".
Split Factor
splitFactor
float
The ratio of splitTo from splitFrom. In other words:
splitFactor = splitTo/splitFrom
This ratio is helpful in calculating split price adjustments.
Split Status
splitStatus
string
A code representing the status of split
  • a: Active
  • c: Cancelled
2.10 REST - Stock, ETF, and Mutual Fund Split API

2.10.3 Ticker-specific Split Data

This endpoint is similar to the batch endpoint, but allows you to specify a specific ticker to limit the query and also provide historical split timeseries data for a ticker as well. Stocks, ETFs, and Mutual Funds are supported.

To request distribution data for a stock, use the following REST endpoints.
# Latest Split Data with an Ex-Date of the current day
https://api.tiingo.com/tiingo/corporate-actions/cvs/splits

# Latest Split Data with an ex-date explicitly specified (future date or historical date)
https://api.tiingo.com/tiingo/corporate-actions/cvs/splits?startExDate=2002-08-25
Field Name
JSON Field
Data Type
Description
PermaTicker
permaTicker
string
The Tiingo permaticker.
Ticker
ticker
string
Ticker related to the asset.
Ex-Date
exDate
datetime
The ex-Date of the split. In the Tiingo EOD Endpoints, this is the date where "splitFactor" will not be 1.0. This is also the date used for split adjustments.
Split From
splitFrom
float
The prior split ratio.
Split To
splitTo
float
The new split ratio, i.e. how many shares of "splitTo" are given for each share of "splitFrom".
Split Factor
splitFactor
float
The ratio of splitTo from splitFrom. In other words:
splitFactor = splitTo/splitFrom
This ratio is helpful in calculating split price adjustments.
Split Status
splitStatus
string
A code representing the status of split
  • a: Active
  • c: Cancelled