TrendSpider offers several types of esoteric market data that are not typically found in other trading platforms. In this documentation, we will understand three such market data:
- Earnings
- Dividends
- Splits
Let’s get started 🚀
Earnings
A company's earnings is its net income after deducting tax and is the single most important figure in the financial statements which is closely observed and analyzed by the stakeholders. This is a fairly complicated matter, and on TrendSpider, we use only a limited set of data points to calculate Earnings Per Share (EPS)
Add EPS on the Charts
Step 1: From the top toolbar, click on the vertical ellipsis (⋮) adjoining Other Data.
Step 2: Check the Earnings (US Stocks) from the dropdown list and the "Earnings" will be added to your indicator list on the chart.
You will find the EPS for the selected symbol at the bottom area of the chart (by default) as a label.
You can hover over any Earnings marking on the chart to reveal more in-depth information pertaining to the Earnings report, and what accounting method has been used to calculate the EPS.
For every symbol, the accounting method used to calculate the EPS for earnings is different (this is noted as the “Type” when hovering over the “Earning” label on the chart).
The reason why the method differs across all (most) of the tickers is that for every ticker, TrendSpider uses the method which makes the analyst expectations and reality more comparable to each other; as different analysts use different methods for their predictions.
Earnings data also supports "Earning Surprises" and hence, you can view the EPS surprise within the in-depth information dialogue. An earnings surprise takes place when a company's reported profits are above or below the expectations of the analysts.
Customize EPS Display Settings
Start customizing the EPS display settings by clicking on the vertical ellipsis (⋮) button adjoining Earnings from the indicator list on the chart.
You can customize the display settings for the following:
- Label Color: Change the color of the EPS label
- Format (Explained Below): Change the label display format to- Short, Standard (Default), and Full
- Label Align: Change the position of the label to- Bottom (Default) or Top of the chart
- Text Color: Change the text color of the label to your choice.
- Time Label: Enable or disable the EPS time stamp on the label.
- Line Enabled: Enable vertical dotted line to clearly trace the corresponding candle with EPS label.
- Line Color: Change the color of the vertical dotted line to your choice
There are 3 different formats in which you can display Earnings Label on the chart: Standard, Short, and Full as summarized in the table below:
| FORMAT | IMPLICATION |
|---|---|
| Standard | Selecting the “Format: Standard” will display the EPS on the label for the respective Quarter |
| Short | Selecting the “Format: Short” will only display the first initial of the EPS i.e. E but no information on the label. |
| Full | Selecting the “Format: Full” will display an S* mark on the labels: S+ for cases when the EPS surprise is positive, S- when it’s negative, and S= when it’s zero. |
Using Earnings in Scripting
While writing a new script or editing an existing one, you can use Earnings both "by date" and "by value" as a condition and use this script with different components of TrendSpider.
Components Supported: Market Scanner & Smart Checklist
Earnings (Dates)
Selecting Earnings (dates) as a condition from the dropdown list unlocks a way for you to perceive events like "The earnings report coming in 5 days" or "The earnings report exactly 5 days ago".
Earnings (Values)
Earnings "by value", gives you access to select the following data types while adding or editing a script:
- EPS: Earnings Per Share
- Surprise%: EPS Surprise percent, which is a difference between analysts' expectations for EPS and the actual EPS reported
- Change%: Difference between the reported EPS and the EPS which has been reported for the same quarter of a previous year.
NOTE ON OFFSETS: In scripting (i.e., scanning) Earnings Values work on a per-report basis (not a per-candle one). This means that "last" refers to the last report published, and "1 report ago" refers to the previous report, disregarding how long ago it had been published (in most cases it's 1 quarter).
NOTE ON "BY AT LEAST X%: "At least by X%" operator might behave counter-intuitive when one of your data points is zero. I.e., if your previous report's Surprise% was 0 and for the last report it's 1, then the Surprise% > Surprise% (1 report ago) at least by 10% script will be just as true as Surprise% > Surprise% (1 report ago) at least by 1000%, because of the purely mathematical reasons (as the result of 1/0 is not defined and limits to ∞).
Dividends
The dividend is the distribution of a company's earnings to its eligible shareholders, as determined by the company's board.
Add Dividends on the Charts
Step 1: From the top toolbar, click on the vertical ellipsis (⋮) adjoining Other Data.
Step 2: Check the Dividends (US Stocks) from the dropdown list and the "Dividends" will be added to your indicator list on the chart.
You will find the Dividend Per Share (DPS) for the selected symbol at the bottom area of the chart (by default) as a label.
You can hover over any Dividends marking on the chart to reveal more in-depth information pertaining to the Dividends report.
Customize Dividends Display Settings
Start customizing the Dividends display settings by clicking on the vertical ellipsis (⋮) button adjoining Dividends from the indicator list on the chart.
You can customize the display settings for the following:
- Declared: Check the Declared to plot the label with the Dividend declaration date marking.
- Recorded: Check the Recorded to plot the label with the Dividend Date of Record marking.
- Ex-Date: Check the Ex-Date to plot the label with the Ex-Dividend Date marking.
- Label Color: Change the color of the Dividends label
- Label Align: Change the position of the label to Bottom (Default) or Top of the chart
- Text Color: Change the text color of the label to your choice.
- Time Label: Enable or disable the Dividend time stamp (Declared/Recorded/Ex-Date) on the label.
- Line Enabled: Enable vertical dotted line to clearly trace the corresponding candle with DPS label.
- Line Color: Change the color of the vertical dotted line to your choice
There are 2 different formats in which you can display Earnings Label on the chart: Short and Full as summarized in the table below:
| Format | Implication |
|---|---|
| Short | Selecting the “Format: Short” will only display the first initial of the Dividends i.e. E but no information on the label. |
| Full | Selecting the “Format: Full” will display the DPS on the label |
Components Supported: Market Scanner & Smart Checklist
Using Dividends in Scripting
While writing a new script or editing an existing one, you can use Dividends both "by date" and "by value" as a condition and use this script with different components of TrendSpider.
Components Supported: Market Scanner & Smart Checklist
Dividends (Dates)
Selecting Dividends (dates) as a condition from the dropdown list unlocks a way for you to perceive events like "The dividends report with declaration date coming in 5 days" or "The Dividends report with ex-date exactly 5 days ago".
Dividends (Values)
Dividends "by value", give you access to select the following data types while adding or editing a script:
- Per-share $: The actual amount of cache distributed per one 1 common share
- Yield%: Annualized dividend yield as of the date of a report
NOTE ON YIELD: On TrendSpider, Yield% is always "as of the date of a report", which is different from "as of now". Here's an example of how it is calculated.
Annualized dividend: Current dividend multiplied by frequency (e.g in case of quarterly dividend, frequency is 4)
Previous day's closing price: Previous business day of the declaration date
Example: MSFT
- Announcement date: 2021-06-16
- Dividend: 0.56
- Frequency: 4
- Annualized dividend: 0.56 * 4 = 2.24
- Previous day: 2021-06-15
- Previous day's closing price: 258.36
Dividend yield (as of declaration date) = 2.24/258.36 = 0.00867007 = 0.86%.
Splits
Splits is an action when a company grows its outstanding shares to improve the liquidity and lower the trading price of its stock. The most commonly known splits are in the ratio of 2:1 or 3:1 which means that the shareholders will receive two or three shares for every share they have held earlier with themselves.
There are two types of splits: a forward split or a reverse split. TrendSpider allows you to display anytime an equity or asset is split, either forward or reverse, by adding the Splits on the chart from the Other Data toolbar menu.
Add Splits on the Charts
Step 1: From the top toolbar, click on the vertical ellipsis (⋮) adjoining Other Data.
Step 2: Check the Splits (US Stocks & ETFs) from the dropdown list and the "Splits" will be added to your indicator list on the chart.
You will find the Splits for the selected symbol at the bottom area of the chart (by default) as a label.
You can hover over any Splits marking on the chart to reveal more in-depth information pertaining to the Splits report.
Customize Splits Display Settings
Start customizing the Splits display settings by clicking on the vertical ellipsis (⋮) button adjoining Splits from the indicator list on the chart.
You can customize the display settings for the following:
- Declared: Check the Declared to plot the label with the Splits declaration date marking.
- Ex-Date: Check the Ex-Date to plot the label with the Ex-Split Date marking.
- Eff. Date: Check the Ex-Date to plot the label with the Split Effective Date marking.
- Label Color: Change the color of the Splits label
- Line Enabled: Enable vertical dotted line
- Line Color: Change the color of the vertical dotted line to your choice
- Time Label: Enable or disable the Splits time stamp (Declared/Ex-Date/Eff. Date) on the label.
- Label Align: Change the position of the label to the Bottom (Default) or Top of the chart
- Text Color: Change the text color of the label to your choice.
There are 2 different formats in which you can display Earnings Label on the chart: Short and Full as summarized in the table below:
| FORMAT | IMPLICATION |
|---|---|
| Short | Selecting the “Format: Short” will only display the first initial of the Splits i.e. E but no information on the label. |
| Full | Selecting the “Format: Full” will display the Splits ratio on the label. |
Using Splits in Scripting
While writing a new script or editing an existing one, you can use Splits as a condition and use this script with different components of TrendSpider.
Components Supported: Market Scanner & Smart Checklist
You can select Forward or Reverse as an event type from the dropdown list and perceive events like "The Forward Split report with declaration date coming in 5 days" or "The Reverse Split report with ex-date exactly 5 days ago".