ADadanos
News Stocks

AI explanation

Changed on

Returns an AI-generated explanation for why a stock is trending in the news dataset, anchored to article evidence.

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
get/news/stocks/v1/stock/{ticker}/explain

Request

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

Path parameters

tickerstring required

News company key: 1-32 ASCII letters/digits with an optional documented venue suffix, case-insensitive. Examples: BRK, EADSY, ABX.DE. Share classes (BRK.A, BRK.B, BRK-B), hyphens, ampersands, cashtags and unknown suffixes return 422. A documented suffix resolves only if assigned to that issuer; other well-formed keys return 404 on individual endpoints. One issuer is one time series; ETFs stay separate issuers. Venue suffixes: .AE, .AS, .AT, .AX, .BA, .BD, .BK, .BO, .BR, .CA, .CL, .CN, .CO, .DE, .DU, .F, .HA, .HE, .HK, .HM, .IC, .IR, .IS, .JK, .JO, .KL, .KQ, .KS, .KW, .L, .LS, .MC, .MI, .MU, .MX, .NE, .NS, .NZ, .OL, .PA, .PR, .PS, .QA, .RO, .SA, .SAU, .SG, .SI, .SN, .SS, .ST, .SW, .SZ, .T, .TA, .TO, .TW, .TWO, .V, .VI, .VN, .WA.

Response

Successful Response

tickerstring required

Stock ticker symbol

company_namestring nullable

Company name

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": "deepseek-ai/DeepSeek-V4.1-Flash-1017"
}

Changes

  • 559b660fa744Revision changes
    • warning

      changed the pattern of the path request parameter ticker from ^(?=[A-Za-z0-9]{1,32}$)[A-Za-z0-9]+$(?![\s\S]) to ^(?=[A-Za-z0-9.]{1,32}$)[A-Za-z0-9]+(?:\.(?:[Aa][Ee]|[Aa][Ss]|[Aa][Tt]|[Aa][Xx]|[Bb][Aa]|[Bb][Dd]|[Bb][Kk]|[Bb][Oo]|[Bb][Rr]|[Cc][Aa]|[Cc][Ll]|[Cc][Nn]|[Cc][Oo]|[Dd][Ee]|[Dd][Uu]|[Ff]|[Hh][Aa]|[Hh][Ee]|[Hh][Kk]|[Hh][Mm]|[Ii][Cc]|[Ii][Rr]|[Ii][Ss]|[Jj][Kk]|[Jj][Oo]|[Kk][Ll]|[Kk][Qq]|[Kk][Ss]|[Kk][Ww]|[Ll]|[Ll][Ss]|[Mm][Cc]|[Mm][Ii]|[Mm][Uu]|[Mm][Xx]|[Nn][Ee]|[Nn][Ss]|[Nn][Zz]|[Oo][Ll]|[Pp][Aa]|[Pp][Rr]|[Pp][Ss]|[Qq][Aa]|[Rr][Oo]|[Ss][Aa]|[Ss][Aa][Uu]|[Ss][Gg]|[Ss][Ii]|[Ss][Nn]|[Ss][Ss]|[Ss][Tt]|[Ss][Ww]|[Ss][Zz]|[Tt]|[Tt][Aa]|[Tt][Oo]|[Tt][Ww]|[Tt][Ww][Oo]|[Vv]|[Vv][Ii]|[Vv][Nn]|[Ww][Aa]))?$(?![\s\S])

  • a8567b417bdaRevision changes
    • warning

      changed the pattern of the path request parameter ticker from ^(?=[A-Za-z0-9.]{1,10}$)[A-Za-z0-9]+(?:\.(?:[Cc][Nn]|[Dd][Ee]|[Nn][Ee]|[Tt][Oo]|[Vv]|[Ww][Aa]))?$(?![\s\S]) to ^(?=[A-Za-z0-9]{1,32}$)[A-Za-z0-9]+$(?![\s\S])