v2

latestOpenAPI 3.1.0Proprietary2026-08-05143259.2 KB

news

Trending news (last 48h)

Top stories from the trailing 48h: relevance_score >= 8, ranked by relevance score decayed by article age, so a fresh story outranks an equally-scored stale one. At most two stories per ticker. Fixed size of 10, no pagination. Coverage of one story, syndicated reprints and independent write-ups of the same event alike, is collapsed to a single representative, and each item carries the story_id, sources_count and sources fields for the story it represents. Most stories are carried by a single outlet, so sources_count is usually 1; see its field description.

get/api/news/trending/

Response

List of enriched articles.

story_idstring nullable

Populated whenever the response is story-collapsed — ?collapse=story on /api/news/, and always on /api/news/trending/. The uid of this story's representative article — equal to this item's own original.uid, and resolvable via /api/news/{uid}/. null in the default (uncollapsed) feed.

sources_countinteger nullable

Story-collapsed responses only. Number of distinct outlets (source domains) covering this story; the same outlet running it more than once counts once. Most stories are carried by a single outlet, so this is usually 1. Treat a value above 1 as the signal, not the number itself. May exceed the length of sources, which is capped at 10. null in the default feed.

sourcesstring[] nullable

Story-collapsed responses only. Distinct source domains covering this story, in first-appearance order, capped at 10. null in the default feed.

Example response

[
  {
    "enrichment": {
      "tickers": [
        "NVDA"
      ],
      "news_context_enhancement": {
        "key_entities": [
          {
            "type": "company"
          }
        ]
      }
    },
    "story_id": "788e477c66f3849b",
    "sources_count": 3,
    "sources": [
      "reuters.com",
      "apnews.com",
      "bloomberg.com"
    ],
    "insider": {
      "transaction_code": "S",
      "shares": "25000",
      "avg_price_usd": "187.32",
      "total_value_usd": "4683000",
      "insider_name": "STEVENS MARK A",
      "insider_title": "Director",
      "transaction_date": "2026-07-09",
      "filed_at": "2026-07-11T20:31:04Z"
    }
  }
]