v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB

X/Twitter Stocks

AI explanation

Returns an AI-generated explanation for why a stock is trending on X/Twitter, anchored to tweet evidence with other platforms used only as cross-check context.

Includes:

explanation: 1-2 sentence summary of why the stock is trending
cached: whether this was served from cache
generated_at: when the explanation was generated
model: which LLM model generated the explanation

get/x/stocks/v1/stock/{ticker}/explain

Path parameters

tickerstring required

Stock ticker symbol (e.g., TSLA, aapl, BRK.A, $GME)

Response

Successful Response

tickerstring required

Stock ticker symbol

company_namestring nullable

Company name from ticker_reference

explanationstring required

AI-generated explanation of why this stock is trending

cachedboolean required

Whether the explanation was served from cache

generated_atstring required

Timezone-aware UTC ISO timestamp when explanation was generated

modelstring nullable

LLM model used for generation

Example response

{
  "ticker": "GME",
  "company_name": "Gamestop Corporation - Class A",
  "explanation": "GME is trending due to viral GameStop social media activity and large position posts on r/Superstonk.",
  "cached": true,
  "generated_at": "2026-01-13T14:30:00+00:00",
  "model": "meta-llama/Meta-Llama-3.1-8B-Instruct-Turbo"
}