1. General
1.1 Overview
1.2 Connecting
1.3 Changelog
2. REST
2.1 End-of-Day
2.2 News
2.3 Crypto
2.4 Forex
2.5 IEX
2.6 Fundamentals
2.7 Fund Fees
2.8 Dividends
2.9 Splits
3. Websockets
3.1 Crypto
3.2 Forex
3.3 IEX
4. Utilities
4.1 Search
5. Appendix
5.1 Developer Program
5.2 Integrations
5.3 Symbology
Home
Documentation
Products
About
Pricing

Stock, ETF, and Mutual Funds Dividend API Documentation

REST Endpoints

The new Corporate Action endpoints, such as the distribution 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]

# Distribution data batch endpoint
https://api.tiingo.com/tiingo/corporate-actions/distributions

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

# Historical timeseries of distribution (dividend) yield
https://api.tiingo.com/tiingo/corporate-actions/<ticker>/distribution-yield

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

.

2.8 REST - Stock, ETF, and Mutual Fund Dividends API

2.8.1 Overview

The Tiingo API Dividends API endpoint help capture and relay both detailed dividend and distribution data, as well as historical metrics that relate to dividends, such as yield. As of August 28th, 2023, this endpoint remains newly exposed in beta and is included for all customers with the End-of-Day endpoint entitlement. This dividend distribution API endpoints fall under our new corporate action endpoints coming soon.

Diviends are available for current and future dates, and yield is available for tickers after their End-of-Day price data have been processed.

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

2.8 REST - Stock, ETF, and Mutual Fund Dividends API

2.8.2 Batch Distribution Data

Use this endpoint to get past, present, and future dividends and distributions. This endpoint will return detailed dividend and distribution data for a given stock, ETF, or Mutual Fund. You will also notice a distribution frequency, this is the declared frequency of the distribution that you can use to customize your calculations to determine yield.

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

# Latest Distribution Data with an ex-date explicitly specified (future date or historical date)
https://api.tiingo.com/tiingo/corporate-actions/distributions?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 distribution. In the Tiingo EOD Endpoints, this is the date where "divCash" will be non-zero. This is also the date used for dividend price adjustments.
Payment Date
paymentDate
datetime
The payment date of the distribution.
Record Date
recordDate
datetime
The record date of the distribution.
Declaration Date
declarationDate
datetime
The declaration date of the distribution.
Distribution
distribution
float
The total distribution for the given date.
Distribution Frequency
distributionFreqency
string
The frequency that's associated with this distribution. For example "q" means quarterly, meaning this is a declared quarterly distribution. The full list of codes is available here:
  • w: Weekly
  • bm: Bimonthly
  • m: Monthly
  • tm: Trimesterly
  • q: Quarterly
  • sa: Semiannually
  • a: Annually
  • ir: Irregular
  • f: Final
  • u: Unspecified
  • c: Cancelled
2.8 REST - Stock, ETF, and Mutual Fund Dividends API

2.8.3 Ticker-specific Distribution 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 distribution 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.
# Distribution data endpoint for specific ticker (Full history)
https://api.tiingo.com/tiingo/corporate-actions/<ticker>/distributions

# Distribution data for a ticker limited to a provided date range
https://api.tiingo.com/tiingo/corporate-actions/<ticker>/distributions?startExDate=2023-01-01&endExDate=2024-01-01
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 distribution. In the Tiingo EOD Endpoints, this is the date where "divCash" will be non-zero. This is also the date used for dividend price adjustments.
Payment Date
paymentDate
datetime
The payment date of the distribution.
Record Date
recordDate
datetime
The record date of the distribution.
Declaration Date
declarationDate
datetime
The declaration date of the distribution.
Distribution
distribution
float
The total distribution for the given date.
Distribution Frequency
distributionFreqency
string
The frequency that's associated with this distribution. For example "q" means quarterly, meaning this is a declared quarterly distribution. The full list of codes is available here:
  • w: Weekly
  • bm: Bimonthly
  • m: Monthly
  • tm: Trimesterly
  • q: Quarterly
  • sa: Semiannually
  • a: Annually
  • ir: Irregular
  • f: Final
  • u: Unspecified
  • c: Cancelled
2.8 REST - Stock, ETF, and Mutual Fund Dividends API

2.8.4 Historical Yield Endpoint

Use this endpoint to obtain the current and historical information about yield data for the given Stock, ETF, or Mutual Fund. Please note that we will continue to add new daily metrics, so the fields will change throughout time. We recommend you do not make parsing code that requires columns or fields to be in a particular order. If you do require this, please use the columns request parameter to ensure constant output, even if we add columns. For example, columns=trailingDiv1Y will always ensure only that single field is returned in that exact order.

To request historical distribution yield data for a stock, use the following REST endpoint.
# Distribution yield
https://api.tiingo.com/tiingo/corporate-actions/<ticker>/distribution-yield
Field Name
JSON Field
Data Type
Description
Date
date
datetime
Date associated with the yield.
Trailing 1 Year Dividend
trailingDiv1Y
string
The trailing distribution yield for the asset based on the previous 1 year of distributions.
2.8 REST - Stock, ETF, and Mutual Fund Dividends API

2.8.5 Additional Information & FAQ

This endpoint is used to communicate past, present, and future distribtion data.

How often does this data update?

Data is updated throughout 2-3 times a day as distribution announcements come in.

Will more types of yield be added?

Yes, future expansions of various yield calculations will be included in future dates - including forward yield. You may also calculate this yourself using our distribution frequency endpoints.

How come some dates are null?

We have different enterprise relationships with various provides who provide various data feeds. We then error check them using a proprietary framework to check for errors. If a date is null, it generally means this data is not available to us. Ex-date and distribution amounts will never be null however.