Finvera

Product

Docs

Features

News

Explore Docs

API Products

Stock News Headlines

Overview

Copy

The Finvera Stock News Headlines API provides realtime coverage of US stock news and the objective reason behind a stocks movement beyond it's normal intraday range.

What you get

Copy

Consensus Stats: mean, median, high, low, standard deviation, coverage count.

Periods: quarterly (FQ1–FQ4) and annual (FY), rolling and fiscal-calendar views.
Point-in-Time (PIT): retrieve the consensus as it existed on a historical date (survivorship-bias safe).
Latest Snapshots: fast access to the most recent consensus.
Revisions History: day-by-day changes in consensus with as_of timestamps.
Adjustments: GAAP / Non-GAAP EPS flags, currency and split adjustments.
Identifiers: ticker, CIK, FIGI/ISIN (when available).

Samples

Copy

Healthcare Advances

July 28, 2025

Sports Recap Sunday

July 28, 2025

Tech Giants Review

July 28, 2025

Healthcare Advances

July 28, 2025

Sports Recap Sunday

July 28, 2025

Tech Giants Review

July 28, 2025

Use Cases

Copy

Pre-earnings screens (rising/declining revision momentum)

Factor backtests (estimate dispersion, surprise set-ups)
Dashboards showing estimate trends vs. price
Risk checks on low-coverage names or high-dispersion periods

Endpoint

Copy

curl --request GET \
  --url https://api.finvera.news/news/api/v1/news

Copy

curl --request GET \
  --url https://api.finvera.news/news/api/v1/news

Schema

Copy

Note: Fields omitted with ... for brevity.

Copy

{
  "data": [
    {
      "catalyst": "Oncolytics Biotech shares are trading higher after the company appointed Jared Kelly as CEO and announced promising clinical data for pelareorep in cancer treatments.",
      "catalyst_created": true,
      "created_at": "2025-06-11T22:50:22.325207Z",
      "headline": "Oncolytics Biotech Stock Rises Amidst New Leadership and Promising Clinical Data",
      "id": 3908,
      "logo_exists": true,
      "logo_thumbnail_url": "https://d31b1il8wjbsxw.cloudfront.net/svg_16_9_thumbnail_v2/BBG001SDGSF3.svg",
      "news_id": "514a640a-d427-4fb2-baa4-8b947f8edf02",
      "on_all_tickers": true,
      "on_entities": true,
      "securities": [
        {
          "figi": "BBG000DVS826",
          "name": "Oncolytics Biotech, Inc. Common Shares",
          "MIC": "",
          "exchcode": "XNAS",
          "ticker": "ONCY",
          "compositefigi": "BBG000DVS826",
          "securitytype": "CS",
          "marketsector": "stocks",
          "shareclassfigi": "BBG001SDGSF3"
        },
        {
          "figi": "BBG000DVS826",
          "name": "ONCOLYTICS BIOTECH INC",
          "MIC": "",
          "exchcode": "US",
          "ticker": "ONCY",
          "compositefigi": "BBG000DVS826",
          "securitytype": "Common Stock",
          "marketsector": "Equity",
          "shareclassfigi": "BBG001SDGSF3"
        }
      ],
      "share_class_figi": "BBG001SDGSF3",
      "ticker": "ONCY",
      "type": "gainers",
      "updated_at": "2025-06-11T22:50:22.325215Z"
    }
  ],
  "message": "news fetched successfully"
}

Copy

{
  "data": [
    {
      "catalyst": "Oncolytics Biotech shares are trading higher after the company appointed Jared Kelly as CEO and announced promising clinical data for pelareorep in cancer treatments.",
      "catalyst_created": true,
      "created_at": "2025-06-11T22:50:22.325207Z",
      "headline": "Oncolytics Biotech Stock Rises Amidst New Leadership and Promising Clinical Data",
      "id": 3908,
      "logo_exists": true,
      "logo_thumbnail_url": "https://d31b1il8wjbsxw.cloudfront.net/svg_16_9_thumbnail_v2/BBG001SDGSF3.svg",
      "news_id": "514a640a-d427-4fb2-baa4-8b947f8edf02",
      "on_all_tickers": true,
      "on_entities": true,
      "securities": [
        {
          "figi": "BBG000DVS826",
          "name": "Oncolytics Biotech, Inc. Common Shares",
          "MIC": "",
          "exchcode": "XNAS",
          "ticker": "ONCY",
          "compositefigi": "BBG000DVS826",
          "securitytype": "CS",
          "marketsector": "stocks",
          "shareclassfigi": "BBG001SDGSF3"
        },
        {
          "figi": "BBG000DVS826",
          "name": "ONCOLYTICS BIOTECH INC",
          "MIC": "",
          "exchcode": "US",
          "ticker": "ONCY",
          "compositefigi": "BBG000DVS826",
          "securitytype": "Common Stock",
          "marketsector": "Equity",
          "shareclassfigi": "BBG001SDGSF3"
        }
      ],
      "share_class_figi": "BBG001SDGSF3",
      "ticker": "ONCY",
      "type": "gainers",
      "updated_at": "2025-06-11T22:50:22.325215Z"
    }
  ],
  "message": "news fetched successfully"
}

Design Notes

Copy

Low Latency: sub-200ms targets via indexed time-series storage.

Developer-First JSON: consistent keys across measures and periods.
Backtest-Ready: PIT queries to avoid look-ahead bias; stable identifiers.
Quality Controls: outlier trimming options (trim_pct, optional z-score caps).

Overview

What you get

Example Use Cases

Endpoint Examples

Schema

Design Notes