---
title: "AI explanation"
method: GET
path: "/x/stocks/v1/stock/{ticker}/explain"
tags: ["X/Twitter Stocks"]
---

# AI explanation

`GET /x/stocks/v1/stock/{ticker}/explain`

## Request

- Base URL: `https://api.adanos.com`
- URL: `https://api.adanos.com/x/stocks/v1/stock/{ticker}/explain`
- Auth: API key in header `X-API-Key`

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`: the language model that wrote the explanation

## Path parameters

- `ticker` string, required: Stock ticker symbol (e.g., TSLA, aapl, BRK.A, $GME)

## Response `200`

Successful Response

- StockExplanationResponse: AI-generated trend explanation for a stock.
  - `ticker` string, required: Stock ticker symbol
  - `company_name` string, nullable: Company name
  - `explanation` string, required: AI-generated explanation of why this stock is trending
  - `cached` boolean, required: Whether the explanation was served from cache
  - `generated_at` string, required: Timezone-aware UTC ISO timestamp when explanation was generated
  - `model` string, nullable: LLM model used for generation

## Other responses

- `401`: Authentication failed
- `403`: Historical data limit exceeded
- `404`: Resource not found or no data available for the requested asset/window
- `422`: Invalid period or query parameters
- `429`: Rate limit exceeded
- `503`: Explanation or database service unavailable
- `504`: Analytics request deadline exceeded

---

[API](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api.md) - [All operations](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/revisions/7e8bdb1e7e75?raw)