Trending Stories

Trending Stories surfaces the top narratives being discussed in social data over a given time range.

For each story the metric returns:

• title — short human-readable headline
• summary — a paragraph describing what the story is about, including explicit bullish and bearish takes
• searchText — an OR-joined search query (e.g. solana OR chainlink OR tether) that can be used to pull the underlying social posts
• score — trending score, used to rank stories in descending order
• bullishRatio / bearishRatio — bullish/bearish sentiment ratios computed over the posts related to the story
• relatedTokens — list of tokens in SYMBOL_slug form (e.g. BTC_bitcoin)

The metric’s real-time data is free. The metric’s historical data has restricted access.

The score reflects how much social attention a story is getting. It has no absolute qualitative meaning — the higher the score, the more a given story is trending relative to the rest.

bullishRatio and bearishRatio are floats in the [0, 1] range describing the bullish/bearish sentiment split of the social posts related to the story.

Timeseries Data

Trending Stories are available at hourly intervals

Trending Stories have social data Latency

Trending Stories can be computed per data source via the source argument:

• TWITTER_CRYPTO
• TELEGRAM

Trending Stories are available on the Trending Stories page.

Trending stories are available as part of the API, the metric is called getTrendingStories:

1
{
2
  getTrendingStories(
3
    from: "2026-01-01T12:00:00Z"
4
    to: "2026-01-01T13:00:00Z"
5
    size: 10
6
    interval: "1h"
7
    source: TWITTER_CRYPTO
8
  ) {
9
    datetime
10
    topStories {
11
      title
12
      summary
13
      searchText
14
      score
15
      bullishRatio
16
      bearishRatio
17
      relatedTokens
18
    }
19
  }
20
}