Crypto sentiment API for traders and fintech apps. Track Reddit buzz scores, mentions, bullish % and trend direction for BTC, ETH, SOL and other major symbols.
| # | Symbol | Asset | Buzz | Mentions | Bullish | Trend |
|---|---|---|---|---|---|---|
| Loading trending crypto... | ||||||
The Trending API allows developers and traders to retrieve all trending crypto coins with sentiment and momentum metrics.
Market-moving discussions happen across multiple crypto communities at once. Symbols rotate fast, sentiment whipsaws quickly and manual monitoring misses early momentum.
Signals are spread across many subreddits and threads. One feed never tells the full story.
Memes, reposts and hype cycles can hide real conviction if you only count raw mentions.
You need one comparable score to rank BTC vs ETH vs SOL across different discussion volumes.
Discover trending symbols, inspect one token in depth, compare multiple assets and monitor the market-wide crypto mood. RESTful JSON endpoints designed for trading bots, dashboards and research workflows.
Data refreshes hourly. Today shows activity so far, while trend compares the current 3 UTC days with the previous 3 UTC days.
Buzz, sentiment, mentions, upvotes and subreddit spread are normalized into one comparable signal.
Built for large symbol coverage so you can track majors, mid-caps and faster-moving altcoins in one API.
Access real-time crypto sentiment analytics from Reddit for trading systems, portfolio dashboards and market intelligence products.
Fill out the form below. We'll send you a secure link to retrieve your API key.
We've sent a link to retrieve your API key. The link expires in 24 hours and can only be used once.
RESTful JSON API. Protected endpoints require X-API-Key. View full Reddit Crypto docs → · BuzzScore Whitepaper →
https://api.adanos.org/reddit/crypto
X-API-Key: sk_live_...
/v1/trending
Returns ranked crypto symbols by Reddit mention activity and sentiment for the selected period.
from | Inclusive UTC start date (YYYY-MM-DD) |
to | Inclusive UTC end date (YYYY-MM-DD). If no date window is provided, the API uses the default 7-day lookback. Earliest start date by plan, counted back from the current UTC date: Free 30 days, Hobby 90 days, Professional 365 days |
limit | Maximum results (1-100, default: 20) |
offset | Skip first N results for pagination (default: 0) |
[
{
"symbol": "BTC",
"name": "Bitcoin",
"buzz_score": 94.2,
"trend": "rising",
"trend_history": [79.1, 81.4, 85.6, 88.2, 90.1, 92.7, 94.2],
"mentions": 3847,
"unique_posts": 712,
"subreddit_count": 24,
"sentiment_score": 0.31,
"bullish_pct": 58,
"bearish_pct": 18,
"total_upvotes": 15620
}
]symbol | Crypto symbol |
name | Token name (nullable) |
buzz_score | Buzz score (0-100) |
trend | Token activity trend for current 3 UTC days vs previous 3 UTC days |
trend_history | Daily buzz history (oldest to newest) |
mentions | Explicit mention count |
unique_posts | Distinct Reddit posts |
subreddit_count | Distinct subreddit count |
sentiment_score | Average sentiment (-1 to +1) |
bullish_pct | Bullish mention percentage |
bearish_pct | Bearish mention percentage |
total_upvotes | Total upvotes from explicit mentions |
/v1/token/{symbol}
Returns detailed sentiment, buzz score, daily trend data and enriched top subreddit metrics for a single crypto symbol.
symbol | Crypto symbol (e.g., BTC, $ETH, SOL) |
from | Inclusive UTC start date (YYYY-MM-DD) |
to | Inclusive UTC end date (YYYY-MM-DD). If no date window is provided, the API uses the default 7-day lookback. Earliest start date by plan, counted back from the current UTC date: Free 30 days, Hobby 90 days, Professional 365 days |
{
"symbol": "ETH",
"name": "Ethereum",
"found": true,
"buzz_score": 87.5,
"trend": "rising",
"mentions": 2156,
"sentiment_score": 0.24,
"bullish_pct": 54,
"bearish_pct": 20,
"positive_count": 991,
"negative_count": 412,
"neutral_count": 753,
"total_upvotes": 11290,
"unique_posts": 438,
"subreddit_count": 21,
"period_days": 7,
"top_subreddits": [
{ "subreddit": "cryptocurrency", "mentions": 431, "sentiment_score": 0.29, "buzz_score": 72.5 },
{ "subreddit": "ethtrader", "mentions": 212, "sentiment_score": 0.21, "buzz_score": 64.2 }
],
"daily_trend": [
{ "date": "2026-02-24", "mentions": 328, "sentiment_score": 0.18, "buzz_score": 83.1 },
{ "date": "2026-02-25", "mentions": 351, "sentiment_score": 0.27, "buzz_score": 87.5 }
],
"top_mentions": [
{
"text_snippet": "ETH momentum looks strong this week...",
"sentiment_score": 0.64,
"sentiment_label": "positive",
"upvotes": 1200,
"subreddit": "cryptocurrency",
"created_utc": "2026-02-25T10:30:00Z"
}
]
}symbol | Crypto symbol |
name | Token name (nullable) |
found | Whether mentions were found |
buzz_score | Buzz score (0-100) |
mentions | Explicit mentions in selected period |
sentiment_score | Average sentiment |
positive_count | Positive mention count |
negative_count | Negative mention count |
neutral_count | Neutral mention count |
daily_trend | Daily mentions, sentiment_score and buzz datapoints |
top_subreddits | Top subreddit contributors with mentions, sentiment and buzz score |
top_subreddits[].subreddit | Subreddit name (e.g., "cryptocurrency") |
top_subreddits[].mentions | Canonical mention count for this subreddit |
top_subreddits[].sentiment_score | Subreddit-level average sentiment (-1 to +1) |
top_subreddits[].buzz_score | Subreddit-level buzz score (0-100) |
top_mentions | Top mentions ordered by engagement |
404 | No mentions found for symbol in the selected period |
401 | Missing or invalid API key |
/v1/compare
Compares up to 10 crypto symbols over the selected period using unified Reddit sentiment metrics.
symbols | Comma-separated symbol list (max 10, required), e.g. BTC,ETH,SOL |
from | Inclusive UTC start date (YYYY-MM-DD) |
to | Inclusive UTC end date (YYYY-MM-DD). If no date window is provided, the API uses the default 7-day lookback. Earliest start date by plan, counted back from the current UTC date: Free 30 days, Hobby 90 days, Professional 365 days |
{
"period_days": 7,
"tokens": [
{
"symbol": "BTC",
"name": "Bitcoin",
"buzz_score": 94.2,
"trend": "rising",
"mentions": 423,
"unique_posts": 97,
"subreddit_count": 12,
"sentiment_score": 0.31,
"bullish_pct": 47,
"bearish_pct": 18,
"total_upvotes": 15620
},
{
"symbol": "ETH",
"name": "Ethereum",
"buzz_score": 72.4,
"trend": "stable",
"mentions": 318,
"unique_posts": 73,
"subreddit_count": 9,
"sentiment_score": 0.27,
"bullish_pct": 43,
"bearish_pct": 19,
"total_upvotes": 10422
}
]
}period_days | Selected analysis window |
tokens | Array of token sentiment objects |
tokens[].symbol | Crypto symbol |
tokens[].name | Token name |
tokens[].buzz_score | Buzz score in the selected period |
tokens[].trend | Token activity trend for current 3 UTC days vs previous 3 UTC days |
tokens[].mentions | Mentions in selected period |
tokens[].unique_posts | Unique posts in the selected period |
tokens[].subreddit_count | Subreddit coverage in the selected period |
tokens[].sentiment_score | Average sentiment (-1 to +1) |
tokens[].total_upvotes | Total upvotes across matched mentions |
400 | Invalid symbols request (e.g., empty list or more than 10 symbols) |
401 | Missing or invalid API key |
/v1/search
Searches known crypto symbols and returns matching assets. Search accepts only q and limit; summary metrics use a fixed last 7 UTC calendar days window.
q | Search query (required, min 1 character) |
limit | Maximum result count (1-200, default: 50) |
{
"query": "solana",
"count": 1,
"period_days": 7,
"results": [
{
"symbol": "SOL",
"name": "Solana",
"market_cap_rank": 6,
"market_cap_usd": 71234567890.12,
"aliases": ["Sol"],
"summary": {
"mentions": 287,
"buzz_score": 72.4,
"trend": "stable",
"sentiment_score": 0.27
}
}
]
}query | Original query string |
count | Number of matching results |
period_days | Fixed 7 UTC calendar-day lookback used for each summary block |
results[].symbol | Crypto symbol |
results[].name | Token name |
results[].market_cap_rank | Market cap rank (nullable) |
results[].market_cap_usd | Market cap in USD (nullable) |
results[].aliases | Known aliases (nullable) |
results[].summary | Compact Reddit discovery summary for the fixed last 7 UTC calendar days |
results[].summary.mentions | Attributed mentions in the last 7 UTC calendar days |
results[].summary.buzz_score | Buzz score over the last 7 UTC calendar days |
results[].summary.trend | Activity trend over current 3 UTC days vs previous 3 UTC days; not a price trend |
results[].summary.sentiment_score | Average sentiment over the last 7 UTC calendar days |
/v1/market-sentiment
Returns a market-wide Reddit crypto snapshot with total discussion volume, sentiment balance and the symbols currently driving narrative momentum.
from | Inclusive UTC start date (YYYY-MM-DD) |
to | Inclusive UTC end date (YYYY-MM-DD). If no date window is provided, the API uses the default 7-day lookback. Earliest start date by plan, counted back from the current UTC date: Free 30 days, Hobby 90 days, Professional 365 days |
{
"buzz_score": 69.8,
"trend": "rising",
"mentions": 23140,
"unique_posts": 3821,
"subreddit_count": 29,
"total_upvotes": 195204,
"active_tickers": 188,
"sentiment_score": 0.22,
"positive_count": 10982,
"negative_count": 3745,
"neutral_count": 8413,
"bullish_pct": 47,
"bearish_pct": 16,
"trend_history": [58.9, 60.3, 62.7, 64.8, 66.1, 68.2, 69.8],
"drivers": [
{ "symbol": "BTC", "mentions": 3847, "buzz_score": 94.2, "sentiment_score": 0.31 },
{ "symbol": "ETH", "mentions": 2156, "buzz_score": 87.5, "sentiment_score": 0.24 }
]
}buzz_score | Relative crypto-market heat vs. the trailing 90-day Reddit crypto baseline (~50 is normal) |
trend | Service-level Reddit crypto activity trend for current 3 UTC days vs previous 3 UTC days |
mentions | Total Reddit crypto mentions across the selected window |
unique_posts | Number of distinct Reddit posts represented in the aggregate snapshot |
subreddit_count | Number of subreddits contributing to the aggregate snapshot |
total_upvotes | Total upvotes across all matched mentions |
active_tickers | Number of active symbols in the selected window |
sentiment_score | Average sentiment across all matched mentions (-1 to +1) |
positive_count | Number of bullish mentions in the aggregate window |
negative_count | Number of bearish mentions in the aggregate window |
neutral_count | Number of neutral mentions in the aggregate window |
bullish_pct | Percentage of bullish mentions across the whole Reddit crypto universe |
bearish_pct | Percentage of bearish mentions across the whole Reddit crypto universe |
trend_history | Daily aggregate buzz-score history (oldest to newest) |
drivers | Top symbols currently driving the broader Reddit crypto mood |
/v1/token/{symbol}/mentions
Pro
Returns raw Reddit mention rows for one crypto symbol within the live raw-data retention window. from/to date windows are interpreted as inclusive UTC calendar dates. Use it when you need post/comment-level snippets, original timestamps and inherited-context filtering.
from | Inclusive UTC start date (YYYY-MM-DD) |
to | Inclusive UTC end date (YYYY-MM-DD). If no date window is provided, the API uses the default 7-day lookback. Professional-only raw endpoint; earliest start date, counted back from the current UTC date: 365 days |
limit | Maximum raw rows to return (1-100, default: 50) |
include_inherited | Include inherited thread-context mentions in addition to direct symbol matches (default: false) |
{
"symbol": "BTC",
"period_days": 7,
"count": 1,
"results": [
{
"post_id": "abc123",
"comment_id": "def456",
"subreddit": "cryptocurrency",
"author": "user123",
"text_snippet": "BTC still looks strong above this range...",
"created_utc": "2026-03-20T18:42:10Z",
"upvotes": 381,
"sentiment_score": 0.62,
"sentiment_label": "positive",
"is_inherited": false
}
]
}symbol | Resolved crypto symbol |
period_days | Applied raw mention lookback window |
count | Total matching raw mention rows before the limit cut |
results | Newest-first raw mention rows for the symbol |
results[].post_id | Reddit post id |
results[].comment_id | Reddit comment id when the row comes from a comment |
results[].subreddit | Source subreddit |
results[].author | Public Reddit author name, when available |
results[].text_snippet | Short text extract from the raw mention row |
results[].created_utc | Original UTC timestamp for the post/comment row |
results[].upvotes | Upvote count captured on the raw row |
results[].sentiment_score | Sentiment score for that raw row (-1 to +1) |
results[].sentiment_label | Sentiment class for that raw row |
results[].is_inherited | Whether the row was inherited from thread context instead of a direct symbol mention |
401 | Missing or invalid API key |
403 | Professional plan required for raw mention access |
422 | Invalid symbol or query parameter |
All plans share the same base API. Professional adds raw mention data and commercial rights.
Perfect for quick tests, API exploration and early prototypes. No credit card required.
For professional traders, personal trading bots, academic research & side projects
For hedge funds, fintech startups, trading platforms & commercial applications
Enterprise: Get in touch for API access, higher rate limits or custom data feeds. We work with quant teams, fintech startups and research groups across stock and crypto sentiment. Contact us → Non-profit or education use? Apply for free access →
Everything you need to know about the Reddit Crypto Sentiment API.
The dataset aggregates activity from major crypto-focused Reddit communities and symbol-specific threads, including for example r/CryptoCurrency, r/Bitcoin and r/ethtrader.
Symbol extraction normalizes variants such as ETH and $ETH, then maps mentions to the token reference set used by the search endpoint.
Buzz score combines mention volume, sentiment balance, engagement, source diversity and recent momentum into a normalized 0-100 value for cross-symbol ranking.
rising, falling and stable are derived from normalized Reddit activity in the current 3 UTC days vs the previous 3 UTC days. This helps identify whether discussion around a symbol is accelerating or cooling off; it is not a price trend.
The Reddit Crypto pipeline refreshes every 60 minutes. New posts and comments are ingested in each cycle, then mentions, sentiment aggregates and trend metrics are recalculated so the trending list reflects the latest market discussion as closely as possible.
The free tier includes 250 requests/month, 100 requests/minute, access to the full base endpoint surface including the market-wide sentiment snapshot and 30 days of history. Raw mention endpoints are Professional-only. Hobby increases that to 1000 requests/minute, 250,000 monthly requests and 90 days of history. Professional increases that to 2,500,000 monthly requests and extends historical access to up to 365 days.
All responses are JSON (UTF-8). The /v1/token/{symbol} endpoint includes rich per-symbol fields like daily_trend, enriched top_subreddits, top_mentions and sentiment distribution counts. For a market-wide view, /v1/market-sentiment returns aggregate crypto buzz, breadth and the symbols driving the current Reddit narrative. Professional accounts can also call /v1/token/{symbol}/mentions for raw post/comment rows with count and results.
Yes. /v1/compare accepts comma-separated symbols and returns unified token sentiment objects for side-by-side analysis (up to 10 symbols).
Use this data as one signal among many. Social sentiment can be noisy and regime-dependent. Combine it with risk controls, market structure and your own research before making trades.
Need a higher-volume or custom data setup? Contact us and we will help map the right access model.