v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Equities Indices

Per-ticker news-flow sentiment + attention

Primary news-flow sentiment + attention for a ticker, entirely from Sugra-owned sources: GDELT tone + volume timelines and the 43-feed first-party RSS ingest, entity-linked via the SEC registrant name + former names (so coverage filed under an old name is still matched). 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 10min (GDELT's update cadence). Not investment advice.

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

Path parameters

symbolstring required

Company ticker symbol.

Example:AAPL

Company ticker symbol.

Query parameters

timespanstring

GDELT lookback window.

Example:1month

GDELT lookback window.

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",
    "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"
    ]
  }
}