What is reasoning?
Short, fact-checked explanations of why an asset moved.
An alert tells your user what happened. Reasoning tells them why.
Reasoning is included in the Advanced plan, and can be combined with personalization.
What a reasoning looks like
Each alert can carry up to 3 reasons, ordered from the most to the least relevant. Each reason has:
| Part | Example |
|---|---|
| Category | Earnings & Financials |
| Title | Reported revenue missed expectations |
| Body (one or two sentences) | Employers Holdings reported quarterly revenue of $202.6M, $15.3M below analyst estimates. |
| Emoji (optional) | 📉 |
| Relevancy score | 1 (strongest link) to 5 (weakest) |
The title and body are provided in each of your languages.
Categories
Every reason belongs to one of four categories:
- Earnings & Financials: results, guidance, analyst estimates
- Corporate Actions & Changes: contracts, M&A, management changes, product launches
- Market News & Events: sector news, peers, market-wide moves with a clear link to the asset
- Macroeconomic Indicators & Policy: rates, inflation, central banks, regulation, geopolitics
Relevancy score
Each reason is scored from 1 (clearly explains the move) to 5 (weak link). Reasons scored 4 or 5 are not delivered by default, so your users only see well-supported explanations.
What reasoning will not say
- No buy, sell or hold recommendation, and no price target.
- No invented facts or numbers.
- Stock splits and ex-dividend dates are never given as the reason for a move.
- Sector or macro news is used only when the link to the asset is explained.
- An analyst, report or competitor is always named, never "analysts say".
Not every alert has reasoning
When no reliable, recent explanation is found, the alert is sent without reasoning rather than with a weak or invented one. This is expected. See Why some alerts have no reasoning.