Topics

GET/retail/intent/topics

Track non-ticker themes moving through retail conversations.

Query Parameters

tickerstringoptional

Ticker symbol filter.

topicstringoptional

Topic text filter.

sentimentenumoptional

Allowed values: bullish, bearish, mixed, neutral, unknown

Optional sentiment filter.

daysintegeroptional

Allowed values: 1, 3, 7, 14, 30, 90, 365

Default: 7

Lookback window in days.

limitintegeroptional

Default: 20

Maximum number of rows to return.

Was this page helpful?

GET/retail/intent/topics

curl "https://api.rallies.ai/v1/retail/intent/topics?topic=rate%20cuts&days=7&limit=20" \
  -H "X-Rallies-API-Key: $RALLIES_API_KEY"

RESPONSE

JSON

{
  "topics": [
    {
      "rank": 1,
      "label": "Rate Cuts",
      "conversation_share_pct": 18.44,
      "sentiment": "mixed",
      "sentiment_breakdown_pct": {
        "bullish": 25,
        "bearish": 20,
        "mixed": 45,
        "neutral": 10
      },
      "related_tickers": [
        {
          "ticker": "TLT",
          "conversation_share_pct": 34.62
        },
        {
          "ticker": "SPY",
          "conversation_share_pct": 26.92
        }
      ],
      "related_themes": [
        {
          "label": "Macro Setup",
          "conversation_share_pct": 42.31
        },
        {
          "label": "Portfolio Risk",
          "conversation_share_pct": 19.23
        }
      ]
    }
  ]
}