Compare stocks
Compare up to 10 stocks side by side using X/Twitter metrics over the same UTC calendar-day period.
Use it when you already know the tickers and want a compact ranked table instead of full detail reports. Results are sorted by buzz_score descending and include trend, trend_history, mentions, unique_tweets, sentiment_score, bullish_pct, bearish_pct and total_upvotes. trend is activity momentum over the current 3 UTC days vs previous 3 UTC days using mentions, likes and author breadth; not price movement or Grok rank movement. For from/to, anchors at to (or now when to is today).
Query parameters
Start date in YYYY-MM-DD. Inclusive UTC date.
Start date in YYYY-MM-DD. Inclusive UTC date.
End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.
End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.
Deprecated v1 compatibility shorthand. Prefer from and to for reproducible UTC date windows.
Deprecated v1 compatibility shorthand. Prefer from and to for reproducible UTC date windows.
Comma-separated list of ticker symbols (e.g., TSLA,NVDA,AMD)
Comma-separated list of ticker symbols (e.g., TSLA,NVDA,AMD)
Response
Successful Response
Example response
{
"period_days": 7,
"stocks": [
{
"ticker": "TSLA",
"company_name": "Tesla, Inc.",
"buzz_score": 72.5,
"trend": "rising",
"mentions": 156,
"unique_tweets": 42,
"sentiment_score": 0.35,
"bullish_pct": 45,
"bearish_pct": 12,
"total_upvotes": 2847,
"trend_history": [
45.2,
48.1,
52.3,
55,
58.2,
61.5,
72.5
]
}
]
}