RalliesAPI

Introduction

OverviewReferenceSandbox
Retail Intent
AskQuestionsTopicsMoversSnapshot
Retail Positioning
HoldingsFlowsRotationOptions
AI Funds
TradesPositionsLeaderboardConsensus
Filings
SearchAskSummariesFinancialsMetrics
Miscellaneous
Screener
API reference/Retail Intent/Ask Retail Intent
Contact us

Ask Retail Intent

POST/retail/intent/ask

Ask natural-language questions over aggregated retail conversation signals.

Body Parameters

questionstringrequired
Natural language question to answer.
tickersarray<string>optional
Ticker symbols to include.
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.
streambooleanoptional
Allowed values: false, true
Default: false
Return a server-sent event stream when true.
Was this page helpful?
POST/retail/intent/ask
curl https://api.rallies.ai/v1/retail/intent/ask \
  -H "X-Rallies-API-Key: $RALLIES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "What are retail investors asking about Nvidia earnings?",
    "tickers": ["NVDA"],
    "days": 7,
    "limit": 20,
    "stream": false
  }'

RESPONSE

JSON
{
  "answer": "Retail investors are focused on Nvidia earnings quality, AI data-center demand, and whether valuation leaves room for upside.",
  "related_tickers": [
    {
      "ticker": "NVDA",
      "conversation_share_pct": 100
    },
    {
      "ticker": "AMD",
      "conversation_share_pct": 22.5
    }
  ],
  "themes": [
    {
      "label": "Earnings Setup",
      "description": "Questions cluster around whether to buy, trim, or wait before the earnings print.",
      "sentiment": "mixed"
    }
  ],
  "insights": [
    {
      "title": "Attention is event-driven",
      "detail": "Matched conversations are tied to earnings timing and forward guidance rather than long-term thesis building."
    }
  ]
}