Equities Indices

Per-ticker news-flow sentiment + attention

Changed on

Primary news-flow sentiment + attention for a ticker, entirely from Sugra-owned sources: GDELT tone + volume timelines and the first-party RSS news feeds (list: /api/v1/news/sources), entity-linked via the SEC registrant name + former names (so coverage filed under an old name is still matched). Tone and volume are read from the GDELT files Sugra already stores. The served window is 24 hours. Requested values 3days, 2weeks and 1month stay accepted and come back as timespan 24h with window_capped. This is editorial NEWS-FLOW sentiment, the defensible alternative to scraped social mention-counting. It does not capture retail crowd psychology or pre-news buzz. Cached 10 min. Not investment advice.

get/api/v1/equities/{symbol}/news-sentiment

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/equities/{symbol}/news-sentiment
  • Auth: API key in header x-api-key

Path parameters

symbolstring required

Company ticker symbol.

Example:AAPL

Query parameters

timespanstring

Accepted lookback: 3days, 2weeks, 1month. The measurement is the stored 24 hour file window.

Example:1month

Response

Sentiment (GDELT average document tone) and attention (coverage volume + first-party article count) time series for the company, plus recent first-party headlines.

Example response

{
  "data": {
    "symbol": "AAPL",
    "company_name": "Apple Inc.",
    "match_basis": "entity",
    "timespan": "1month"
  },
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes

  • bb59bcb0e35fRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • d2472ec2cf81Revision changes
    • info

      added the non-success response with the status