ADadanos
X/Twitter Stocks

Trending stocks

Changed on

Returns the stocks with the strongest X/Twitter discussion activity in the selected period, ranked by buzz_score.

Includes:

  • buzz_score: normalized 0-100 activity score used for ranking
  • trend: activity momentum over the current 3 UTC days vs previous 3 UTC days using mentions, likes and author breadth; not price movement. For from/to, anchors at to (or now when to is today)
  • sentiment_score, bullish_pct, bearish_pct: directional sentiment signals
  • mentions, unique_tweets, total_upvotes: volume and engagement signals
  • trend_history: independent UTC-day buzz scores, oldest to newest; minimum 7 values; the live final value describes today so far and can differ from the selected-period buzz_score; missing days are 0.0
get/x/stocks/v1/trending

Request

  • Base URL
    https://api.adanos.com
  • Auth
    API key in header X-API-Key

Query parameters

fromstring date nullable

Start date in YYYY-MM-DD. Inclusive UTC date.

tostring date nullable

End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.

limitinteger

Maximum stocks to return

Example:20
offsetinteger

Number of items to skip for pagination

type'stock' | 'etf' | 'all' nullable

Filter by asset type. Omit or use 'all' for all assets.

Example:stock

Response

Successful Response

tickerstring required

Stock ticker symbol

company_namestring nullable

Company name

buzz_scorenumber nullable required

Buzz score from tweet activity. Components: mentions (20), sentiment (20), quality (10), author diversity (14) and trend (-10 to +20). Asymptotic scaling caps at 100.

trend'rising' | 'falling' | 'stable' required

Activity momentum over the current 3 UTC days vs previous 3 UTC days, not price movement.

mentionsinteger required

Number of tweets mentioning the ticker

sentiment_scorenumber nullable

Average sentiment score from tweet analysis (-1 to +1)

bullish_pctinteger nullable

Percentage of bullish tweet mentions

bearish_pctinteger nullable

Percentage of bearish tweet mentions

total_upvotesinteger nullable

Total likes across all tweet mentions

unique_tweetsinteger nullable

Number of unique tweets mentioning this ticker (distinct tweet_id)

trend_historynumber[]

Daily buzz scores (oldest→newest). Length follows the resolved period, with a minimum of 7 values. For live windows, the final value is the current live buzz_score; closed historical windows end at to.

Example response

[
  {
    "ticker": "TSLA",
    "company_name": "Tesla, Inc.",
    "buzz_score": 72.5,
    "trend": "rising",
    "mentions": 156,
    "sentiment_score": 0.35,
    "bullish_pct": 45,
    "bearish_pct": 12,
    "total_upvotes": 2847,
    "unique_tweets": 42,
    "trend_history": [
      45.2,
      48.1,
      52.3,
      55,
      58.2,
      61.5,
      64.8
    ]
  }
]

Changes