5.7 - Data Dictionnary¶
Indicators Description¶
Sentiment Score: A measure of the bullishness / bearishness of the language used in media coverage of a given stock on a given day. Each English-language article about the stock gets an integer score from 1 (most negative) to 10 (most positive). The daily score is the mean of that day's article scores, so it lies between 1 and 10 and may carry decimals; a score of 0 indicates an absence of articles for that day.
An article's score combines up to four readings of its language, each multiplied by its weight and then averaged over the readings found: the title and the opening of the article weigh 3 each, the sentences that name the company and the whole text 1 each. The result is rounded to a whole number from 1 to 10.
Sentiment High: The highest value the day's mean score reached during the day. The mean is recomputed after each of the day's articles, as they come in, and Sentiment High is the largest of those running means. It is not a reading taken at fixed intervals, nor the highest article score, nor the mean plus a standard deviation. The last running mean is the day's score, so Sentiment Low ≤ Sentiment Score ≤ Sentiment High. A day without articles is 0.
Sentiment Low: The lowest of the day's running means, as above. It is not the lowest article score. A day without articles is 0.
For an index, Sentiment High and Low are the averages of its constituents' highs and lows on the day. Two jobs have written the index series: one takes those averages; the other (update_eod_index) takes the mean of the constituents' whole-number daily scores plus and minus one standard deviation. An index day does not say which job wrote it.
News Volume: The number of news articles about this stock published on a given day, in the series' time zone, counting the articles the note below describes; a day without articles is 0.
News Buzz: Whether coverage of the stock jumped on a given day, computed from the daily volumes. Two formulas exist, and each day carries the one that computed it. With the current one, buzz is 0 on an ordinary day and between 1 and 10 when coverage jumps: it takes the standard deviation of the last 7 days' volumes, the day included, and how much it rose from the day before. Buzz is above 0 only when that rise is at least 1 article and the day's volume is at least the 7-day average, the day included; it is then scaled from 1 (a rise of 1 article) to 10 (the largest rise of the last 31 days, the day included), with three decimals. With the original one, buzz is the day's volume as a share of the largest daily volume of the last 7 days, the day included, from 0 to 10; part of the weekend's articles is added to the Saturday, Sunday and Monday volumes it compares. It is not 0 on an ordinary day.
Additional Indicators¶
Advanced indicators can be made accessible on demand. Please email [email protected] for more information.
Note (#291, checked against the API on 2026-11-13)¶
Which articles a score counts. Each article carries a relevance to the entity, from 0 to 100. The daily sentiment, high, low, volume and buzz served by the API count the articles of relevance 50 or more; the one exception is the company daily series in the Europe/Berlin zone, which counts every article. Articles themselves are served from relevance 50, and from relevance 100 for indices.
Sentiment score, volume and buzz above describe a company's daily series. For an index, the daily volume is the sum of its constituents' volumes and the daily buzz is the average of its constituents' buzz.
Each daily value may also carry formula_version, the formula that computed it. A value without one was computed by the original formula, v1. This page describes v1, the formula of every value served today; what a later version changes is listed in the formula changelog.