Combined trends tool that fetches trending words, stories, and documents in parallel.
This tool provides a unified view of all trending data - words with their documents
and stories - in a single response across all crypto projects.
## When to use vs `trending_stories_tool`
This is a superset of `trending_stories_tool`: same stories, plus trending
words, their context and AI-generated bull/bear summaries. It calls an LLM, so
it is slower and has a tighter per-tool rate-limit sub-cap than every other
tool. If only trending stories are needed, call `trending_stories_tool`
instead; set `include_words: false` / `include_stories: false` to drop a half
that is not needed. Do not call both tools for the same question.
## Parameters
- `time_period` - Time period for trending data (e.g., '1h', '6h', '1d', '7d'). Defaults to '1h' (last hour).
- `size` - Number of items per category to return (max 10). Defaults to 10.
Only the 2 most recent trend periods are returned, whatever
`time_period` is. A period is 1 hour for time_period up to 1d, 6 hours up to 7d,
and 1 day beyond that, so e.g. '2d' returns only the last 12 hours. When
older periods are dropped, `metadata.notice` says so and
`metadata.returned_since` gives the start of the oldest period returned.
- `include_stories` - Include trending stories in response. Defaults to true.
- `include_words` - Include trending words in response. Defaults to true.
## Response
- `trends` - Combined trending data containing stories and words.
- `metadata` - Request metadata including time period, size, and included data types.
- `errors` - Any non-fatal errors encountered during data fetching.
## Trending Data Structure
### Stories
- `title` - Title of the trending story.
- `summary` - Summary of the story.
- `score` - Trending score.
- `query` - Search query used to find the story.
- `related_tokens` - List of related crypto tokens (format: "BTC_bitcoin").
- `bullish_sentiment_ratio` - Bullish sentiment ratio.
- `bearish_sentiment_ratio` - Bearish sentiment ratio.
### Words
- `word` - The trending word.
- `score` - Trending score.
- `slug` - Associated project slug (if word is project-related).
- `summary` - AI-generated summary of discussions.
- `bullish_summary` - Summary of bullish sentiment.
- `bearish_summary` - Summary of bearish sentiment.
- `positive_sentiment_ratio` - Positive sentiment ratio.
- `negative_sentiment_ratio` - Negative sentiment ratio.
- `neutral_sentiment_ratio` - Neutral sentiment ratio.
- `positive_bb_sentiment_ratio` - Positive bull/bear sentiment ratio.
- `negative_bb_sentiment_ratio` - Negative bull/bear sentiment ratio.
- `neutral_bb_sentiment_ratio` - Neutral bull/bear sentiment ratio.
- `context` - Related words that appear with this trending word.
- `documents_summary` - AI-generated summary of related social media discussions.